Claude-Code-Workflow/.claude/skills/copyright-docs/phases/02.5-consolidation.md

Phase 2.5: Consolidation Agent

汇总所有分析 Agent 的产出，识别跨模块问题，生成汇总报告。

输入

interface ConsolidationInput {
  output_dir: string;
  agent_summaries: AgentReturn[];      // 6个Agent的简要返回
  cross_module_notes: string[];        // 所有跨模块备注
  metadata: ProjectMetadata;
}

执行

Task({
  subagent_type: "cli-explore-agent",
  prompt: `
## 任务
作为汇总 Agent，读取所有章节文件，执行跨模块分析，生成汇总报告。

## 输入
- 章节文件: {output_dir}/sections/section-*.md
- Agent 摘要: ${JSON.stringify(agent_summaries)}
- 跨模块备注: ${JSON.stringify(cross_module_notes)}

## 分析维度

### 1. 一致性检查
- 术语一致性：同一概念是否使用相同名称
- 命名规范：中英文命名是否统一
- 图表编号：是否连续且正确

### 2. 完整性检查
- 功能覆盖：section-3的功能是否都有对应接口(section-6)
- 算法覆盖：section-4的算法是否在功能中被引用
- 异常覆盖：section-7的异常是否覆盖所有接口

### 3. 关联性检查
- 模块依赖：架构图(section-2)的依赖是否与实际一致
- 数据流向：数据结构(section-5)是否与接口(section-6)匹配
- 跨模块调用：是否存在未记录的跨模块依赖

### 4. 质量检查
- 图表语法：Mermaid 语法是否正确
- 内容深度：各章节是否有足够的详细说明
- 代码引用：是否包含具体的文件路径和行号

## 输出文件

写入: {output_dir}/cross-module-summary.md

### 文件格式

\`\`\`markdown
# 跨模块分析报告

## 1. 文档统计

| 章节 | 图表数 | 子章节数 | 字数 |
|------|--------|----------|------|
| 系统架构图 | 1 | 2 | ~500 |
| ... | ... | ... | ... |

## 2. 发现的问题

### 2.1 严重问题 (必须修复)

| ID | 类型 | 位置 | 描述 | 建议 |
|----|------|------|------|------|
| E001 | 缺失 | section-6 | 缺少权限管理接口 | 补充 /api/permissions 相关接口 |

### 2.2 警告 (建议修复)

| ID | 类型 | 位置 | 描述 | 建议 |
|----|------|------|------|------|
| W001 | 一致性 | section-3/6 | 功能名"用户管理"与接口名"UserModule"不一致 | 统一使用中文或英文 |

### 2.3 提示 (可选修复)

| ID | 类型 | 位置 | 描述 |
|----|------|------|------|
| I001 | 增强 | section-4 | 建议为复杂算法添加复杂度分析 |

## 3. 跨模块关联图

\`\`\`mermaid
graph LR
    S2[架构] --> S3[功能]
    S3 --> S4[算法]
    S3 --> S6[接口]
    S5[数据结构] --> S6
    S6 --> S7[异常]

    S3 -.->|缺少关联| S5
\`\`\`

## 4. 修复建议优先级

1. **E001**: 补充权限管理接口 (阻塞合规)
2. **W001**: 统一术语命名 (影响一致性)
3. ...

## 5. 下一步行动

- [ ] 修复 E001-E00x 严重问题
- [ ] 处理 W001-W00x 警告
- [ ] 可选处理 I001-I00x 提示
\`\`\`

## 返回格式 (JSON)

{
  "status": "completed",
  "output_file": "cross-module-summary.md",
  "stats": {
    "total_sections": 6,
    "total_diagrams": 8,
    "total_words": 3500
  },
  "issues": {
    "errors": [
      {"id": "E001", "type": "missing", "section": "section-6", "desc": "缺少权限管理接口"}
    ],
    "warnings": [
      {"id": "W001", "type": "inconsistency", "sections": ["section-3", "section-6"], "desc": "术语不一致"}
    ],
    "info": [
      {"id": "I001", "type": "enhancement", "section": "section-4", "desc": "建议添加复杂度分析"}
    ]
  },
  "cross_refs": {
    "found": 12,
    "missing": 3
  }
}
`
})

问题分类

严重级别	前缀	含义	处理方式
Error	E	阻塞合规检查	必须修复
Warning	W	影响文档质量	建议修复
Info	I	可改进项	可选修复

问题类型

类型	说明	检查范围
missing	缺失内容	功能-接口对应、异常覆盖
inconsistency	不一致	术语、命名、编号
circular	循环依赖	模块依赖关系
orphan	孤立内容	未被引用的功能/数据结构
syntax	语法错误	Mermaid 图表
enhancement	增强建议	内容深度、引用

与 Phase 4 的集成

// Phase 4 装配时读取汇总报告
const summary = JSON.parse(Read(`${outputDir}/cross-module-summary.md`));

if (summary.issues.errors.length > 0) {
  // 阻止装配，先修复严重问题
  return {
    action: "fix_required",
    errors: summary.issues.errors
  };
}

// 在最终文档中插入跨模块说明
insertCrossModuleSummary(document, summary);

Output

• 文件: cross-module-summary.md
• 返回: 问题列表 + 统计信息