5 条 CLAUDE.md 规则，让我的 AI 停止提问并开始行动
Source: Dev.to
经过数月的自主运行 Claude Code，我了解到大多数中断并不是 AI 的错——而是 CLAUDE.md 的错。以下是五条规则，消除了我大多数“我应该做 X 吗？”的问题。
1. 不可逆规则（而非不确定性规则）
大多数 CLAUDE.mds 的说法
“不确定时请求澄清。”
实际有效的做法
“仅在以下情况下请求：不可逆操作、外部凭证、外部可见性（发布、发送电子邮件）、超出订阅的费用。”
差异显著。不确定性是常态——每个决策都有未知因素。不可逆性则很少——大多数代码更改都可以通过 git reset 恢复。从“不确定时请求”转为“仅在不可逆时请求”，问题数量下降约 80 %。
2. 常见分支的明确决策框架
大多数 CLAUDE.mds 的说法
“使用你的判断。”
实际有效的做法
| 情况 | 操作 |
|------------------------------|----------------------------------------|
| 技术方案不明确 | 选择常规方案 |
| 两个有效实现 | 选择更简单的那个 |
| 尝试 3 次后出现错误 | 在 `blocked.md` 中记录，切换任务 |
| 要求模糊 | 采用最合理的解释，并记录假设 |AI 已经具备良好的判断力。此表格并不是在教它思考——它消除了“我该询问还是该决定？”的元问题。通过明确声明“方案不明确 → 采用常规方案”，该决策已预先确定。
3. pending_for_human.md 模式
大多数工作流的阻碍
需要浏览器身份验证或我没有的凭证的步骤。没有明确的协议，AI 要么在此循环，要么悄悄跳过。
有效的做法
“如果被阻止：在
pending_for_human.md中记录阻塞原因，切换到下一个可用任务。”
我使用的格式：
2026-02-28: 需要 Smithery API 密钥
阻塞原因: Smithery MCP 注册表需要身份验证
人工步骤:
- 前往 https://smithery.ai/account/api-keys
- 创建 API 密钥，添加到
~/.credentials
其他全部完成:smithery.yaml已添加到仓库，包已发布到 npm
The key is the last line: “everything else done.” The human opens this file in the morning and sees exactly one click they need to do.4. Explicit syntax check commands
What most CLAUDE.mds say
“Make sure the code works.”
What actually works
“After every edit:
• Python →python -m py_compile <file>
• TypeScript →tsc --noEmit
Do not move to the next file before fixing errors in the current one.”
“不要在修复当前文件的错误之前就切换到下一个文件。” 这部分很关键。如果没有它，AI 会写多个文件，运行构建，发现分散的错误，然后必须来回切换上下文。有了它，每个文件在下一个开始前都是干净的。这也是你使用 git add -p 而不是 git add . 的原因。
5. 上下文压缩协议
什么会导致自主会话中断
在任务进行中耗尽上下文窗口，必须重新开始。
有效的做法
“当上下文变大时：将当前状态写入
tasks/mission.md。包括已完成的内容、接下来要做的、受阻的事项以及任何未解的问题。下一次会话应能够直接从tasks/mission.md继续，而无需阅读完整的历史记录。”
mission.md 应该像向了解项目但未参与现场的人解释一样撰写。不是文字记录，也不是摘要——而是简报。这样就形成了自然的“检查点”，使上下文压缩安全可靠。
这些共同点
所有五条规则的作用相同：将模糊的期望转化为具体的协议。 “使用判断”会强制进行一次元决策；“选择更简单的那个”则消除它。每一次元决策都会消耗上下文窗口并导致中断。消除元决策正是让自主运行真正起效的关键。
我在生产环境中使用的钩子和模板是开源的：claude-code-hooks — 16 个钩子 + 6 个模板，累计 700 多小时的自主运行经验。
📖 Claude Code Production Guide (¥800) — 来自 700 多小时自主运行的经验教训。
你的 Claude Code 配置真的安全么？ 运行 npx cc-health-check — 免费的 20 项诊断。得分低于 80？Claude Code Ops Kit 一键修复所有问题。
你的 CLAUDE.md 中还有哪些内容是你希望早些加入的？