| name | doc-consolidator |
| description | 文档整合 Skill。当多个并行文档存在漂移、内容重叠、或缺乏单一权威版本时激活：识别主真源，提取补充内容，重建结构，输出整合版本，并制定废弃文档处理计划。触发词：「文档太乱了」「有好几个版本」「哪个才是最新的」「整合这些文档」「文档漂移」「合并文档」「恢复单一真源」。 |
文档整合（doc-consolidator）
减少文档漂移，恢复单一权威指引文件。
基于 closure-orchestration-package 的 master-doc-consolidator 本地化。
激活后立即执行
Step 1 确认整合目标
询问（如未说明）：
「需要整合的文档集合是哪些？
主真源候选是哪个（用户认为最权威的版本）？
整合后应该以什么文件名/路径作为新的真源？」
Step 2 读取所有候选文档
用 explore 子智能体并行读取所有文档
→ 识别每份文档的：创建时间 / 最后修改时间 / 核心内容 / 与其他文档的重叠度
Step 3 确认主真源
基于以下标准判断：
- 最近更新的
- 覆盖范围最完整的
- 用户/项目明确指定的
向用户确认：
「建议以 [文档名] 作为主真源，原因是：[...]
是否确认？」
Step 4 提取补充内容
从其他文档中识别主真源没有覆盖但有价值的内容
逐条列出，询问是否纳入主真源
Step 5 重建结构
基于执行需要（不只是逻辑顺序）重新组织章节：
- 优先放「AI/人首先需要读的内容」
- 参考性内容可以放附录
- 重复内容合并
Step 6 输出整合版本
若覆写会造成版本混淆 → 创建新文件，原文件保留并标注「已被整合，参见新版本」
若无混淆风险 → 直接更新主真源文件（必须先备份到 history/）
Step 7 废弃文档处理计划
对每个被整合的文档，输出处理方案：
- 归档到 history/
- 添加「已废弃」标注
- 更新引用该文档的其他文件
Step 8 整合后一致性验证提示（CO-003 Gap 修复）
整合完成后，主动提示：
「✅ 文档整合完成。
建议：说「做收尾检查」触发 project-closeout，
验证整合后的文档集自洽（各文档间无矛盾、无悬空引用）。」
注意事项
- 覆写前必须备份：整合操作涉及覆写文档，必须先保留原版本到 history/
- 不维护多个顶级主文档：整合目标是「一个类别只有一个权威版本」
- 用户确认主真源：不允许 AI 自行决定哪份文档是主真源
变更记录
v1.1 — 2026-03-19 — Step 8 加入整合后一致性验证提示（CO-003 Gap 修复）
根因：CO-003 沙盘发现：doc-consolidator 完成整合后没有触发 project-closeout 验证文档自洽，整合结果未经验证。
修改内容：
- 新增：Step 8「整合后一致性验证提示」——整合完成后提示用户触发 project-closeout
验证状态：🔵 待验证
v1.0 — 2026-03-19 — 初始创建
根因：认知结构整理和项目文档管理中多次出现「多文档漂移、需要整合」的问题。基于外部包 master-doc-consolidator 本地化。
验证状态：🔵 待验证
