为什么 agent 不听你的 CLAUDE.md（五个修法）

你写了规则，它也读了，然后照做你禁止的那件事。

没有东西坏掉。context 档失效有五个很无聊的原因，每一个都只要改两行。

1. 规则埋在故事里

agent 会遵守「看起来像规则」的句子。「我们多年来发现，发布前先问一下通常比较好」是一个带寓意故事，它要和另外两百句竞争。

修法： 一行一条祈使句，放在最上层。

坏：我们一般希望面向客户的东西先被审一遍。
好：没有老板点头，绝不发文、不寄客户信、不改价格。

2. 两条规则打架，没人赢

前面写「回答要短」，后面写「编辑前详细解释每个改动」。agent 会选最后读到的那条，或把两条平均成没用的东西。

修法： 明写优先级。

两条规则冲突时：安全 > 赚钱 > 速度。并说出你遵守了哪一条。

3. 文件描述的是一个已经不存在的 repo

它写着 scripts/deploy.sh，那个脚本三月就删了；它说价格是 $49。agent 试一下、静默失败、然后开始猜。

修法： 文件里每个路径和数字，都要能用一条命令验证。

使用本文件里的任何命令前，先确认它存在：ls 或 --help。不存在就停下来报告。

4. 规则没有触发点

「小心金钥」是一种心情。agent 在真正需要它的那一刻，无法对心情采取行动。

修法： 把规则绑到具体时刻。

坏：小心密钥。
好：任何会打印环境变量、密钥或 .env 的命令，执行前先停下来问。

5. 没有后果

没有后续的规则就是建议。agent 和人一样，没有反馈就会漂。

修法： 定义报告，不是惩罚。

如果你无法遵守某条规则，停下来写：哪条规则、为什么、你需要什么。不要继续，也不要绕过去。

五行核心

如果文件很长，确保这五条在最上面、不可能被忽略：

1. 完成＝文件＋检查＋下一步。绝不是一段话。
2. 没有老板点头，不碰密钥、部署、价格、退款、客户信。
3. 规则冲突时：安全 > 赚钱 > 速度，并说出遵守了哪条。
4. 最多问一个问题，而且只在答案会改变你要做什么时问。
5. 每步之后写状态：done / open / next。

文件其余部分都是细节。细节只有在核心被遵守时才有用。

十分钟测一次

让 agent 先用它自己的话说一遍这五条规则。
给它一个会诱发违规的任务（一个「顺手」的改价）。
看它是停下来问，还是直接做。
如果直接做，是规则不够具体，不是模型不行。

context 档不是文件说明，它是你手上最接近管理的东西。那就按管理来写。

常见问题

CLAUDE.md 该多长？

规则一屏，其余按需载入。长文件每个任务都在付费，还会稀释每一条规则。

AGENTS.md 也一样吗？

一样。两边保持同样的五条核心规则，避免某个工具拿到弱化版。

多少钱？

创始价每月 $9.99。详见价格页。

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {"@type": "Question", "name": "CLAUDE.md 该多长？", "acceptedAnswer": {"@type": "Answer", "text": "规则一屏，其余按需载入。长文件每个任务都在付费，还会稀释每一条规则。"}},
    {"@type": "Question", "name": "AGENTS.md 也一样吗？", "acceptedAnswer": {"@type": "Answer", "text": "一样。两边保持同样的五条核心规则，避免某个工具拿到弱化版。"}},
    {"@type": "Question", "name": "多少钱？", "acceptedAnswer": {"@type": "Answer", "text": "创始价每月 9.99 美元。详情：https://xynex.sekai.center/pricing"}}
  ]
}