Génération de sous-agents

VérifiéSûr

Concevoir et générer des sous-agents Claude (.claude/agents/*.md) correspondant à des groupes de compétences. Utilisé pour créer des agents spécialisés, parallèles et autonomes.

Spar Skills Guide Bot
DeveloppementIntermédiaire
5002/06/2026
Claude Code
#subagent#agent-generation#skill-management#parallel-processing#workflow-design

Recommandé pour

Notre avis

Génère des définitions de sous-agents (.claude/agents/*.md) basées sur des compétences existantes, en suivant des principes de conception et des contrôles qualité.

Points forts

  • Automatise la création de sous-agents spécialisés pour des tâches parallèles ou expertes.
  • Impose des décisions de conception basées sur des critères objectifs (indépendance du contexte, besoin de compétences).
  • Inclut un sous-agent de contrôle qualité pour valider les agents générés.
  • Fournit des templates pour différents types de sous-agents (recherche, feedback, idées, validation).

Limites

  • Nécessite que les compétences soient bien définies dans le répertoire skills.
  • La génération dépend de guides et templates de conception à jour.
  • Peut complexifier inutilement un petit ensemble de compétences.
Quand l'utiliser

Utilisez-le lorsque vous avez plusieurs compétences qui peuvent bénéficier de sous-agents dédiés pour paralléliser ou spécialiser des tâches.

Quand l'éviter

Ne l'utilisez pas pour des tâches d'évaluation simples qui peuvent être traitées par des critères d'évaluation seuls, ou lorsque le contexte est fortement lié à la tâche parente.

Analyse de sécurité

Sûr
Score qualité85/100

The skill generates sub-agent definition markdown files using standard reading and writing tools. No destructive commands, external network calls beyond WebSearch/WebFetch, or exfiltration are involved. No obfuscation or disabling of safety mechanisms.

Aucun point d'attention détecté

Exemples

Create a subagent for documentation review
Create a subagent for the 'documentation-review' skill to review documentation.
Design parallel-check agents for all project skills
Design parallel-check agents for all skills in the project.
Generate a feedback-agent for code review
Generate a feedback-agent for the code-review skill.

name: subagent-generate description: "Skills群に対応するサブエージェント(.claude/agents/*.md)を設計・生成する。「サブエージェント作成」「並列処理エージェント」「専門エージェント」を依頼されたときに使用する。"

Subagent Generate Workflow

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

Instructions

1. Preflight(事前確認)

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

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

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

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

| 条件 | サブエージェント化 | 理由 | |------|-------------------|------| | コンテキスト不要で独立実行可能 | ✅ 必要 | 並列実行のメリットあり | | 専門知識・Skills携帯が必要 | ✅ 必要 | 専門性の分離 | | Web検索・外部情報取得 | ✅ 必要 | 非同期実行可能 | | アイデア出し・ブレスト | ✅ 必要 | 複数観点の並列生成 | | 仮説立案・検証 | ✅ 必要 | 独立した思考プロセス | | フィードバック・レビュー | ✅ 必要 | 客観的評価 | | 単なる評価軸チェック | ❌ 不要 | evaluation/*.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を参照して実行する:

- `.claude/skills/{skill-1}/`: {説明}
- `.claude/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を自動実行する。

Skills similaires