编写有效内容

从模糊指令到精准控制的系统方法论,让 CLAUDE.md 的每一行都产生可预期的效果

应用10 分钟

一、常见方案模式

指令编写三原则

CLAUDE.md 中的每条指令都需要满足三个条件才能稳定生效:

  • 具体——指令包含可检验的客观标准。"写好代码"无法检验;"变量名使用 camelCase,缩进用 2 空格"可以逐项核对
  • 可执行——Claude Code 读完后能直接行动,不需要猜测你的意思。"注意安全"不可执行;"不修改 .env 文件,不执行 rm -rf"可直接遵循
  • 可验证——你或 Claude Code 自己能判断"这条指令被遵守了吗"。如果一条指令的遵守与否取决于主观判断,它就不够好

三个条件缺任何一个,指令的效果都会随机波动。

好指令 vs 坏指令模式库

以下对比覆盖六类常见场景,展示从模糊到精准的改写思路:

代码风格类

坏指令好指令改写要点
写好的代码所有函数必须有 JSDoc 注释,变量名使用 camelCase分解为可检查的具体条目
注意代码风格缩进使用 2 空格,每行不超过 100 字符,字符串用单引号量化每一个维度

安全边界类

坏指令好指令改写要点
注意安全不修改 .env 文件;不执行 rm -rf;敏感操作先确认列出具体禁止项
小心处理文件修改文件前列出修改清单并等待确认转化为操作步骤

协作方式类

坏指令好指令改写要点
尽量简洁回复控制在 200 字以内,使用要点列表量化"简洁"的标准
如果有多种实现方式让我选多种方式时列出各方式的优缺点对比表,等待选择指定输出格式

测试要求类

坏指令好指令改写要点
做好测试每个新函数必须有单元测试,测试文件放 tests/ 目录明确标准和位置
确保质量修改代码后运行 pnpm test,测试失败时不提交指定执行动作
付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 长期访问,持续更新
CLAUDE.md 完全指南4/7