review-cycle

レビューチャート

モードベースのルーティングを備えた、統合コードレビューマネージャーです。入力の種類を検出し、適切な実行フェーズに振り分けます。

アーキテクチャの概要

┌──────────────────────────────────────────────────────────┐
│  Review Cycle Orchestrator (SKILL.md)                     │
│  → Parse input → Detect mode → Read phase doc → Execute   │
└───────────────────────────┬──────────────────────────────┘
                            │
          ┌─────────────────┼─────────────────┐
          ↓                 ↓                 ↓
   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
   │   session    │  │   module    │  │    fix      │
   │  (git changes│  │(path pattern│  │(export file │
   │   review)    │  │   review)   │  │  auto-fix)  │
   └─────────────┘  └─────────────┘  └─────────────┘
   phases/           phases/           phases/
   review-session.md review-module.md  review-fix.md

自動モード検出

// ★ 统一 auto mode 检测：-y/--yes 从 $ARGUMENTS 或 ccw 传播
const autoYes = /\b(-y|--yes)\b/.test($ARGUMENTS)

autoYes が true の場合、すべての対話型の確認をスキップし、レビューサイクルの各フェーズでデフォルトを使用します。

モードの検出

function detectMode(args) {
  if (args.includes('--fix')) return 'fix';
  if (args.match(/\*|\.ts|\.js|\.py|\.vue|\.jsx|\.tsx|src\/|lib\//)) return 'module';
  if (args.match(/^WFS-/) || args.trim() === '') return 'session';
  return 'session';  // default
}

入力パターン	検出されたモード	フェーズのドキュメント
src/auth/**	module	phases/review-module.md
src/auth/**,src/payment/**	module	phases/review-module.md
WFS-payment-integration	session	phases/review-session.md
(empty)	session	phases/review-session.md
--fix .review/	fix	phases/review-fix.md
--fix --resume	fix	phases/review-fix.md

使用方法

Skill(skill="review-cycle", args="src/auth/**")                                    # Module mode
Skill(skill="review-cycle", args="src/auth/** --dimensions=security,architecture") # Module + custom dims
Skill(skill="review-cycle", args="WFS-payment-integration")                        # Session mode
Skill(skill="review-cycle", args="")                                               # Session: auto-detect
Skill(skill="review-cycle", args="--fix .workflow/active/WFS-123/.review/")        # Fix mode
Skill(skill="review-cycle", args="--fix --resume")                                 # Fix: resume
Skill(skill="review-cycle", args="-y src/auth/**")                                 # Auto mode (skip confirmations)

# Common flags (all modes):
--dimensions=dim1,dim2,...    Custom dimensions (default: all 7)
--max-iterations=N           Max deep-dive iterations (default: 3)

# Fix-only flags:
--fix                        Enter fix pipeline
--resume                     Resume interrupted fix session
--batch-size=N               Findings per planning batch (default: 5)
--max-iterations=N           Max retry per finding (default: 3)

実行フロー

1. Parse $ARGUMENTS → extract mode + flags
2. Detect mode (session | module | fix)
3. Read corresponding phase doc:
   - session → Read phases/review-session.md → execute
   - module  → Read phases/review-module.md  → execute
   - fix     → Read phases/review-fix.md     → execute
4. Phase doc contains full execution detail (5 phases for review, 4+1 phases for fix)

フェーズの参照ドキュメント（検出されたモードに応じてオンデマンドで読み込みます）：

モード	ドキュメント	ソース	説明
session	phases/review-session.md	review-session-cycle.md	セッションベースのレビュー：git の変更 → 7 次元の並列分析 → 集約 → 詳細分析 → 完了
module	phases/review-module.md	review-module-cycle.md	モジュールベースのレビュー：パスパターン → 7 次元の並列分析 → 集約 → 詳細分析 → 完了
fix	phases/review-fix.md	review-cycle-fix.md	自動修正：ファイルのエクスポート → インテリジェントなバッチ処理 → 並列計画 → 実行 → 完了

プロジェクトのコンテキスト

レビュー基準、チェックリスト、承認ゲートを確認するには、ccw spec load --category review を実行してください。

基本ルール

1. 最初にモードを検出：ほかの処理に進む前に入力を解析し、session／module／fix のモードを判定します
2. 段階的に読み込み：3 つすべてではなく、検出されたモードのフェーズドキュメントのみを読み込みます
3. 全面的に委任：モードの検出後は、フェーズドキュメントが実行フロー全体を担います
4. 自動で続行：フェーズドキュメントには、独自の複数フェーズ実行（Phase 1-5 または Phase 1-4+5）が含まれています
5. 停止しない：フェーズドキュメント内のすべての内部フェーズが完了するまで、実行を継続します

エラー処理

エラー	アクション
入力からモードを判定できない	AskUserQuestion で意図を確認します
フェーズドキュメントが見つからない	ファイルパスを示してエラー終了します
モードに対して無効なフラグが指定された	警告し、デフォルトで続行します

関連コマンド

# View review/fix progress dashboard
ccw view

# Workflow pipeline
# Step 1: Review
Skill(skill="review-cycle", args="src/auth/**")
# Step 2: Fix (after review complete)
Skill(skill="review-cycle", args="--fix .workflow/active/WFS-{session-id}/.review/")