agent-creator

モード：スクリプト優先 - 生成と検証の標準パスとして scripts/main.cjs を使用し、その後、このガイドに従って調査、スキルの割り当て、統合の仕上げを行います。

エージェント作成スキル

適切な担当者がまだいない機能に対応する、特化型 AI エージェントを必要に応じて作成します。

このスキルが呼び出されるタイミング

1. ルーターが適切な既存エージェントを見つけられない場合。
2. ユーザーが新しいエージェントを明示的に求めた場合。
3. 単発のタスクではなく、継続的に対応するスペシャリストが必要な機能上の不足がある場合。

参考ドキュメント

• 職業との適合性の詳細 - 保存されたルーターのメモ、トリガーのガイダンス、関連エージェントの確認、ドメイン調査、職業との適合性に関する情報の取得方法を記載しています。
• 調査とスキルギャップの詳細 - 保存されたキーワード調査、スキルの発見、設定に関するメモ、テンプレート契約の完全なリファレンスを記載しています。
• 統合リファレンス - 保存された検証、ルーティングテーブル、レジストリ、メモリ、README、エコシステム統合のガイダンスを記載しています。
• 例と評価 - 保存されたワークフロー統合のメモ、エコシステム適合性の契約、例、アサーション、任意の評価用追加項目を記載しています。

クイックリファレンス

| 操作 | 主なコマンドまたはツール | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------- | --------------- | | 既存のエージェントを確認 | Glob: .claude/agents/**/*.md | | 管理対象テンプレートを生成 | node .claude/skills/agent-creator/scripts/main.cjs --action generate --name <agent-name> --description "<summary>" --category <core | domain | specialized | orchestrators> | | 管理対象テンプレートを検証 | node .claude/skills/agent-creator/scripts/main.cjs --action validate --file .claude/agents/<category>/<agent-name>.md | | 役割を調査 | 職業との適合性の詳細および調査とスキルギャップの詳細に従います | | 最終統合 | 統合リファレンスに従います |

作成の基本ワークフロー

ステップ 0：存在確認とアップデーターへの委任

エージェントファイルを作成する前に、対象がすでに存在するか確認します。

test -f .claude/agents/<category>/<agent-name>.md && echo "EXISTS" || echo "NEW"

• エージェントが存在する場合は、作成を中止し、リクエストを artifact-updater に振り分けます。
• エージェントが新規の場合は、ステップ 0.1 に進みます。
• 管理対象テンプレートのパスを適用できる場合は、手作業で新しいエージェントの Markdown ファイルを作成しないでください。

ステップ 0.1：類似項目のスマート検出

新しい成果物を作成する前に、類似項目の検出ツールを実行します。

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: 'agent',
  name: proposedName,
  description: proposedDescription,
  keywords: proposedKeywords || [],
});

結果はこれまでどおり正確に処理します。

• EXACT_MATCH -> 中止し、agent-updater に振り分けます
• REGISTRY_MATCH -> 作成前にレジストリの差異を確認します
• SIMILAR_FOUND -> 候補を確認し、新規作成するか更新するかを判断します
• NO_MATCH -> ステップ 0.5 に進みます

ステップ 0.5：関連項目の確認

続行する前に、.claude/lib/creators/companion-check.cjs の checkCompanions("agent", "{agent-name}") を実行します。不足している関連成果物を記録し、作成後のフォローアップに引き継ぎます。

ステップ 1：ニーズに適合する既存エージェントがないことを確認

続行する前に、.claude/agents/**/*.md と周辺ディレクトリを検索します。既存のコア、特化型、ドメイン、またはオーケストレーターエージェントがすでにニーズに適合している場合は、重複するスペシャリストを作成せず、そのエージェントを使用します。

ステップ 2：ドメインを調査する

エージェントの契約を確定する前に、維持されている調査フローを完了してください。

• 元の BLS／Ongig／MyMajors の調査と隣接する職種に関するガイダンスには、職業との適合性の詳細を使用してください。
• キーワード調査、スキルギャップ分析、補完スキルの特定には、調査とスキルギャップの詳細を使用してください。

ステップ 3：割り当てる関連スキルを見つける

新しいエージェントには、意図的に選定したスキルセットが必要です。

1. 既存のスキルカタログを確認します。
2. 主要スキル、補完スキル、オンデマンドスキルを特定します。
3. 再利用可能なスキルの不足は、別の作成者をこのワークフロー内で呼び出すのではなく、適切な作成者／更新者向けの Follow-Up 項目として記録します。
4. 割り当てたスキルをフロントマターとワークフローのステップ 0 の読み込み順序に含めます。
5. 検索指向のスキルとタスク管理スキルを既存の規約に沿わせます。

ステップ 4：エージェントの設定を決める

生成前に、エージェントのアーキタイプ、カテゴリ、モデルを決定します。

エージェントの種類	用途	モデル
Worker	タスクを直接実行します	sonnet
Analyst	調査、レビュー、評価を中心に行います	sonnet
Specialist	深いドメイン専門知識を持ちます	opus
Advisor	戦略的なガイダンスやコンサルティングを行います	opus

役割に合った出力ディレクトリ（core、specialized、domain、orchestrators）を選択します。

ステップ 5：エージェント定義を生成する

契約優先のジェネレーターを使用し、手動で調整する前に出力を検証します。

node .claude/skills/agent-creator/scripts/main.cjs --action generate --name <agent-name> --description "<summary>" --category <core|domain|specialized|orchestrators>
node .claude/skills/agent-creator/scripts/main.cjs --action validate --file .claude/agents/<category>/<agent-name>.md

調査とスキルギャップの詳細に記載されたテンプレートの詳細では、引き続き、必須の skills: 配列、ステップ 0 のスキル読み込み、遅延読み込みパスの使用、フック／ワークフローの表、応答方針、行動特性、例が定義されています。

テンプレートの参照

次の最小限のフロントマターとワークフローの契約を維持してください。

---
name: agent-name
description: What the agent does and when to use it
tools: [Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch, TaskUpdate, TaskList, TaskCreate, TaskGet, Skill]
model: sonnet
context_strategy: lazy_load
skills:
  - task-management-protocol
  - code-semantic-search
context_files:
  - @.claude/context/memory/learnings.md
---

また、生成した本文を次のセクションに沿わせてください。

• ## Enforcement Hooks
• ## Related Workflows
• ## Core Persona
• ## Workflow と ### Step 0: Load Skills (FIRST)
• ## Response Approach
• ## Behavioral Traits
• ## Example Interactions
• ## Task Progress Protocol と ## Memory Protocol

作成後のチェックリスト

• 存在確認と重複チェックを完了しました。
• 職業との適合性、キーワード調査、スキルギャップのレビューを記録しました。
• エージェントを scripts/main.cjs で生成し、--action validate で検証しました。
• 必須のフロントマター項目、スキル、遅延読み込みの参照が含まれています。
• @AGENT_ROUTING_TABLE.md と必要なルーティングキーワードを更新しました。
• node .claude/tools/cli/validate-integration.cjs .claude/agents/<category>/<agent-name>.md が成功します。
• エージェントが新規作成された場合、または大幅に変更された場合は、node .claude/tools/cli/generate-agent-registry.cjs を実行しました。
• ツールのデフォルト設定が必要な場合は、.claude/config/agent-config.json を更新しました。
• 新規エージェントまたは再登録したエージェントについて、npm run gen:all-registries を実行しました。
• README の対象範囲に関する更新、メモリのメモ、統合に関するフォローアップを記録しました。

エコシステム整合性の契約（必須）

この作成者スキルは、新規または更新されたエージェントを、他の作成者エコシステムと整合させる必要があります。

• 再利用可能な機能と割り当てには skill-creator
• 実行可能な自動化の仕組みには tool-creator
• ガードレールと適用には hook-creator
• スキャフォールドの再利用には template-creator
• オーケストレーションとフェーズの制御には workflow-creator
• オペレーター向けのエントリーポイントには command-creator

クリエイター間の引き継ぎ（必須）

引き継ぎの前に、関連するエコシステムの更新を確認してください。

1. ルートがルーティングドキュメントとレジストリで見つけられる状態になっていること。
2. 関連するスキル、ツール、フック、テンプレート、ワークフローが作成されているか、明示的に対象外とされていること。
3. validate-integration.cjs が、影響を受けるエージェント成果物に対して成功すること。
4. メタデータが変更された場合、レジストリとインデックスが再生成されていること。
5. 対応を先送りするだけで済ませず、残った課題を記録していること。

調査ゲート（Exa と arXiv — 両方必須）

新しいエージェントのパターン、役割の設計、オーケストレーションモデル、評価フローについては、次の手順を実施してください。

1. Exa を使って、現在の実装パターンとエコシステムの慣習を確認してください。
2. AI エージェント、評価、オーケストレーション、メモリ／RAG、セキュリティに関わるテーマでは、arXiv で関連する研究を検索してください。
3. 最終的なエージェントの契約を形作った判断、制約、対象外事項を記録してください。
4. 推測に基づいて拡張するのではなく、最小限の変更を検証したうえで適用してください。

リグレッションを防ぐデリバリー

• 動作を変更する場合は、RED -> GREEN -> REFACTOR に従ってください。
• 変更したエージェントとクリエイターの領域に対して、対象を絞ったテストを実行してください。
• 引き継ぎの前に、必須のフォーマットおよび検証コマンドを実行してください。
• 無関係なクリーンアップをまとめて行わず、失敗している契約に変更範囲を絞ってください。

メモ

• 保持された詳細な Step 6-14 のガイダンスについては、統合リファレンスを使用してください。
• エージェントが再利用可能なスキルの作業を見つけた場合は、skill-creator に直接つなぐのではなく、次のクリエイターワークフロー向けのフォローアップとして記録してください。
• 保持された例、オーケストレーターの同期に関するメモ、任意の評価資料については、例と評価を使用してください。