サブエージェント：クロード・コードのAIサブエージェントを追加・管理するツール

サブエージェントは、Anthropicのクロードコード開発環境を強化するために設計されたコマンドラインインターフェース（CLI）ツールです。 開発者は、特定のプログラミングタスクに特化したAI「サブエージェント」を簡単に追加、管理、作成することができます。 これらのサブエージェントは、コードレビュー、テスト、デバッグ、ドキュメンテーション、API開発など、それぞれ1つの分野に精通した事前設定済みのAIアシスタントです。 このツールの核となるコンセプトは「エキスパート・ブレンディング」であり、1つの汎用AIにすべてを任せるのではなく、高度に専門化された複数のエージェントを協力して使用することである。 この利点は、各エージェントが独自のシステム・プロンプトと専門化されたツールセットを持つ孤立したコンテキストで動作することで、タスクの精度と効率を向上させ、汎用AIが複雑なタスクに取り組む際に発生する可能性のある「幻覚」を軽減することである。 サブエージェントは、すぐに使えるプロフェッショナルエージェントと、カスタムエージェントを作成する柔軟性を提供することで、開発ワークフローを簡素化し、自動化するように設計されています。

機能一覧

• 専門AIエージェント各エージェントは、特定の開発分野のエキスパートです。
• ゼロ・コンフィギュレーション使用ビルド済みのエージェントは、追加設定なしですぐに動作します。
• 高さはカスタマイズ可能開発者は、特定のワークフローのニーズを満たすカスタムエージェントを作成することができます。
• インテリジェント・コンテキスト・マネジメント各エージェントは独立したコンテキストで実行され、異なるタスク間の干渉を回避します。
• Context-Forgeとの統合とシームレスに統合できる。context-forgeプロジェクトとそのPRP（Project Relationship Planning）文書は併用される。
• コマンドラインインタフェースエージェントのインストール、初期化、リスト表示、有効化/無効化、削除は簡単なコマンドで行えます。
• 独立した代理執行クロードコード環境から独立したエージェントの実行をサポートし、自動化とスクリプト作成を容易にします。
• ウェブダッシュボードエージェントのステータス、タスク履歴、パフォーマンスメトリクスのリアルタイムモニタリングと管理のためのウェブインターフェースを提供します。
• フックシステムワークフローの自動化のために、特定のイベント（ドキュメントの編集やタスクの完了など）に応じて自動的にトリガーされるアクションを定義できます。
• つの設置範囲ユーザー全体（すべてのプロジェクトで利用可能）とプロジェクト全体（現在のプロジェクトでのみ利用可能）のエージェントインストールをサポート。

ヘルプの使用

サブエージェントは、クロード・コードを様々な特殊なAIサブエージェントで強化するために設計された強力なコマンドラインツールです。以下に、このツールのインストール方法と使用方法、主な機能の操作方法について詳しく説明します。

設置プロセス

サブエージェントはいくつかの方法でインストールできますが、最も推奨される方法はNPMを使用することです。

1.NPMのインストール（推奨）
ターミナルを開き、グローバル・インストールのために以下のコマンドを実行する：

npm install -g @webdevtoday/claude-agents

2.糸の取り付け
Yarnを使いたい場合は、以下のコマンドを使うことができる：

yarn global add @webdevtoday/claude-agents```
**3. 从源码安装**
你也可以直接从GitHub克隆源码进行安装，这适用于希望进行二次开发的用户：
```bash
git clone https://github.com/webdevtodayjason/sub-agents.git
cd sub-agents
npm install
npm link

設置完了後claude-agentsコマンドがターミナルで利用できるようになる。

はじめに

インストールに成功したらinitコマンドクイックスタート。

新規プロジェクトの場合：
プロジェクトのルート・ディレクトリで以下のコマンドを実行し、利用可能なすべてのエージェントを初期化します：

claude-agents init

そしてlistコマンドで利用可能なプロキシをすべて表示することができる：

claude-agents list

すでにContext-Forgeを使用しているプロジェクトの場合：
プロジェクトがすでにcontext-forge特別なinitコマンドで互換性を確保する：

claude-agents init --respect-context-forge

このコマンドは、プロキシコマンドをインテリジェントに.claude/commands/agents/ディレクトリを更新し、既存のコマンドとの衝突を避ける。CLAUDE.mdドキュメンテーション

主な機能

1.代理店管理
サブエージェントは、エージェントのライフサイクルを管理するためのコマンド一式を提供します。

• インストレーション・エージェント1つまたは複数のエージェントをインタラクティブにインストールできます。

  claude-agents install
  

  または、利用可能なすべてのエージェントを一度にインストールする：

  claude-agents install --all
  

• ビューエージェントインストールされているすべてのエージェントを一覧表示します。

  claude-agents list --installed
  

• プロキシの有効/無効エージェントはいつでも有効または無効にできます。

  claude-agents disable test-runner
  claude-agents enable test-runner
  

• プロキシを削除する不要になったエージェントを削除する。

  claude-agents remove debugger
  ```    或者进行批量卸载并清理相关文件：
  ```bash
  claude-agents uninstall --all --clean
  

2.クロード・コードにおけるプロキシの使用
クロードコードでプロキシを呼び出すには、主に2つの方法があります：

• スラッシュコマンド各エージェントは、素早く呼び出せるようにスラッシュ・コマンドに関連付けられています。例えば、コードレビューエージェントを呼び出すには、次のように入力します：

  /review
  ```    对于需要参数的代理，可以在命令后附带参数：
  

  /ログイン問題のデバッグ

• タスクツールを使うこともできる。Taskより複雑な命令を実行するためのツール。

  Task("project-planner: analyze all PRPs and create sprint plan")
  

3.スタンドアロン・オペレーティング・エージェント
これは非常に強力な機能で、クロードコードを開くことなく、オートメーションスクリプトやワークフローでエージェントを直接使用することができます。

# 使用内联任务运行
claude-agents run marketing-writer --task "Write launch announcement for v2.0"
# 从文件读取任务
claude-agents run api-developer --file api-spec.md
# 以交互模式运行
claude-agents run tdd-specialist --interactive```
**4. 创建自定义代理**
如果预设的代理不能满足你的需求，你可以轻松创建自己的代理。
运行以下命令，工具会通过交互式问答引导你完成创建过程：
```bash
claude-agents create

エージェントの名前と説明、必要なツールを定義するよう求められます。これにより、高度にカスタマイズされたAIアシスタントを非常に簡単に作成することができます。

5.ウェブダッシュボードの使用
より直感的にエージェントを管理・モニターするために、サブエージェントはウェブダッシュボードを提供しています。
ダッシュボードをアクティブにする：

claude-agents dashboard

ポート番号を指定することもできる：

claude-agents dashboard --port 8080

ダッシュボードでは、すべてのエージェントのリアルタイムのステータス、タスク実行履歴、パフォーマンスメトリクスを確認し、迅速にアクションを実行することができます。

以上の手順で、サブエージェントを使いこなせるようになり、開発の生産性を高めることができます。このツールは、大規模な開発タスクを異なる分野のAIエキスパートに分割することで、コード生成、レビュー、テストの品質とスピードを劇的に向上させる。

アプリケーションシナリオ

1. 自動コードレビュー
   開発者はcode-reviewer新しく提出されたコードの品質、セキュリティ、パフォーマンスを総合的に分析するエージェント。このエージェントは、コードがベストプラクティスに従っているかどうかを自動的にチェックし、具体的な最適化を提案するため、手作業によるレビューの負担が軽減されます。
2. デバッグとバグ修正の支援
   複雑なバグに遭遇したらdebuggerエージェント。エラーメッセージやスタックトレースを提供すると、エージェントは問題の根本原因を分析し、問題の解決を早めるための修正を提供しようとします。
3. ラピッドプロトタイピング
   プロジェクトの初期段階では、アプリケーションのプロトタイプを素早く作成するために、複数のエージェントを組み合わせて使用することができます。例えばproject-plannerプランニング機能モジュール。api-developerバックエンドのインターフェースを生成する。frontend-developerフロントエンドのインターフェイスを構築することで、コンセプトからプロトタイプまでの時間を劇的に短縮できる。
4. 技術文書の作成と更新
   ドキュメントの作成と維持は、時間のかかる作業です。doc-writer歌で応えるapi-documenterエージェントは、コードとコメントに基づいて、READMEファイル、APIドキュメント（OpenAPI仕様書など）などを自動的に生成し、更新することができます。
5. テスト駆動開発（TDD）
   tdd-specialistエージェントは、開発者がテスト駆動開発を実践するのに役立ちます。機能的なコードを書く前に、エージェントに要求に基づいてテストケースを作成させることができます。

品質保証

1. サブエージェントとクロード・コードを直接使うことの違いは何ですか？
   サブエージェントはクロード・コードに取って代わるものではなく、それを強化するものだ。クロード・コードは、「特化したサブ・エージェント」という概念を導入することで、単一の汎用AIではすべての分野に秀でることができないという問題を解決している。各サブエージェントは、隔離された環境で、コードレビューやデバッグなど特定のタスクに集中することで、結果をより正確にし、異なるタスク間の文脈上の混乱を回避する。
2. 各エージェントに個別に料金を支払う必要がありますか？
   サブエージェント自体は無料のオープンソースツールです。しかし、そのタスクを実行するためにクロードコードに依存しているため、Anthropicのクロードコードにアクセスし、その使用量に応じて支払う必要があります。複数のサブエージェントを使用すると、トークンの消費量が増える可能性があります。
3. カスタムプロキシーの作成は複雑ですか？
   簡単。インタラクティブなコマンドラインツールclaude-agents createエージェントの名前、機能説明、必要なツールの定義を含む作成プロセスをガイドします。複雑なコードを書くことなく、エージェントの責任を自然言語で記述するだけです。
4. これらのエージェントは一緒に働くことができるのか？
   はい。このツールは、複数のエージェントが一緒に働くことを想定して設計されています。 フックシステムを使用すると、あるエージェントがタスクを完了したときに、別のエージェントをトリガーする自動化ルールを設定することができます。例えば、コード編集が完了すると、自動的にtest-runnerエージェントがテストを実行する。
5. グローバルにエージェントをインストールした場合、すべてのプロジェクトに影響しますか？
   はい。エージェントは2つの異なるスコープにインストールできます。~/.claude/agents/)とプロジェクト・スコープ(.claude/agents/).ユーザスコープにインストールされたエージェントは、すべてのプロジェクトで利用できます。エージェントを特定のプロジェクトでのみ使用したい場合は--projectフラグをプロジェクトスコープにインストールする。