上下文分叉纪律
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e1cf10c0/context-fork-discipline。
技能介绍
要解决什么问题
长周期 Agent 项目里,方向被推翻后新旧说法往往并存;同一决策被抄进多份 SOP、清单和发布稿,改一处要追多处。续会话时若 habit 是 broad read 全库,文件越长,有效决策越容易被日常日志和试错噪音淹没——也就是常见的 context rot。探索阶段读大量文件、编译失败多次,脏上下文还会污染主线程。
根因不是「文档写太多」这么简单,而是创立期/演进期的决策分叉没有被隔离;文档膨胀只是症状。业界常见做法(SSOT、ADR Superseded、子 Agent 蒸馏、有界读取)指向同一类治理需求,本 skill 把它们收成可重复的操作纪律。
技能如何工作
四条方法论层纪律,配合「改旧决策/扫残留」时的五步程序:
- SSOT 单一真相源:每个项目只在一处(如
MEMORY.md)写「为什么/决策」;操作类文件只写动作步骤,用「见 §X」引用,不内嵌决策正文。改决策成本收敛到 O(1)。 - ADR 冻结:历史/快照文件顶部标冻结,不重写正文;被取代时只改状态行「✗ 已被 X 取代」。扫残留时按语义区分「正当旧概念」与「已废旧概念」,避免关键词误删。
- 分叉隔离:方向分叉后,旧方向整组冻结为历史分支,不混入活文档、不就地调和;重物理归档进
_archive_需用户拍板。 - 噪音外推 + 边界读取:大批量扫描用 Agent/Subagent,主线程只收结论;开局只读 SSOT + 本次要改的一个文件,用 Grep/Task 定位,不全库 broad read。
适用边界与注意点
本 skill 侧重上下文与分叉治理,与用户侧的 API 铁律、先搜同款、项目隔离等互补,不能替代安全与对齐层纪律。启用后仍要避免:多文件 patch 让两条分叉同时活着、重写历史正文抹旧说法、主线程承担探索脏活。它与跨项目协作铁律同性质——让长项目「改得动、读得起」,而不是跳过既有铁律。
使用场景
- 产品方向推翻后,要在不重写历史正文的前提下,把旧方案标为被取代并收敛到 MEMORY.md
- 改一项架构决策时,需要从多个 SOP 和清单里摘掉内嵌的「为什么」,改为引用 SSOT 一处
- 接手续聊时,只想读 MEMORY.md 和当前要改的文件,用 Grep 定位残留而非全库 broad read
- 全库扫「确认稿」等关键词前,先列正当旧概念与已废旧概念清单,避免误删业务术语
适合人员
- 维护多份操作文档与项目 memory 的 Agent 技能作者,希望改决策只动一处
- 长会话 Codex/Claude Code 用户,续聊常被全库阅读量与 context rot 拖慢
- 用子 Agent 做审计或探索、主线程只收结论的工程师,需要明确噪音外推纪律
- 在 MADR/ADR 体系里管理演进决策、又要保留历史不可变快照的技术写作者