用途:审计和修正“思维链泄漏”文本,即视角来自写作会话而非仓库的段落,包括只引用该会话可见的产物、叙述变更而非陈述状态、或与已离场的评审者争论。核心修法是:若段落承载事实分句,先逐一重述使其独立成立,再删除周围的转写痕迹;若不承载任何事实,则直接删除。编辑前先枚举完整命题,保留行为者、动作、条件、时机、模态、否定保证、例外、归属、副作用、失败模式与后果。
判定测试:对每个可疑段落问,读者在没有会话记录、PR 线程或未提交草稿的情况下,能否解析每个引用并验证每项声明?不能则重述幸存事实、删除其余;能则不是泄漏,但在 README、文档、技能正文等当前状态界面上可解析的变更故事仍属变更叙述,应移入提交、PR 或 Agent Note。
分类:已失效的设计会话引用(decision 7、audit C2、§4.7、T4、W3);栈与 PR 视角(“后续 PR”“本 PR 新增”“上一个提交”);变更叙述与版本戳(“曾经”“不再”“旧 X”、v1);评审编排(“评审中被拒”);面向评审者的辩解;重述与推导转写;含糊与规划残留;写作语言混用。
非泄漏(须保留):解析到 HEAD 的 issue 引用;Agent Note 与事后分析中的合并 PR、issue 引用;抑制理由(lint-disable 原因等);反事实现在时回归钉;“measured”标注的实测边界;运行时新旧状态;笔记变更故事段中的历史阶段名;按设计解析到仓库外的外部引用(如 RFC 章节);项目口吻与体裁形式。
工作流:要求明确范围;不触碰 vendor/、冻结归档笔记、录制夹具与快照。先只读审计,运行召回检测再语义判断。先修所有者:双语对改对应文件,生成或清单列出的界面改源。删除前枚举命题并检查过度修正陷阱。验证时重跑检测、确认引用可解析并运行仓库文档检查。