project-analyze

プロジェクト分析スキル

複数フェーズにわたる反復ワークフローを通じて、包括的なプロジェクト分析レポートを生成します。

アーキテクチャ概要

┌─────────────────────────────────────────────────────────────────┐
│  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        → 最终报告                           │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

主な設計原則

1. エージェントが MD を直接出力：JSON → MD の変換に伴うコンテキストのオーバーヘッドを避けます
2. 簡潔な応答：エージェントはパスと要約のみを返し、完全な内容は返しません
3. 集約エージェント：独立したエージェントが、セクション間の問題検出と品質評価を担当します
4. 引用の統合：フェーズ 4 ではファイルを読み込んで統合し、コンテキスト内での受け渡しは行いません
5. 段落形式の記述：箇条書きは禁止し、段階的に論を展開して、客観的かつ学術的に記述します

実行フロー

┌─────────────────────────────────────────────────────────────────┐
│  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: 发现问题 → 提问 → 修复 → 重新检查                       │
└─────────────────────────────────────────────────────────────────┘

レポートの種類

種類	出力	エージェント	焦点
architecture	ARCHITECTURE-REPORT.md	5	システム構造、モジュール、依存関係
design	DESIGN-REPORT.md	4	パターン、クラス、インターフェース
methods	METHODS-REPORT.md	4	アルゴリズム、重要な処理経路、API
comprehensive	COMPREHENSIVE-REPORT.md	すべて	上記すべてを統合

レポートの種類別エージェント構成

アーキテクチャレポート

エージェント	出力ファイル	セクション
overview	section-overview.md	システム概要
layers	section-layers.md	レイヤー分析
dependencies	section-dependencies.md	モジュールの依存関係
dataflow	section-dataflow.md	データフロー
entrypoints	section-entrypoints.md	エントリーポイント

設計レポート

エージェント	出力ファイル	セクション
patterns	section-patterns.md	デザインパターン
classes	section-classes.md	クラスの関係
interfaces	section-interfaces.md	インターフェース契約
state	section-state.md	状態管理

メソッドレポート

エージェント	出力ファイル	セクション
algorithms	section-algorithms.md	コアアルゴリズム
paths	section-paths.md	重要なコードパス
apis	section-apis.md	パブリック API リファレンス
logic	section-logic.md	複雑なロジック

ディレクトリの設定

// 生成时间戳目录名
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"`);

出力構成

.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

参照ドキュメント

ドキュメント	目的
phases/01-requirements-discovery.md	ユーザーとのやり取り、設定の収集
phases/02-project-exploration.md	初期調査
phases/03-deep-analysis.md	エージェントによる並列分析
phases/03.5-consolidation.md	セクション横断の統合
phases/04-report-generation.md	レポートの組み立て
phases/05-iterative-refinement.md	品質の改善
specs/quality-standards.md	品質基準、標準
specs/writing-style.md	段落形式の学術的な文章作成規範
../_shared/mermaid-utils.md	共通の Mermaid ユーティリティ