深入agent-rules-books的_rule-workbench：traceability机制让每条规则压缩都不丢失

深入agent-rules-books的_rule-workbenchtraceability机制让每条规则压缩都不丢失【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-booksagent-rules-books 是一个把 13 本经典编程书蒸馏成 AI coding agent 规则AGENTS.md / skills的开源仓库。它的 _rule-workbench/ 目录为每本书建立了一套完整的 traceability 可溯源机制从full.md完整规则源压缩到mini.md、nano.md的每一步都被逐条记录保留在哪、合并到哪、故意丢弃了什么确保规则压缩不丢失任何可决策内容 。_rule-workbench 是什么每本书的压缩车间仓库的主目录如 clean-code/只存放最终发布物完整规则、mini 版和 nano 版。而 _rule-workbench/ 是背后的工作台每本书一个子目录固定包含 4 个文件文件作用full.md指向主目录规范完整源的符号链接只读不可编辑mini.md按需加载的压缩版日常任务推荐nano.md极小上下文预算下的常驻兜底版traceability.md核心每条保留/删除规则的溯源账本以 _rule-workbench/clean-code/full.md 为例它实际是指向 clean-code/clean-code.md 的软链接——这从机制上保证压缩永远以唯一真理源为基准不会出现两个版本各自漂移。traceability 机制压缩不丢失的三道防线防线一M/N 编号体系 行号引用PROCESS.md 要求mini.md中每条保留规则分配一个M*编号nano.md分配N*编号且每个编号必须引用full.md的章节名和当前行号范围。看 clean-code 的 traceability.md 就能体会到这种粒度M6命令与查询分离、消除隐藏副作用。Source:Function rules(44-62),Smells to detect and eliminate(207-240),Hard rules(290-297)一句话就能回答审查者最关心的问题这条 mini 规则到底是书上哪来的压缩 3 倍、10 倍之后出处依然精确到行。防线二被删内容只有三种合法归宿很多压缩悄悄丢内容是因为删除没有说法。这里的规则是每条被省略或合并的源规则必须记录为三者之一covered by Mx/covered by Nx—— 已被某条压缩规则覆盖intentionally lost——故意丢失并写明理由标注为defaultagent 默认会做时必须附证据不能凭人类觉得显然PROCESS.md 明确禁止用secondary、low-yield这类含糊词打发删除要么指出操作效果存活在哪条规则里要么明说丢了。防线三逐章节强制走查Section Coverage Review每本书收尾前必须把full.md的每一个章节逐一分配到四种结果之一保留在 mini、合并进 M 规则、仅存于 nano、或故意丢失。这一步即使文字没改也强制执行。以 Clean Code 为例297 行 / 220 条完整规则压缩为 47 行 / 29 条 mini、32 行 / 14 条 nano见 README.md 的 Release Matrix。Smells to detect and eliminate那 30 多行的坏味道目录并没有消失而是明确记录为合并进M15、M17、M18等触发规则——丢掉的只是独立措辞决策效果全部有据可查 ✅流程与发布如何守住这套机制traceability 不是单点文件而是被两个流程文档前后夹住的压缩阶段PROCESS.md 定义了 8 类规则分类book-thesis、decision-changing、micro-decision、conflict-resolver、trigger等先分类再压缩还要求区分流程 bug与单书遗漏——可复现的压缩错误必须先改 PROCESS.md 再重跑该书而不是手工微调某本书。发布阶段RELEASE.md 规定mini.md、nano.md复制到主目录前必须验证traceability.md已把保留规则映射回完整源且traceability.md与full.md只留在 workbench不进入公开发布面——公开给用户的永远是干净规则而审计证据完整保留给审查者。这种发布物最小化、审计链完整化的分层是该机制最值得借鉴的设计 新手如何上手验证压缩质量不必读懂每本书跟着三步就能独立审计任意一本书的规则压缩挑一条规则打开 refactoring/refactoring.mini.md 任选一条找到它在 _rule-workbench/refactoring/traceability.md 中对应的M*编号跳回源头按编号后标注的章节名和行号到 refactoring/refactoring.md 确认原始规则确实存在且语义一致反向查漏浏览full.md任一章节到Section coverage review部分确认它有covered by或intentionally lost的明确归宿。三步走完你就拥有了压缩是否可信的第一手证据而不是只能相信 README 里的指标表格。想进一步了解各版本如何用于 Codex、Cursor、Claude Code可参考 docs/USAGE.md。小结符号链接的full.md锁定唯一真理源压缩永不脱离源头M/N 编号 行号引用让每条压缩规则可反向定位三种合法归宿 逐章节走查让删了什么与留了什么同等透明PROCESS 管压缩、RELEASE 管发布traceability 贯穿全流程规则压缩的难点从来不是删短而是删得可证明。agent-rules-books 的 _rule-workbench 用一份账本式的 traceability 机制回答了这个难题——这也是任何想把长文档蒸馏给 AI 使用的团队都能直接复用的工程实践。【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考