技能檔案

Agent Craft

Name: Agent Craft
Author: Gami19

Claude Code カスタムエージェント（.claude/agents/）の設計・生成を支援する。ユーザーの要件からエージェントのロール、ツール制限、モデル選択、システムプロンプトを構造化し、即座に使用可能な .md ファイルを出力する。 Use when user says「カスタムエージェントを作って」「サブエージェントを作成して」「エージェントを追加して」「コードレビュー用のエージェントが欲しい」「専用のエージェントを設計して」「エージェントチームのメンバーを作って」「subagent を作成して」「agent を作って」「Five Pillars で設計して」「マルチエージェント構成を選びたい」「推論戦略を選定して」。 Do NOT use for: Agent Skill の作成（→ skill-forge）、 MCP サーバーの設定（→ MCP ドキュメント参照）。

Gami190 星標2026年4月8日

職業
分類: 技術文檔

技能內容

Skill: Agent Craft（カスタムエージェントの設計・生成）

エージェントは「制約された専門家」— 何ができるかより何をさせないかを設計せよ

Instructions

ワークフロー内の位置

要件ヒアリング → [agent-craft] → .claude/agents/<name>.md
                    ↓
               エージェント設計
               ・ロール定義
               ・ツール制限
               ・モデル選択
               ・システムプロンプト

入力

入力	説明	例
目的・タスク	エージェントに実行させたい作業	「コードレビューを自動化したい」
スコープ

相關技能

Agent Craft | Skills Pool

技能檔案

Agent Craft

Gami190 星標2026年4月8日

職業
分類: 技術文檔

技能內容

Skill: Agent Craft（カスタムエージェントの設計・生成）

エージェントは「制約された専門家」— 何ができるかより何をさせないかを設計せよ

Instructions

ワークフロー内の位置

要件ヒアリング → [agent-craft] → .claude/agents/<name>.md
                    ↓
               エージェント設計
               ・ロール定義
               ・ツール制限
               ・モデル選択
               ・システムプロンプト

入力

入力	説明	例
目的・タスク	エージェントに実行させたい作業	「コードレビューを自動化したい」
スコープ

相關技能

出力	形式	説明
エージェント定義ファイル	`.md`（YAML frontmatter 付き）	`.claude/agents/` に配置可能なファイル
設計根拠	Markdown	アーキタイプ選定・ツール制限の理由
テスト計画	Markdown	発動/非発動/制限のテストケース

軸	質問	例
目的	何を達成するエージェントか？	コードの品質チェック
スコープ	何に対して作用するか？	TypeScript ファイルのみ
対象ユーザー	誰が使うか？	開発チーム全員
チーム	単体 or チームの一員か？	CI/CD パイプラインの一部
頻度	どのくらいの頻度で使うか？	PR ごとに実行

制約タイプ	確認内容
読み取り/書き込み	ファイル変更を許可するか？
Bash 実行	コマンド実行を許可するか？許可する場合どの範囲？
外部通信	WebFetch / WebSearch を許可するか？
コスト	高コストモデル（Opus）を使うか、低コスト（Haiku）で十分か？

アーキタイプ	役割	ツール傾向	典型的な用途
Inspector	読み取り分析	Read / Grep / Glob のみ	コードレビュー、セキュリティ監査、ドキュメント分析
Worker	実装・変更	全ツール	コード生成、リファクタリング、テスト作成
Coordinator	調整・委譲	Task + SendMessage	チームリーダー、ワークフロー管理
Specialist	特定ドメイン特化	ドメイン依存	DB 管理、インフラ構築、特定言語エキスパート
Guardian	品質ゲート	Read + Bash（テスト実行）	CI ゲート、品質チェック、コンプライアンス

ファイルを変更するか？
  ├─ No → Inspector or Guardian
  │    └─ テスト/ビルドを実行するか？
  │         ├─ Yes → Guardian
  │         └─ No → Inspector
  │
  └─ Yes → Worker, Coordinator, or Specialist
       └─ 他のエージェントに委譲するか？
            ├─ Yes → Coordinator
            └─ No → 特定ドメインに限定か？
                 ├─ Yes → Specialist
                 └─ No → Worker

Pillar	Inspector	Worker	Coordinator	Specialist	Guardian
P1: Profile	分析観点を絞った厳格なペルソナ	実装規約を埋め込んだ職人ペルソナ	リーダーシップスタイルを定義	ドメイン専門家のペルソナ	品質基準を体現する門番
P2: Actions	Read/Grep/Glob（最小）	全ツール or 拒否リスト	Task/SendMessage 中心	ドメイン固有ツール	Read + Bash（テスト実行）
P3: Knowledge	`@ファイル参照`で規約注入	`@ファイル参照`+ スキル連携	チームメンバー情報	RAG / 外部ナレッジベース連携	品質基準ドキュメント参照
P4: Reasoning	Direct / CoT（分析レポート）	Direct（実装は推論より実行）	CoT（タスク分割判断）	CoT / Self-consistency	CoT（Pass/Fail 判定根拠）
P5: Planning	不要（単発分析）	Sequential（実装→検証）	必須 — タスク分割・委譲計画	Sequential / Iterative	不要（チェックリスト駆動）

カテゴリ	ツール	用途
ファイル読み取り	Read, Glob, Grep	コード/ドキュメントの分析
ファイル書き込み	Edit, Write, NotebookEdit	コード/ドキュメントの変更
実行	Bash	コマンド実行、テスト、ビルド
Web	WebFetch, WebSearch	外部情報の取得
チーム	Task, SendMessage, TeamCreate	マルチエージェント連携
対話	AskUserQuestion	ユーザーへの質問
スキル	Skill	既存スキルの発動

# 許可リスト方式（推奨 — Inspector / Guardian 向け）
allowedTools:
  - Read
  - Glob
  - Grep

# 拒否リスト方式（Worker / Specialist 向け）
disallowedTools:
  - WebFetch
  - WebSearch
  - TaskCreate

アーキタイプ	推奨ツール構成
Inspector	`allowedTools: [Read, Glob, Grep]`
Worker	`disallowedTools: [WebFetch, WebSearch]` （書き込み許可）
Coordinator	`allowedTools: [Read, Glob, Grep, Task, SendMessage, AskUserQuestion]`
Specialist	ドメインに必要なツールのみ許可
Guardian	`allowedTools: [Read, Glob, Grep, Bash]`

条件	worktree 分離	理由
subagent がファイルを Edit/Write する	必須	メインエージェントとの競合を防止
複数 subagent が同じファイルを変更しうる	必須	マージコンフリクトの回避
subagent が Read/Grep のみ（Inspector）	不要	読み取り専用なら衝突しない
長時間の分析タスク	推奨	メインのコンテキストを圧迫しない

パターン	トポロジ	特徴	適用場面
Sequential Pipeline	Chain	エージェント間で順次処理を引き継ぐ	コード生成→テスト→レビューの段階的処理
Group Chat	Mesh	全エージェントが自由に対話	ブレスト、探索的リサーチ、創造的タスク
Hierarchical	Tree	階層的な指揮系統	大規模チーム、明確な責任分担
Behavior Trees (ABT)	Tree (nodes)	Selector/Sequence ノードで条件分岐	自律的ワークフロー、フォールバック制御
Siloed	Parallel	独立実行→結果マージ	独立サブタスクの並列処理

Coordinator パターン選定フロー:

サブタスク間に依存関係があるか？
├─ Yes → 順序が固定か？
│    ├─ Yes → Sequential Pipeline
│    └─ No → Hierarchical
└─ No → サブタスク数が多い（4+）か？
     ├─ Yes → Siloed（並列実行→マージ）
     └─ No → 創造性・探索が必要か？
          ├─ Yes → Group Chat
          └─ No → Sequential Pipeline

モデル	特徴	推奨用途
claude-opus-4-6	最高性能。複雑な推論	Coordinator、複雑な Specialist
claude-sonnet-4-6	バランス型。コスパ良好	Worker、Guardian
claude-haiku-4-5	高速・低コスト	Inspector、単純な繰り返しタスク

パラメータ	説明	デフォルト	設定例
model	使用モデル	親エージェントと同じ	`claude-haiku-4-5`
permissionMode	権限モード	`default`	`bypassPermissions`
maxTurns	最大ターン数	制限なし	`10`
background	バックグラウンド実行	`false`	`true`
isolation	ワークツリー分離	なし	`worktree`

モード	説明	推奨場面
`default`	各ツール実行時にユーザー確認	初期テスト時
`acceptEdits`	ファイル編集は自動承認	Worker
`bypassPermissions`	全ツール自動承認	CI/CD パイプライン
`plan`	プラン承認が必要	影響範囲が大きい変更

推論戦略	説明	正確性	レイテンシ
Direct / Few-shot	単発 Q&A、または入出力例で誘導	低-中	最小-小
CoT / Zero-shot CoT	ステップバイステップ推論（例示あり/なし）	中-高	中
Self-consistency	複数回生成→多数決で最良解を選定	最高	大
Tree-of-Thought (ToT)	複数パス探索→評価→最適解選定	最高	最大

単純で事実ベース？ → Yes → Direct / Few-shot
                  → No → ステップ思考が必要？ → Yes → 正確性最重要？ → Yes → Self-consistency / ToT
                                                                    → No  → CoT / Zero-shot CoT
                                              → No  → Direct / Zero-shot

# <Agent Name>

## Role
<1-2文でエージェントの役割を定義>

## Scope
- 対象: <対象範囲>
- 除外: <対応しない範囲>

## Instructions
1. <手順1>
2. <手順2>
3. <手順3>

## Output Format
<出力の形式と構造>

## Constraints
- <制約1>
- <制約2>

原則	説明
簡潔性	500 語以内を推奨。長いプロンプトはコンテキストを圧迫する
具体性	「良いコードを書け」ではなく「ESLint ルールに従い...」
出力形式の指定	何をどの形式で出力するかを明示
スコープの明示	やること・やらないことを明確に
例の提供	1-2 個の入出力例を含める（大きすぎない範囲で）
自動委譲の促進	プロンプトに「use subagents for heavy research」を含めると、エージェントが重い調査を subagent に自動委譲し、メインのコンテキストウィンドウを clean に保つ

原則	説明
重い調査は subagent に委譲	ファイル探索・コード検索など大量の結果を返す操作は subagent で実行し、要約だけメインに返す
`@ファイル参照` の活用	`@path/to/file` でコンテキストに必要なファイルを効率的に注入する
中間結果のファイル保存	長い分析結果はファイルに書き出し、必要時に Read で参照する
maxTurns でガードレール	長時間タスクでも maxTurns を設定し、中間報告を強制する

パターン	問題	改善
「最善を尽くして」	曖昧すぎる	具体的な基準を記述
1000 語以上のプロンプト	コンテキスト消費	核心だけに絞る
ツール使い方の説明	冗長（モデルは知っている）	ツール利用の制約のみ
「エラーが起きたら...」の網羅	想定しすぎ	主要なケースのみ

#	Agent Slop パターン	検出サイン	対策
AS-1	Role が "helpful assistant" テンプレ	「〇〇の専門家として」「〇〇を支援する」の定型句で始まる	ドメイン固有の比喩で役割を定義する（例: 「TypeScript の型システムを盾として守る門番」「SQL クエリの外科医」）
AS-2	Constraints が汎用的	「ファイル変更不可」「破壊的コマンド禁止」等のアーキタイプデフォルトのみ	タスク固有の禁止事項を追加する（例: 「DELETE/DROP 文は WHERE 句なしで実行不可」「本番 DB への直接接続禁止」）
AS-3	Instructions が「分析→評価→報告」の3ステップ	ドメインに関わらず同じフローになっている	ドメイン固有のワークフローを反映する（例: セキュリティ監査なら「OWASP Top 10 の各項目をスキャン→脆弱性の CVSS スコアを算出→修正優先度を判定」）
AS-4	Output Format が "構造化して報告"	出力の具体的な構造（セクション・フィールド・フォーマット）が定義されていない	出力テンプレートを Markdown で明示する（ヘッダー、テーブル構造、必須フィールドを具体的に記述）
AS-5	Domain Knowledge が空	Specialist タイプなのにドメイン固有の判断基準・ベストプラクティスがプロンプトに含まれない	3-5 個のドメインルールを直接プロンプトに埋め込む（例: 「N+1 クエリは常に警告」「循環参照は Critical」）
AS-6	入出力例がない	プロンプトに具体的な入出力例が1つもない	最低 1 つの入出力例をプロンプトに含める。例は短くてよいが具体的であること
AS-7	ツール構成がアーキタイプデフォルトそのまま	Inspector なら [Read, Glob, Grep]、Worker なら全ツール、のテンプレ通り	タスクに応じて微調整する（例: ログ分析 Inspector なら Bash も許可してログファイルの tail を実行可能にする）
AS-8	「人格」がない	同じアーキタイプの別エージェントと入れ替えても区別がつかない	エージェント固有の「スタンス」を1文で定義する（例: 「常に最悪のケースを想定して報告する悲観主義者」「パフォーマンスを1ms でも改善する執念の持ち主」）

---

Agent Craft

Skill: Agent Craft（カスタムエージェントの設計・生成）

Instructions

ワークフロー内の位置

入力

Agent Craft

Skill: Agent Craft（カスタムエージェントの設計・生成）

Instructions

ワークフロー内の位置

入力

出力

Step 1: 要件ヒアリング

5 軸の確認

制約の特定

Step 2: エージェントタイプの決定

5 アーキタイプ

選定基準

アーキタイプ別テンプレート

Five Pillars による設計軸（AI Agents in Action）

Step 3: ツールアクセスの設計

ツールカテゴリ

ツール制限の書き方

最小権限の設計パターン

Worktree 分離の判断基準

マルチエージェント協調パターン

Step 4: モデルと動作設定の決定

モデル選択

動作設定

permissionMode の選択

Step 5: システムプロンプトの作成

5a. 推論戦略の選定

プロンプト構成（推奨テンプレート）

プロンプト設計の原則

コンテキストウィンドウの衛生管理

避けるべきパターン

5b. Agent Slop 防止チェック（Distributional Convergence 対策）

Step 6: ファイル生成と配置

6a. ファイル形式

My Workflow

Create Instructions

Init

Everything Claude Code Conventions

Codebase Onboarding

Ui Demo