---
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 本地化。

**验证状态**：🔵 待验证