AI文档编号/Cursor三份文档三个号?登记册才是发号权

说个我自己踩的坑：用 Cursor 或 Claude Code 指挥 AI 写东西，一个需求下来，通常会产出需求说明、任务说明、接口契约三份文档。

我让 AI 给每份都加上编号，文件名看着挺规范。等要对齐、要变更、要归档——傻眼了：三个编号各是各的，不知道该信谁。

本来以为是个格式设计题。八轮演化下来才发现，真难题在「纪律」，不在格式。

AI 先设计了中文主题串、全局递增编号、任务类型前缀——格式打磨得挺细。真正关键的那一问才来：三份文档的编号要保持一致，是不是建个编号字典？

登记册做唯一发号源

AI 列了三种方案：维护一份登记册（Markdown 表格，唯一发号源）；每次扫描已有文件名自动编号；或者让文档互相引用来对齐编号。

扫描文件名有竞态——两次扫描之间可能插入新文件，号就乱了。文档互引有断链——一份没写引用就断了。登记册虽然要人工遵守「先读再写」，但只有一个数据源，这个特性太值钱了。

定下来：登记册为主、扫描校验为辅。一行一条任务链，记编号、主题、三份文档路径。只有新建任务链时全局计数 +1；后面生成任务文档、契约文档禁止重新发号，必须从登记册读同一个编号。

作废只打标记，不回收序号。编号和主题串里都含短横线，解析时不能简单按 `-` 切分，得用正则——这种「看起来简单、谁写谁错」的细节不写进规则，后人还会反复踩。

落地时做了批量重命名，更新了所有交叉引用，全文搜一遍确认没有残留。不上数据库，一份文本登记册 + 规则约束 AI「先读后写」就够用。

我就记两条：纪律比格式难——先定「谁和谁必须共号」，再谈文件名长什么样；存量迁移要一起做——新文件新格式、老文件老格式，规则等于只对一半生效。

格式只是让编号看起来一致；登记册的「唯一发号权」，才是让编号真的一致。与其花时间设计完美格式，不如先把发号权收紧到一处——剩下的慢慢调，都不会出大乱子。

可抄提示语