@dtt_siye/atool 1.1.0

package/skills/project-analyze/phases/phase3a-multi-dimensional.md

@@ -0,0 +1,61 @@
+# Phase 3a: Multi-Dimensional Analysis (v5.0 NEW)
+
+**前提条件**: Phase 3 knowledge graph 已构建完成
+**执行者**: 主 Agent（无 sub-agent）
+**输入**: `.atool-docs/knowledge-graph.json`
+
+## 详细步骤
+
+使用 `lib/multi-dimensional-analysis.sh` 执行 5 个独立分析维度：
+
+### 3a.1 结构分析
+- 调用 `analyze_structural()` 函数
+- 计算：层违反率（LVR）、架构健康度、god module / orphan module / unstable core 检测
+- 输入：knowledge-graph.json 的 nodes + edges
+- 输出：layer_distribution, layer_violation_ratio, structural_issues
+
+### 3a.2 行为分析
+- 调用 `analyze_behavioral()` 函数
+- 计算：调用图入度/出度、入口点识别、dispatcher / utility 分类
+- 输入：knowledge-graph.json 的 calls/calls_async 边
+- 输出：entry_points, dispatchers, utilities, max_fan_out/in
+
+### 3a.3 数据分析
+- 调用 `analyze_data()` 函数
+- 计算：数据流率（writers×readers）、Schema 耦合（Jaccard）、状态变更热点
+- 输入：knowledge-graph.json 的 data edges
+- 输出：hotspots (top 10), state_mutations, persistence_flows
+
+### 3a.4 质量分析
+- 调用 `analyze_quality()` 函数
+- 计算：CK Metrics 集成、复合耦合指数 CI(M)、复杂度分布
+- 输入：knowledge-graph.json + Phase 2a CK metrics
+- 输出：coupling_index, complexity_distribution, debt_summary
+
+### 3a.5 语义分析
+- 调用 `analyze_semantic()` 函数
+- 计算：TF-IDF 领域词汇提取、设计模式候选检测、横切关注点分类
+- 输入：knowledge-graph.json nodes 的 labels + tags
+- 输出：domain_vocabulary, design_patterns, cross_cutting_concerns
+
+## 输出
+
+**输出文件**: `.atool-docs/multi-dimensional-analysis.json`
+**格式**: `{version: "5.0", generated_at, structural, behavioral, data, quality, semantic}`
+
+### 3a.6 跨 IDE 适配
+
+| IDE | 执行方式 |
+|-----|----------|
+| Claude | 主 agent 执行全部 5 个维度 |
+| Cursor | 主 agent 执行全部 5 个维度 |
+| Kiro | 仅执行结构分析（3a.1），其余跳过 |
+
+### 3a.7 检查点
+
+每个维度完成后立即写入检查点：
+```
+state.multi_dimensional.{dimension} = { "status": "completed", "at": now() }
+state.checkpoint = { last_completed_phase: "phase3a", ... }
+write analysis-state.json
+```

package/skills/project-analyze/phases/phase4-code-quality.md

@@ -0,0 +1,81 @@
+# Phase 4: Code Quality Assessment
+
+**目标**：独立于结构分析的质量审查，基于 inventory + 知识图谱上下文。
+
+## 前置条件
+
+- Phase 3 已完成（knowledge-graph.json 已生成）
+- Phase 3a（如已执行）提供多维上下文
+
+## v5.0 Multi-Dimensional Context
+
+**Phase 0.5 基线指标**（来自 pre-scan）：
+- 长函数列表（>50行）
+- 未使用 import 候选
+- 嵌套深度估算
+- API 端点安全检查清单
+
+这些指标可作为审查基线——直接使用，无需重新提取。仅读取 confidence: low 的文件和基线中发现问题的文件。
+
+**如果 `.atool-docs/multi-dimensional-analysis.json` 存在**，读取并注入以下上下文到 Phase 4 sub-agent prompt：
+
+- `structural.layer_violation_ratio` → 告知 dimension 5（架构）评分方向
+- `structural.unstable_cores` → 在 dimension 5 中标记
+- `quality.complexity_distribution` → 告知 dimension 1（代码质量）评分方向
+- `data.hotspots` → 告知 dimension 6（可维护性）评分方向
+
+这些数据不替代实际代码审查，而是提供额外的评分校准信号。
+
+## 详细步骤
+
+### 4.1 八维度审查
+
+引用 `skills/code-review/` skill v3.0 的 8 个维度：
+
+| # | 维度 | 规则文件 | 权重 | 关注点 |
+|---|------|----------|------|--------|
+| 1 | 代码质量 | `rules/quality.md` | 0.15 | 圈复杂度、函数长度、嵌套深度、注释率 |
+| 2 | 死代码 | `rules/dead-code.md` | 0.10 | 未使用函数/import、不可达代码 |
+| 3 | 重复代码 | `rules/duplication.md` | 0.10 | 相似代码块、抽象不足 |
+| 4 | 错误/安全 | `rules/error-security.md` | 0.20 | 空catch、SQL注入、硬编码凭证 |
+| 5 | 架构合规 | `rules/architecture.md` | 0.15 | 分层违反、依赖方向、DDD合规 |
+| 6 | 可维护性 | `rules/maintainability.md` | 0.10 | SQALE修复工作量、MI指数 |
+| 7 | 耦合内聚 | `rules/coupling-cohesion.md` | 0.10 | Ca/Ce/Instability、循环依赖（需知识图谱） |
+| 8 | 技术债务 | `rules/deprecation-debt.md` | 0.10 | 已废弃API、TODO老化、过时模式 |
+
+**权重之和验证**：0.15+0.10+0.10+0.20+0.15+0.10+0.10+0.10 = **1.00**
+
+### 4.2 Sub-agent Prompt
+
+完整的 sub-agent prompt 模板见 `prompts/code-review-agent.md`。
+
+### 4.3 后续建议
+
+**架构维度评分 < 60 时**，在报告中追加建议：
+> ⚠️ 架构合规评分偏低，建议运行 `/software-architecture` skill 进行深入架构评审，确定是否需要架构改进或重构。
+
+**多模块架构问题**，建议用户后续执行：
+1. `/software-architecture` — 获取架构风格选型和改进方案
+2. 对应栈的 conventions skill（如 `/java-conventions`）— 校验实现层是否符合规范
+
+### 4.4 输出
+
+写入 `.atool-docs/code-review/{module-slug}.json`。
+
+### 4.5 跨 IDE 适配
+
+| IDE | 执行方式 |
+|-----|----------|
+| Claude | 并行 sub-agents（最多 5 个，按 importance 分批） |
+| Cursor | 顺序执行 |
+| Kiro | **跳过 Phase 4** |
+
+## 检查点
+
+每个模块 code-review JSON 写入后：
+```
+state.modules[module_slug].phase4_status = "completed"
+state.modules[module_slug].phase4_completed_at = now()
+state.checkpoint = { last_completed_phase: "phase4", ... }
+write analysis-state.json
+```

package/skills/project-analyze/phases/phase5-synthesis.md

@@ -0,0 +1,284 @@
+# Phase 5: Document Synthesis
+
+**目标**：以知识图谱为唯一数据源，生成所有最终交付物。
+
+## 前置条件
+
+- Phase 2 已完成（所有 MODULE-DOC.md + analysis.json）
+- Phase 3 已完成（knowledge-graph.json）
+- Phase 4 如已执行（code-review JSON 可用）
+
+## Phase 5 新增输出文件 (v5.0)
+
+| 文件 | 说明 |
+|------|------|
+| `.atool-docs/multi-dimensional-analysis.json` | Phase 3a 五维分析结果 |
+| `.atool-docs/query-index.json` | 节点名称 → ID 查询索引 |
+| `.atool-docs/visualization/index.html` | Cytoscape.js 交互可视化 |
+| `docs/503-call-chain-analysis.md` | 调用图分析（G3 粒度）|
+| `docs/504-data-lineage.md` | 数据血缘分析（G4 粒度）|
+| `docs/505-impact-matrix.md` | 跨模块影响矩阵 |
+| `docs/604-architectural-layers.md` | 架构层分析（G1 粒度）|
+| `docs/605-quality-metrics.md` | 形式化质量分析报告 |
+
+可视化生成：调用 `lib/generate-visualization.sh` 的 `generate_visualization()`，
+读取 knowledge-graph.json，生成 Cytoscape.js 独立 HTML 文件。
+
+## 详细步骤
+
+### 5.1 交付物清单
+
+| 产出 | 数据源 | 说明 |
+|------|--------|------|
+| README.md | 图谱指标 + 模块元数据 + inventory | 项目概述、架构图、技术栈 |
+| COMPONENT.md | 图谱节点(by type) + analysis.json | 组件/模块详细文档 |
+| UI_STYLE.md | UI 组件 inventory | **仅 UI 项目**（web/mobile） |
+| CODE_REVIEW.md | Phase 4 各模块报告聚合 | 质量评分 + 问题清单 |
+| docs/ 知识库（~15文件） | 图谱导出视图 | 全类别文档 |
+| IDE 规则 | 模板 + 项目数据 | CLAUDE.md, .cursor/rules/, .kiro/steering/ |
+| knowledge-graph.json | Phase 3 产出 | 全局知识图谱（中间产物，同时交付） |
+
+### 5.1a 增量文档更新（progressive synthesis）
+
+**核心变更**：Phase 5 不再等待全部完成后统一生成，而是在每个模块完成 Phase 2 后立即生成对应文档片段。
+
+#### 增量更新策略
+
+```
+Phase 5 incremental flow:
+
+1. After each batch of Phase 2 modules 完成后:
+   a. Generate MODULE-DOC.md for each completed module → docs/603-module-{slug}.md
+   b. Update COMPONENT.md (append module entry, using <!-- aTool-module-start:{slug} --> ... <!-- aTool-module-end:{slug} --> markers)
+   c. Update 000-index.md (add module to navigation)
+   d. Write checkpoint (phase5_modules_done: [...])
+
+2. After ALL Phase 2 modules complete:
+   a. Generate README.md (needs complete module list)
+   b. Generate full docs/ knowledge base (201, 301, 401, 501, etc.)
+   c. Generate UI_STYLE.md (**仅 UI 项目** — 见 5.4 排除规则), CODE_REVIEW.md
+   d. Generate IDE rules
+
+3. After Phase 4 completes:
+   a. Generate/update CODE_REVIEW.md (aggregate quality scores)
+
+4. After Phase 2a (L4) completes:
+   a. Generate docs/900-call-chains/index.md
+   b. Generate docs/901-hotspot-report.md
+   c. Generate docs/902-security-audit.md
+
+5. After Phase 2b (L5) completes:
+   a. Generate docs/903-data-lineage.md
+   b. Generate docs/904-sequence-diagrams.md
+   c. Generate docs/905-state-machines.md
+   d. Generate cross-module-behavior.md (global aggregation)
+
+6. After Phase 3a (v5.0) completes:
+   a. Generate docs/503-call-chain-analysis.md (G3 粒度调用图)
+   b. Generate docs/504-data-lineage.md (G4 粒度数据血缘)
+   c. Generate docs/505-impact-matrix.md (跨模块影响矩阵)
+   d. Generate docs/604-architectural-layers.md (架构层分析)
+   e. Generate docs/605-quality-metrics.md (形式化质量报告)
+   f. Generate .atool-docs/query-index.json
+   g. Generate .atool-docs/visualization/index.html (Cytoscape.js)
+```
+
+#### COMPONENT.md 增量标记
+
+使用标记包裹每个模块段落，恢复时只替换对应标记内容：
+```
+<!-- aTool-module-start:user-management -->
+### 用户管理模块
+...模块内容...
+<!-- aTool-module-end:user-management -->
+```
+
+### 5.2 README.md 生成
+
+**数据来源**：`knowledge-graph.json`（模块列表、指标）+ 各 `analysis.json`（职责描述）+ `inventory/`（文件统计）。
+
+必须包含（中文标题）：
+
+```markdown
+# {项目名称}
+
+## 项目概述
+## 本目录内容说明
+## 技术栈
+## 架构设计
+### 架构图（ASCII art — 从图谱 mermaid_diagrams 转换）
+### 数据流图
+## 目录结构
+## 各层详细说明
+## 认证与权限（如适用）
+## 构建与部署
+## 开发指南
+## 新人上手检查清单
+  ### 阶段 1：环境准备
+  ### 阶段 2：项目理解
+  ### 阶段 3：开发实战
+  ### 阶段 4：业务理解
+```
+
+### 5.3 COMPONENT.md 生成
+
+**数据来源**：所有 `MODULE-DOC.md` 的结构化重组。
+
+聚合映射：
+| 章节 | 来源 |
+|------|------|
+| 按功能分组的索引 | 所有 MODULE-DOC.md 的路径+职责 |
+| 各模块详细文档 | MODULE-DOC.md 核心内容 |
+| 跨模块依赖关系图 | knowledge-graph.json edges |
+
+每个模块条目包含：定义与设计意图、内部架构（ASCII树）、公开API、Props（如适用）、依赖关系、使用指南（实际import代码）、扩展指南、引用分析。
+
+### 5.4 UI_STYLE.md 生成
+
+> **⚠️ 硬性门控条件：生成 UI_STYLE.md 前，必须先检查 `analysis-state.json` 的 `stack` 字段。如果 stack 为 `java`、`java-spring`、`go`、`rust`、`python`、`devops`、`devops-k8s` 中的任何一个，则**跳过 UI_STYLE.md 生成，不做任何输出**。违反此规则是严重错误。**
+
+排除规则（**必须在生成前检查**）：
+
+| 技术栈 | 操作 |
+|--------|------|
+| `java`, `java-spring`, `go`, `rust`, `python`, `devops`, `devops-k8s` | **跳过 — 不生成 UI_STYLE.md** |
+| `web-*`, `mobile-*`, `rust-tauri`, `android`, `harmony` | 生成 |
+| `generic` | 检测项目中是否存在 `.vue`/`.tsx`/`.jsx`/`.svelte`/`.css`/`.scss`/`.less` 等 UI 文件，无则跳过 |
+
+从实际代码文件提取真实值（颜色变量、字体、间距 Token），禁止占位符。
+
+### 5.5 CODE_REVIEW.md 生成
+
+聚合 Phase 4 各 `.atool-docs/code-review/{module-slug}.json`：
+
+```markdown
+# 代码质量报告
+## 综合评分：{score}/100 — {health_level}
+## 各维度评分
+| 维度 | 评分 | 权重 | 问题数 |
+## 问题清单（按严重度排序）
+## 架构合规评估
+## 模块级架构健康度
+## 优先修复清单（Top 10）
+## 重构建议
+```
+
+### 5.6 PRD/业务文档增强
+
+基于知识图谱的结构化推断：
+
+**业务规则推断**（从 validation 逻辑、error message、permission check）：
+```
+源码线索                          → 推断业务规则
+表单校验 required/maxLength       → 字段级业务约束
+API 错误码映射                    → 业务异常场景
+权限注解 @PreAuthorize            → 角色-操作授权矩阵
+if/switch 状态判断                → 业务状态机
+```
+
+**用户故事推断**（从 route → page → form → API call chain）：
+```
+[路由 /user/list] → [UserList.vue] → [搜索表单 + 表格] → [GET /api/users]
+推断用户故事: "作为管理员，我希望按条件搜索用户列表"
+```
+
+**数据模型推断**（从 ORM annotation、TypeScript interface、migration file）：
+- 生成 ER 图（Mermaid + ASCII）
+- 实体详情表
+
+### 5.7 docs/ 知识库生成
+
+目录结构：
+
+```
+docs/
+├── 000-navigation/000-index.md          # 文档导航枢纽
+├── 100-standards/101-documentation-standards.md
+├── 200-product/201-project-brief.md     # 项目简介 [推断]
+├── 300-requirements/301-feature-summary.md  # 功能摘要
+├── 400-design/
+│   ├── 401-system-design.md             # 系统设计 [推断]
+│   └── 402-ui-wireframe-{page}.md       # UI线框图（仅UI项目）
+├── 500-data/
+│   ├── 501-data-model.md                # 数据模型 + ER图
+│   ├── 502-data-dictionary.md           # 字段级字典（L3+）
+│   ├── 503-call-chain-analysis.md       # 调用图分析（G3 粒度）(v5.0)
+│   ├── 504-data-lineage.md             # 数据血缘分析（G4 粒度）(v5.0)
+│   └── 505-impact-matrix.md            # 跨模块影响矩阵 (v5.0)
+├── 600-architecture/
+│   ├── 601-system-overview.md           # ← README.md 重组
+│   ├── 602-component-reference.md       # ← COMPONENT.md 重组
+│   ├── 603-module-{name}.md             # ← MODULE-DOC.md 重组
+│   ├── 604-architectural-layers.md      # 架构层分析 (v5.0)
+│   └── 605-quality-metrics.md           # 形式化质量分析报告 (v5.0)
+├── 700-engineering/
+│   ├── 701-api-reference.md
+│   └── 702-ui-style-guide.md            # ← UI_STYLE.md（仅UI项目）
+└── 800-operations/801-deployment-guide.md
+```
+
+每个文件 frontmatter：
+
+```yaml
+---
+doc_id: {PREFIX}-{ID}
+title: {中文标题}
+status: draft
+owner: aTool
+last_updated: YYYY-MM-DD
+related_docs: [关联文件列表]
+---
+```
+
+每个文件必须包含 4 个章节：Purpose、Main Content、Related Documentation、Version History。
+
+推断内容统一标记 `[推断]`。
+
+### 5.8 IDE 规则生成
+
+| 目标文件 | 模板 | 输出路径 |
+|----------|------|----------|
+| CLAUDE.md | `templates/CLAUDE.md.{template}` | `{project_dir}/CLAUDE.md` |
+| Cursor rules | `templates/cursor-rules.{template}.mdc` | `{project_dir}/.cursor/rules/atool-conventions.mdc` |
+| Kiro steering | `templates/kiro-steering.{template}.md` | `{project_dir}/.kiro/steering/atool-conventions.md` |
+
+追加项目特定规则（架构摘要、编码约定、已分析模块索引、文档同步规则）。已有 CLAUDE.md 时只追加 `## 项目特定规则` 段落，不覆盖用户手写内容。
+
+**IDE 规则数据注入**：IDE 规则不应使用纯静态模板，而应从 Phase 2 的 `analysis-state.json` 提取实际技术选型注入模板：
+- **构建工具**：检测到 Maven → 使用 `./mvnw` 命令；检测到 Gradle → 使用 `./gradlew` 命令
+- **ORM 框架**：MyBatis-Plus / Spring Data JPA / Hibernate → 注入对应的编码约定
+- **日志框架**：SLF4J+Logback / Log4j2 → 注入对应的日志规范
+- **项目特有模式**：Lombok 使用、MapStruct 使用、自定义注解等 → 追加到 IDE 规则
+- 通过 `template_substitute_blocks()` 函数替换模板中的 `{{#REAL_CONFIG}}...{{/REAL_CONFIG}}` 块
+
+### 5.9 文档格式验证
+
+Phase 5 所有文档输出前，执行以下验证：
+1. **docs/ 目录文档**：调用 `doc-standards-enforcer` skill 的规则验证 frontmatter（doc_id, title, status, owner, last_updated, required sections）
+2. **README.md / COMPONENT.md**：验证包含所有必需章节（见 5.2/5.3 要求）
+3. **IDE 规则文件**：验证不包含占位符（`com/example/`、`{{UNRESOLVED}}`）
+
+验证失败时：标记该文件为 `[需人工审阅]` 并在 Phase 6 摘要中报告。
+
+### 5.9 Monorepo / 多项目处理
+
+- **Monorepo**：每个子项目独立走 Phase 0-5 流程；根目录额外生成总览 README + 总 docs/
+- **多项目文件夹**：4 阶段——(1)项目发现 (2)每子项目独立 sub-agent 走 Phase 1-5 (3)跨项目关联分析 (4)根目录文档合成
+- 子项目 sub-agent 完成后**立即释放上下文**，主 agent 仅保留摘要
+
+## 跨 IDE 适配
+
+| IDE | 执行方式 |
+|-----|----------|
+| Claude | 全量生成 |
+| Cursor | 全量生成 |
+| Kiro | 使用 inventory 仅生成 L1 质量文档 |
+
+## 检查点
+
+每个文档文件写入后写入 checkpoint：
+```
+state.modules[module_slug].phase5_docs_generated = true
+state.checkpoint = { last_completed_phase: "phase5", ... }
+write analysis-state.json
+```

package/skills/project-analyze/phases/phase6-validation.md

@@ -0,0 +1,179 @@
+# Phase 6: Validation
+
+**目标**：逐项验证交付物质量，更新状态文件，输出摘要报告。
+
+## 前置条件
+
+- Phase 5 已完成（所有交付物已生成）
+
+## 详细步骤
+
+### 6.1 质量检查清单（~68 项）
+
+按阶段分组验证：
+
+**P0 基础质量**
+- [ ] README.md 含 ASCII 架构图（非纯文字）
+- [ ] README.md 技术栈表有真实版本号
+- [ ] README.md 含数据流图
+- [ ] COMPONENT.md 每个模块有公开 API 表（非文件列表）
+- [ ] COMPONENT.md 关键模块有使用示例代码
+- [ ] 无占位符（xxx, TODO, ...）
+- [ ] 无纯文件列表条目
+
+**P0 输出语言**
+- [ ] 所有标题和正文为中文
+- [ ] ASCII 图标注为中文
+- [ ] 代码块/路径/标识符保持英文
+
+**P1 Inventory**
+- [ ] 每个模块有 inventory JSON
+- [ ] 函数签名含参数和返回类型（如可推断）
+- [ ] import 路径记录完整
+
+**P2 Deep Analysis**
+- [ ] 每个显著模块有 MODULE-DOC.md
+- [ ] MODULE-DOC.md 包含 11 项必需内容
+- [ ] 设计意图标记 `[设计意图: 推断理由]`
+- [ ] 每个模块有 references.json
+- [ ] 模块概述无泛泛描述
+
+**P3 Knowledge Graph**
+- [ ] knowledge-graph.json 完整（nodes + edges + issues）
+- [ ] 图谱指标已计算（Ca/Ce/Instability）
+- [ ] 循环依赖已检测并标记
+- [ ] 孤立模块已检测
+- [ ] Mermaid 图表已生成
+
+#### P3a Multi-Dimensional Analysis (v5.0 NEW)
+
+- [ ] knowledge-graph.json 包含 v5.0 schema（version, layers, indexes 字段）
+- [ ] 边权重范围 [0.0, 1.0]，置信度范围 [0.0, 1.0]
+- [ ] 所有边引用的 source/target 节点 ID 存在于 nodes 数组
+- [ ] 图索引（5 个）与 nodes/edges 数据一致
+- [ ] multi-dimensional-analysis.json 包含全部 5 个维度
+- [ ] visualization/index.html 可正常打开且无 JS 错误
+- [ ] CK metrics 覆盖率 >80%（OO 项目）
+- [ ] 架构层分配完成（>=90% 模块已分配）
+
+**P4 Code Quality**
+- [ ] 8 个维度规则全部加载（L2/L3）
+- [ ] 评分权重之和 = 1.00
+- [ ] 问题按严重度分类（Critical/Warning/Info）
+- [ ] 修复建议具体可执行
+- [ ] 安全问题无环境变量误报
+- [ ] 重构建议含具体步骤和预计工作量
+
+#### P4a L4 Quality（仅 depth >= L4 时）
+
+- [ ] 每个 completed module 的 l4-analysis.json 存在且格式正确
+- [ ] hotspot 有 severity 分类（critical/warning/info）
+- [ ] security_points 有 status 标记（present/missing/mitigated）
+- [ ] call_chain 无孤立节点（每个 callee 有对应函数定义）
+- [ ] data_flow 描述完整（inputs → transforms → outputs）
+
+#### P4b L5 Quality（仅 depth >= L5 时）
+
+- [ ] 每个 completed module 的 l5-analysis.json 存在且格式正确
+- [ ] 时序图 Mermaid 语法正确（可渲染）
+- [ ] 状态机有完整状态列表和触发条件
+- [ ] 数据血缘有跨模块引用（cross_module: true）
+- [ ] cross-module-behavior.json 聚合完整（无空 global_sequence_diagrams）
+
+**P5 Synthesis**
+- [ ] README/COMPONENT/UI_STYLE 在项目目录，非 .atool-docs/
+- [ ] 纯后端项目未生成 UI_STYLE.md
+- [ ] CLAUDE.md 已追加项目特定规则
+- [ ] Cursor .mdc 和 Kiro steering 已生成
+- [ ] IDE 规则含真实项目数据（非占位符）
+- [ ] docs/ 目录结构完整（全类别）
+- [ ] 每个 docs/ 文件含标准 frontmatter + 4 必需章节
+- [ ] related_docs 中引用的路径实际存在
+- [ ] 推断内容标记 [推断]
+
+**P6 Zero-KT**
+- [ ] README 含新人检查清单（4 阶段 checkbox）
+- [ ] MODULE-DOC.md 含业务术语表
+- [ ] MODULE-DOC.md 含常见开发场景（含代码示例）
+- [ ] MODULE-DOC.md 含故障排查指南
+- [ ] 三人测试通过
+
+### 6.2 交叉引用检查
+
+- 所有 `knowledge-graph.json` 中的模块在 docs/ 中有对应文档
+- 所有 docs/ 文件的 related_docs 路径指向实际存在的文件
+- MODULE-DOC.md 中引用的关联模块文档链接有效
+
+### 6.3 状态更新
+
+更新 `analysis-state.json`：
+
+```json
+{
+  "status": "completed",
+  "updated_at": "...",
+  "phases": {
+    "phase0_discovery": { "status": "completed" },
+    "phase1_inventory": { "status": "completed" },
+    "phase2_deep_analysis": { "status": "completed" },
+    "phase3_knowledge_graph": { "status": "completed" },
+    "phase3a_multi_dimensional": { "status": "completed" },
+    "phase4_code_quality": { "status": "completed" },
+    "phase5_synthesis": { "status": "completed" },
+    "phase6_validation": { "status": "completed" }
+  },
+  "quality_check": {
+    "total": 68,
+    "passed": 65,
+    "failed": 3,
+    "failed_items": ["xxx", "xxx", "xxx"]
+  }
+}
+```
+
+### 6.4 摘要报告
+
+```
+✅ 项目分析完成
+
+📊 分析统计
+  技术栈: web-react (React 18 + TypeScript)
+  规模: MEDIUM (342 文件, 28 模块)
+  深度: L2 (架构分析)
+  耗时: ~8 分钟
+
+📁 产出文件
+  README.md                    ✓
+  COMPONENT.md                 ✓
+  CODE_REVIEW.md               ✓ (综合评分: 42/100 — 需关注)
+  UI_STYLE.md                  ✓
+  CLAUDE.md                    ✓ (已追加项目规则)
+  .cursor/rules/               ✓
+  .kiro/steering/              ✓
+  docs/ (15 文件)              ✓
+  knowledge-graph.json         ✓ (28 节点, 67 边, 14 类型)
+  multi-dimensional-analysis   ✓ (5 维度)
+  visualization/index.html     ✓ (Cytoscape.js)
+
+🔍 发现的问题
+  2 个循环依赖 (Critical)
+  1 个孤立模块 (Warning)
+  1 个上帝模块 (Warning)
+
+📋 质量检查: 65/68 通过
+  3 项待修复 → 详见 .atool-docs/analysis-state.json
+```
+
+## 跨 IDE 适配
+
+所有 IDE 均执行本阶段。
+
+## 检查点
+
+验证完成后：
+```
+state.phases.phase6_validation.status = "completed"
+state.status = "completed"
+state.checkpoint = { last_completed_phase: "phase6", ... }
+write analysis-state.json
+```