Subagent Generate

Subagent Generate Workflow

Skills群に対応するサブエージェントを生成する。主成果物はoutput/{domain}_agent/.claude/agents/配下のサブエージェント定義。

Instructions

1. Preflight（事前確認）

• ./assets/subagent_design_guide.md を先に読み、サブエージェント設計原則を確認する。
• 対象エージェントの .github/skills/ を確認し、既存Skillsを把握する。
• 各SkillのSKILL.mdから recommended_subagents を抽出する。

2. サブエージェント判定

重要: サブエージェント化の判定基準

以下の条件を満たす場合のみ .claude/agents/*.md を作成する:

単なる評価軸の評価（チェックリスト確認等）は evaluation/*.md で対応し、agents/*.md は作成しない。

3. サブエージェント設計

サブエージェント化が必要と判定された場合、以下を設計する:

サブエージェント設計:
  name: "{purpose}-agent"
  type: "{research|feedback|ideation|validation|parallel-check}"
  携帯Skills:
    - "{関連skill-1}"
    - "{関連skill-2}"
  入力: "{何を受け取るか}"
  出力: "{何を返すか}"
  並列実行: "{可能/不可}"
  Web検索: "{必要/不要}"

4. サブエージェント生成

設計に基づき、各サブエージェントを生成する:

output/{domain}_agent/.claude/agents/{agent-name}.md

サブエージェント定義フォーマット:

---
name: {agent-name}
description: "{説明}"
type: "{research|feedback|ideation|validation|parallel-check}"
tools: [Read, Grep, Glob, WebSearch, WebFetch]  # 必要なツール
---

# {Agent Name}

{目的と役割の説明}

## 携帯Skills

このサブエージェントは以下のSkillsを参照して実行する:

- `.github/skills/{skill-1}/`: {説明}
- `.github/skills/{skill-2}/`: {説明}

## 実行手順

1. {ステップ1}
2. {ステップ2}
3. {ステップ3}

## 入力

- {入力パラメータ1}: {説明}
- {入力パラメータ2}: {説明}

## 出力

- {出力形式の説明}
- {レポートフォーマット等}

## 判定基準

- {成功条件1}
- {成功条件2}

5. サブエージェントタイプ別テンプレート

research-agent（調査系）:

• Web検索で最新情報を収集
• 公式ドキュメント・ベストプラクティスを調査
• 携帯Skills: 対象ドメインの参照系Skills

feedback-agent（フィードバック系）:

• 成果物に対する客観的レビュー
• 改善提案・代替案の提示
• 携帯Skills: 評価対象のSkills + evaluation基準

ideation-agent（アイデア出し系）:

• 複数のアプローチを並列生成
• ブレインストーミング的発想
• 携帯Skills: ドメイン知識系Skills

validation-agent（検証系）:

• 仮説の妥当性検証
• 実現可能性チェック
• 携帯Skills: 技術制約系Skills

parallel-check-agent（並列チェック系）:

• 複数ファイルの同時チェック
• 独立した検証を並列実行
• 携帯Skills: チェック対象のSkills

6. QC（必須）

• recommended_subagents のQC Subagent（qa-skill-qc）に評価を委譲する。
• Subagentは ./evaluation/subagent_criteria.md をReadし、QCを実施する。
• チェック項目:
  • サブエージェント化判定が適切か
  • 携帯Skillsが適切に設定されているか
  • 入出力定義が明確か
  • 並列実行可能性が正しく判定されているか
• 指摘を最小差分で反映する（最大3回）。

7. バックログ反映

• 生成したサブエージェント一覧を記録する。
• CLAUDE.mdにサブエージェント索引を追加する。
• 次アクション（テスト実行等）を明示する。

subagent_policy:

• 品質ループ（QC/チェック/フィードバック）は必ずサブエージェントへ委譲する
• サブエージェントの指摘を反映し、反映結果（修正有無/理由）を成果物に残す

recommended_subagents:

• qa-skill-qc: サブエージェント化判定、携帯Skills設定、入出力定義を検査

Resources

• assets: ./assets/subagent_design_guide.md
• assets: ./assets/subagent_template.md
• assets: ./assets/subagent_types.md
• evaluation: ./evaluation/subagent_criteria.md
• triggers: ./triggers/next_action_triggers.md

Next Action

• triggers: ./triggers/next_action_triggers.md

起動条件に従い、条件を満たすSkillを自動実行する。