AI 智能体说「完成了」，但什么都没变

「完成了。」

你打开文件夹。没有文件、没有测试、没有提交。它没有在骗你——它回答的是另一个问题。你要的是工作，它报告的是自己的信心。

这是 agent 工作里最贵的失败模式，因为它看起来像进度。你接着做下一件事，三天后才发现什么都没上线。

原因：没有「完成」的定义

人类团队不为「完成」吵架，因为定义写在流程里：PR 合并、测试通过、页面上线。agent 没有这个定义，就只能用唯一的信号：自己的回答听起来完不完整。

改掉定义，行为就会变，不需要换模型。

三个条件

三件事同时存在，才算完成：

1. 一个文件。 不是文件的计划，是那个文件，在一个你能打开的路径。
2. 一个检查。 一个测试、一段脚本、一个 curl，或两张宽度的截图。如果工作是假的，它会失败。
3. 一个下一步。 一行：现在做什么，或者卡在谁身上。

少任何一个，答案就是「没完成」，而且要说出缺哪一个。

强制它的三行格式

每一步结束都留三行：

done: <动了哪些文件 + 改了什么>
open: <还没完成什么>
next: <一个动作，或卡点>

三条规则让它成立：

• 写路径，不写形容词。「public/pricing.html，hero 与两个购买键」胜过「优化了价格页」。
• 还有没做完的事，open: 就不能空。 功能做一半却写空的 open:，就是假报告。
• next: 要别人也能执行。 只有作者看得懂，就不是下一步。

把格式写进 CLAUDE.md（或 AGENTS.md），每个 session 自动继承；brief 里再要求一次。之后你读状态笔记，不读聊天记录。

「我看过了」不是检查

agent 可以看着两千行 CSV 说「看起来没问题」。那不是检查，是印象。检查是一条有退出码的命令，或一份你能看的 diff。

能抓住大多数假完成的小检查：

• node tools/selftest.mjs——自己的测试文件，失败就非零退出
• grep -c "<预期字串>" file——证明改动真的进去了
• curl -s -o /dev/null -w '%{http_code}' URL——证明页面活着
• 390 px 与 1280 px 的截图——证明版没塌
• git diff --stat——证明哪些文件动了

这些都不需要信任。这就是重点。

最贵的那个版本

最贵的不是「说完成但什么都没有」，而是：它说完成、你信了，然后你发布了——坏链接的贴文、两个不同价格的页面、数字写错的客户信。

所以状态格式要与放行关卡并排：关卡回答「这件事能不能出去」，状态回答「到底发生了什么」。两个都要。

五分钟改造

1. 把三行格式写进 CLAUDE.md。
2. 加一句：「完成＝文件＋检查＋下一步。」
3. 先在你的下一个任务里要求它，不要一次全改。
4. 任务结束后只读状态笔记。如果写得含糊，是 brief 含糊。

做一次，之后每个 session 都继承。这就是「五个 agent」和「五个聊天视窗」的差别。

常见问题

这套东西对所有 agent 都适用吗？

适用。格式是纯 Markdown；Claude Code 读 CLAUDE.md，Codex 与其他工具读 AGENTS.md。

如果它还是说完成但没文件？

在 brief 里要求三行，退回任何 done: 里没有路径的答案。通常两轮就够。

多少钱？

创始价每月 $9.99，一键取消。详见价格页。

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {"@type": "Question", "name": "这套东西对所有 agent 都适用吗？", "acceptedAnswer": {"@type": "Answer", "text": "适用。格式是纯 Markdown；Claude Code 读 CLAUDE.md，Codex 与其他工具读 AGENTS.md。"}},
    {"@type": "Question", "name": "如果它还是说完成但没文件？", "acceptedAnswer": {"@type": "Answer", "text": "在 brief 里要求三行，退回任何 done 里没有路径的答案。通常两轮就够。"}},
    {"@type": "Question", "name": "多少钱？", "acceptedAnswer": {"@type": "Answer", "text": "创始价每月 9.99 美元，一键取消。详情：https://xynex.sekai.center/pricing"}}
  ]
}

全部指南 · Read in English: Why Your AI Agent Says "Done" and Nothing Changed