915 字
约 3 分钟
12
S24-B03 · 提示词、规则与配置:把要求"固化"下来

适用读者:每次都要重复交代"用我们的规范"的人。
前置:S24-B01、S19-B02(提示词结构)。
口径:各工具的文件名/字段不同,机制一致:规则文件 + 钩子 + 配置。
覆盖旧文:676(198) 687(287) 675(205) 681(195) + 提示词类 = 1,339 点。
覆盖扩展:E-S24-003(规则与钩子的"卡点/扳机")。
上一篇:S24-B02 · 跑通第一个任务:安装、CLI/IDE/桌面/云端
下一篇:S24-J01 · 工具链。


1. 一句话结论

规则文件解决"每次重复交代",钩子解决"必须在某一步执行检查"。前者是约束,后者是强制执行点(卡点与扳机)。

机制 作用 类比
规则文件(CLAUDE.md 类) 常驻约束(风格/命令/禁区) 团队规范文档
钩子(Hooks) 在特定时机强制运行(提交前跑 lint) Git hook / CI 门禁
配置(config.toml 类) 模型/权限/工具开关 应用配置

2. 规则文件该写什么(E-S24-003)

该写 不该写
构建/测试命令(怎么跑) 大段业务背景
代码风格与命名 可从代码看出的结构
禁区(别动 vendor/、别改 pom.xml) 一次性的任务说明
提交信息格式 常识性建议

判据:"这条要求下次还会用到吗?" 会 → 写进规则;一次性 → 会话里说。

"为什么禁区比建议更重要":模型不会自动知道"这个目录不能碰"——明确的禁止项能避免大部分越界改动。


3. 钩子:把检查变成"强制"

时机 典型钩子
改文件后 自动格式化
提交前 lint + 单测
工具调用前 权限校验/审计

"规则 vs 钩子的区别":

规则 钩子
执行方式 模型"尽量遵守" 代码强制运行
可靠性 中 高
适用 约定、风格 必须执行的检查

判据:"这条不执行会出事吗?" 会 → 钩子(不能只靠规则)。


4. 配置文件的三个关键项

项 影响
模型选择 成本与能力
权限/审批模式 能不能自动执行命令(A01)
MCP/工具开关 能接哪些外部能力(J01)

"配置为什么要进版本库":团队要一致——但密钥绝不能提交(S20-A02)。


5. 五个误区

误区 真相
"规则写得越多越好" 太长会被忽略
"规则能替代钩子" 规则是"尽量",钩子是"强制"
"配置只写本地" 团队应统一
"规则里可以写密钥" 绝不能
"钩子会拖慢流程" 但它挡的是真事故

6. 自检

  1. 规则文件与钩子的分工?
  2. 规则该写什么、不该写什么?
  3. 为什么"禁区"比"建议"重要?
  4. 三种钩子时机?
  5. 配置文件该进版本库吗?密钥呢?

7. 下一篇

S24-J01 · 工具链:MCP、Git/PR、外部集成与 Computer Use

规则讲完,进阶层开始:它怎么"看见"和"动手"。


本篇属于系列《S24 · AI 编程工具》。旧文来源:A-676/687/675/681 + 提示词类卡;扩展点 E-S24-003。

S24-B03 · 提示词、规则与配置:把要求"固化"下来
https://www.clxhxhhr.top/posts/5566/
作者
clxstart
发布于
2024-12-31
许可协议
CC BY-NC-SA 4.0
评论
0 条
还没有评论,先写一条吧。