Project Analysis Skill

Generate comprehensive project analysis reports through multi-phase iterative workflow.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐ │ Context-Optimized Architecture │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Phase 1: Requirements → analysis-config.json │ │ ↓ │ │ Phase 2: Exploration → 初步探索，确定范围 │ │ ↓ │ │ Phase 3: Parallel Agents → sections/section-*.md (直接写MD) │ │ ↓ 返回简要JSON │ │ Phase 3.5: Consolidation → consolidation-summary.md │ │ Agent ↓ 返回质量评分+问题列表 │ │ ↓ │ │ Phase 4: Assembly → 合并MD + 质量附录 │ │ ↓ │ │ Phase 5: Refinement → 最终报告 │ │ │ └─────────────────────────────────────────────────────────────────┘

Key Design Principles

• Agent 直接输出 MD: 避免 JSON → MD 转换的上下文开销

• 简要返回: Agent 只返回路径+摘要，不返回完整内容

• 汇总 Agent: 独立 Agent 负责跨章节问题检测和质量评分

• 引用合并: Phase 4 读取文件合并，不在上下文中传递

• 段落式描述: 禁止清单罗列，层层递进，客观学术表达

Execution Flow

┌─────────────────────────────────────────────────────────────────┐ │ Phase 1: Requirements Discovery │ │ → Read: phases/01-requirements-discovery.md │ │ → Collect: report type, depth level, scope, focus areas │ │ → Output: analysis-config.json │ ├─────────────────────────────────────────────────────────────────┤ │ Phase 2: Project Exploration │ │ → Read: phases/02-project-exploration.md │ │ → Launch: parallel exploration agents │ │ → Output: exploration context for Phase 3 │ ├─────────────────────────────────────────────────────────────────┤ │ Phase 3: Deep Analysis (Parallel Agents) │ │ → Read: phases/03-deep-analysis.md │ │ → Reference: specs/quality-standards.md │ │ → Each Agent: 分析代码 → 直接写 sections/section-.md │ │ → Return: {"status", "output_file", "summary", "cross_notes"} │ ├─────────────────────────────────────────────────────────────────┤ │ Phase 3.5: Consolidation (New!) │ │ → Read: phases/03.5-consolidation.md │ │ → Input: Agent 返回的简要信息 + cross_module_notes │ │ → Analyze: 一致性/完整性/关联性/质量检查 │ │ → Output: consolidation-summary.md │ │ → Return: {"quality_score", "issues", "stats"} │ ├─────────────────────────────────────────────────────────────────┤ │ Phase 4: Report Generation │ │ → Read: phases/04-report-generation.md │ │ → Check: 如有 errors，提示用户处理 │ │ → Merge: Executive Summary + sections/.md + 质量附录 │ │ → Output: {TYPE}-REPORT.md │ ├─────────────────────────────────────────────────────────────────┤ │ Phase 5: Iterative Refinement │ │ → Read: phases/05-iterative-refinement.md │ │ → Reference: specs/quality-standards.md │ │ → Loop: 发现问题 → 提问 → 修复 → 重新检查 │ └─────────────────────────────────────────────────────────────────┘

Report Types

Type Output Agents Focus

architecture

ARCHITECTURE-REPORT.md 5 System structure, modules, dependencies

design

DESIGN-REPORT.md 4 Patterns, classes, interfaces

methods

METHODS-REPORT.md 4 Algorithms, critical paths, APIs

comprehensive

COMPREHENSIVE-REPORT.md All All above combined

Agent Configuration by Report Type

Architecture Report

Agent Output File Section

overview section-overview.md System Overview

layers section-layers.md Layer Analysis

dependencies section-dependencies.md Module Dependencies

dataflow section-dataflow.md Data Flow

entrypoints section-entrypoints.md Entry Points

Design Report

Agent Output File Section

patterns section-patterns.md Design Patterns

classes section-classes.md Class Relationships

interfaces section-interfaces.md Interface Contracts

state section-state.md State Management

Methods Report

Agent Output File Section

algorithms section-algorithms.md Core Algorithms

paths section-paths.md Critical Code Paths

apis section-apis.md Public API Reference

logic section-logic.md Complex Logic

Directory Setup

// 生成时间戳目录名 const timestamp = new Date().toISOString().slice(0,19).replace(/[-:T]/g, ''); const dir = .workflow/.scratchpad/analyze-${timestamp};

// Windows (cmd) Bash(mkdir "${dir}\\sections"); Bash(mkdir "${dir}\\iterations");

// Unix/macOS // Bash(mkdir -p "${dir}/sections" "${dir}/iterations");

Output Structure

.workflow/.scratchpad/analyze-{timestamp}/ ├── analysis-config.json # Phase 1 ├── sections/ # Phase 3 (Agent 直接写入) │ ├── section-overview.md │ ├── section-layers.md │ ├── section-dependencies.md │ └── ... ├── consolidation-summary.md # Phase 3.5 ├── {TYPE}-REPORT.md # Final Output └── iterations/ # Phase 5 ├── v1.md └── v2.md

Reference Documents

Document Purpose

phases/01-requirements-discovery.md User interaction, config collection

phases/02-project-exploration.md Initial exploration

phases/03-deep-analysis.md Parallel agent analysis

phases/03.5-consolidation.md Cross-section consolidation

phases/04-report-generation.md Report assembly

phases/05-iterative-refinement.md Quality refinement

specs/quality-standards.md Quality gates, standards

specs/writing-style.md 段落式学术写作规范

../_shared/mermaid-utils.md Shared Mermaid utilities