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 本地化。
验证状态:🔵 待验证