Workflow Designer

目的

複数の Skills を連動させて、一連のワークフローとして設計する。

ユースケース:

• 開発ワークフロー（計画→実装→テスト→レビュー）
• PM ワークフロー（憲章→要件→リスク→週次）
• 調査ワークフロー（情報収集→分析→レポート）
• カスタムワークフロー

トリガー語

• 「ワークフローを設計」
• 「スキル連動を作成」
• 「一連の流れを定義」
• 「Skills チェーンを設計」
• 「自動化フローを構築」

入力で最初に聞くこと

Skills 参照先: .agent/registry.md で利用可能な Skills を確認

手順

Phase 1: ワークフロー構造の設計

1. ゴール分解

   • 最終ゴールを中間成果物に分解
   • 各成果物に必要な Skill を特定

2. 依存関係マッピング

   Skill A → Skill B → Skill C
       ↓
   Skill D (並列実行可能)
   

3. フェーズ分割

   • 論理的なフェーズに分割
   • フェーズ間にユーザー確認ポイントを配置

Phase 2: チェックポイント設計

確認粒度に応じて配置:

チェックポイントの種類:

確認粒度 (checkpoint_level) の enum 値:

• phase_level: フェーズ単位で確認
• step_level: 各ステップ（Skill実行）後に確認
• minimal: クリティカルな分岐点のみ

Phase 3: エラーハンドリング設計

各 Skill に対して定義:

error_handling:
  on_failure:
    retry: 2                # 再試行回数
    fallback: skill_x       # 代替 Skill
    escalate: user          # ユーザーに介入要請
  on_stuck:
    threshold: 3            # 同一エラー許容回数
    action: pause           # 一時停止して確認
    escalate: user          # ユーザーに介入要請

Phase 3.5: 条件分岐設計（オプション）

分岐が必要な場合:

steps:
  - id: check
    skill: verification
  - id: success_path
    skill: finalize
    depends_on: [check]
    condition: "check.result == 'success'"
  - id: failure_path
    skill: debug
    depends_on: [check]
    condition: "check.result == 'failure'"

条件分岐は結果に応じて異なるパスを実行する場合に使用。

Phase 4: ワークフロー定義の生成

Markdown 形式で出力:

# ワークフロー: {name}

## 概要
- **ゴール**: {goal}
- **推定所要時間**: {estimated_time}
- **確認粒度**: {checkpoint_level}

## フェーズ構成

### Phase 1: {phase_name}
| Step | Skill | 入力 | 出力 | チェックポイント |
|------|-------|------|------|-----------------|
| 1.1 | skill_a | ... | ... | review |
| 1.2 | skill_b | 1.1の出力 | ... | none |

**フェーズ完了条件**: {criteria}
**ユーザー確認**: {checkpoint_type}

### Phase 2: ...

## エラーハンドリング
| Skill | 失敗時 | スタック時 |
|-------|--------|-----------|
| skill_a | retry(2) → fallback | escalate |

## 成功基準
- [ ] {criterion_1}
- [ ] {criterion_2}

成果物

検証

• 全ての Skills が .agent/registry.md に登録されている
• 依存関係に循環がない
• チェックポイントが適切に配置されている
• エラーハンドリング（on_failure, on_stuck）が全 Skill に定義されている
• 成功基準が測定可能

テンプレート

開発ワークフローテンプレート

Phase 1: 計画
├─ brainstorming (設計) → review
├─ writing-plans (計画書) → approval
└─ [ユーザー確認: 計画承認]

Phase 2: 実装
├─ codex-cli (コード生成) → review
├─ test-driven-development (テスト) → notification
└─ [ユーザー確認: 実装レビュー]

Phase 3: 検証
├─ systematic-debugging (デバッグ) → notification
├─ verification-before-completion (検証) → approval
└─ [ユーザー確認: 完了承認]

PM ワークフローテンプレート

Phase 1: 立ち上げ
├─ project-charter → approval
└─ [ユーザー確認: 憲章承認]

Phase 2: 計画
├─ requirements → review
├─ risk-register → notification
└─ [ユーザー確認: 計画承認]

Phase 3: 実行・監視
├─ weekly-status → notification
├─ meeting-minutes → notification
└─ [定期確認: 週次]

調査ワークフローテンプレート

Phase 1: 情報収集
├─ playwright (Web調査) → notification
├─ dispatching-parallel-agents (並列調査) → review
└─ [ユーザー確認: 調査範囲確認]

Phase 2: 分析
├─ brainstorming (分析) → review
└─ [ユーザー確認: 分析方針確認]

Phase 3: レポート
├─ docx / pptx (レポート生成) → approval
└─ [ユーザー確認: 最終承認]

詳細リファレンス

→ REFERENCE.md