文档治理总路由

定位

把优秀 Agent 的一次性工作，沉淀为项目可继承、可验证、可持续演进的集体能力。

本插件不是让 Agent 多写文档，而是治理长期 AI 协作中的项目知识、关键决策与验证证据：让后续 Agent 能恢复上下文、沿用已确认约束、复核结果，并把新的有效做法继续沉淀回项目。

先判断意图，再读取并执行对应 Skill。不要在本路由复制各 Skill 的方法论。

单项路由

模块变更流程

涉及跨模块行为、公共契约、共享数据或影响不明的变更前，当前 Agent 按需使用以下方法。普通小任务只改相关代码并运行与影响、风险相称的检查；文档事实未变就不更新，也不因收尾运行全量审计。MAP 只在路径、入口或定位关系变化时更新；LOG 只记值得追溯的重要事件；TESTS 只在测试入口、使用方法或重要覆盖范围变化时维护，不逐例登记或重复抄写运行结果。 小修范围已知时直接实施和验证，不逐个调用治理 Skill；只读请求保持只读。

1. 改前看影响：记录任务起点及已有未提交修改，按 change-impact 查真实调用方、数据与契约，确定受影响模块、候选文档和验证命令。需求不清先定位已确认 Spec／Issue；跨端接口按 contract-first 处理，难回退决策按 domain-modeling 处理。
2. 实施并核对范围：完成获准修改，对照实际 diff 补查新增影响。任务开始时已有修改须单独区分，不能全归为本轮；出现新的需求或授权冲突时先澄清该部分。
3. 验证本模块与下游：按 module-regression 执行影响分析确定的回归；测试点与证据需要维护时调用 test-collaboration。本次引入的失败由当前改动者修复并复验；旧失败、环境阻塞与未跑范围分别说明，不能把局部通过说成全部通过。
4. 按需同步并交付：实际改变了文档承载的事实时，将任务范围、diff、影响清单和回归结果交给 docs-maintenance；需编写或优化面向 AI 的正文时，按 writing-for-agents 核对改写含义。没有文档事实变化则直接交付，不另建报告、不联动更新全部载体。复用同一基线与有效检查结果；新变化只补相关验证，既有门禁照常执行。最终简述变化、影响、验证及剩余缺口；回归受阻不能把功能写成验收通过。

接入项目入口

由 agent-entrypoints 在已授权配置的共享入口保留一句路标：

涉及跨模块行为、公共契约、共享数据或影响不明的变更前，读取 docs-governance 的“模块变更流程”；普通小任务直接修改、运行相关检查，文档事实未变不更新。

将 Skill 名替换为实际可读取路径；外部插件使用完整路径。setup 通过 agent-entrypoints 接入；已有项目只补这条路标，不复制流程正文。Skill 存在不等于自动运行：这是 Agent 执行约定，未安装 Hook／CI 就不声称强制触发。

边界

• 让 CLAUDE_MAP.md 管项目知识位置，让 ARCHITECTURE.md 管当前 Module 结构；本 Skill 只管插件能力路由。
• 让 Spec/Issue 管业务成功标准，Issue Tracker 管任务状态和排期；不要复制进路由或数据库。
• 不因为用户说“治理”就一次性创建所有可选文档和目录。先发现现有事实载体，再按预警信号懒创建。