AI 标「已完成」，清单却是空的——让 .ai/ 规矩自检一次（附提示语）

给 AI 配规则，很多人是从一个CLAUDE.md开始的。配着配着会长成仓库里一整套.ai/目录，和代码一起进版本控制——Context Engineering（上下文工程）里很常见的一套做法。

东西一多，很自然就想：这套规矩，能不能让 AI 自己维护？

前几天，手头一个真实项目就碰上了这事。我让 AI别改业务，先对规矩本身做次体检。

当场翻出四桩事，每一桩都是AI 说一套、实际对不上，不是代码 bug：

• AI 改完订单代码，却更新了订阅域的说明文档
• AI 把任务标成 done，验收清单一项没勾
• AI 说检查过了，对照的却是旧记录
• AI 说可以收工，两个须知文件说法不一

下面这张图，四桩「AI 说 vs 实际」长什么样——不是代码 bug：

这也是我最拿不准的地方：AI 能忠实执行规矩，却几乎不会怀疑规矩本身已经过期。

前置：你得先有一套.ai/操作间

rules/tasks/domains/flows/prompts等分工，和代码一起 commit。从哪来、装什么、为什么是目录→ 见前一篇《为什么你的仓库需要一个 .ai/ 目录》。

下面只聊软肋：规矩立下之后，它自己也会过期。

四桩对不上，我是这么发现的

• 文档归错模块。域多了，规则却停在原地。
• 状态和清单各说各话。done把「写完」和「验过」压成一个勾。
• 自检对照过期记录。给 AI 的协作说明也会过期。
• 归档条件分了岔。演化中悄悄长出两套说法。

和主流说法对齐

• Context Engineering：本篇主要在这一层；.ai/理念对齐 AGENTS.md。
• 元治理：审「给 AI 的规矩本身」——不是查业务 bug。
• Harness Engineering：下篇讲分阶段门禁；本篇只到「得定期自检」。
• 四层地图见系列 #3《从碎片到工程化》。

怎么破：定期让它自检，但判断你来兜

能交给 AI 的，和必须你来定的，边界可以收成一张图：

你可以直接拿去用的提示语

我给 AI 协作配了一套操作间：.ai/ 下分 tasks / prompts / rules / domains / flows， 外加一份总规则文件。AI 平时按这套规矩干活。 （把这套目录换成你项目里真实的规则 / 目录约定。） 我怀疑这套规矩过期了、跟业务对不上。别干活，先对它做一次规矩自检（审规矩本身，不是查业务 bug），重点查： 1. 文档归错模块 2. 状态和验收清单对不上 3. 冲突/依赖指向过期 4. 归档/命名规则分裂 输出：逐条列出问题点（带文件 / 位置）、为什么对不上、修法是补规则还是修产物。 拿不准的标「需人工确认」，别替我粉饰太平。

那到底靠不靠谱？

AI 当手，你当判断。跑体检、出初稿它能干；哪条真过期、改不改，得你来拍板。

.ai/里该写什么 → 见《CLAUDE.md 到底该写什么》；为什么需要.ai/目录 → 见《为什么你的仓库需要一个 .ai/ 目录》。

你的.ai/规矩，最近一次自检是什么时候？评论区聊聊。