subagents について
DevSpace subagentsは、DevSpace CLIを通じて範囲の明確な作業をエージェントに委任するスキルです。対象の検索、依頼、待機、確認、継続を扱います。
主な機能
- 01エージェントの対象を検索
- 02作業概要を添えてエージェントを起動
- 03作業の完了待ちや状況確認
- 04関連するエージェント作業を継続
活用シーン
- 01範囲を絞ったコードレビューの委任
- 02独立した実装作業の依頼
- 03変更後の検証作業の依頼
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ waishnav/ devspace --skill subagentsインストール後、Claude Code で/subagentsを入力して読み込まれたか確認します。
詳細
DevSpace サブエージェント
サブエージェントは任意です。通常の作業には通常のワークスペースツールを使用し、独立したコンテキスト、専門性、またはフォローアップによって別の作業者が大きく役立つ場合にのみ委任してください。
サブエージェントが使用するプロジェクトから、シェルまたはプロセスツールを通じて DevSpace CLI を実行してください。エージェントコマンドは、既定で簡潔な XML フラグメントを出力します。その出力を直接読んでください。--json は追加しないでください。
対象を選択する
名前を推測せず、利用可能な対象を検出してください。
devspace agents targets
各行は、<provider name="..."/> または <profile name="..." provider="...">description</profile> フラグメントです。<profile-or-provider> には、プロファイルまたはプロバイダーの name を渡してください。一致するプロファイルを優先してください。適合するプロファイルがない場合、またはタスクで特定のプロバイダーが必要な場合は、プロバイダー対象を使用してください。タスクで対応済みの上書きが必要な場合を除き、設定済みのモデルと推論レベルを維持してください。
作業を開始する
目的、関連するパス、制約、推測できない背景情報、期待する結果を含めた、自己完結した概要をサブエージェントに伝えてください。エージェントが受け取るのはこの概要とプロファイルの指示であり、親との会話ではありません。
devspace agents run <profile-or-provider> "<brief>"
devspace agents run <profile-or-provider> --model <model> --effort <effort> "<brief>"
このコマンドは、<agent id="agt_..." status="running"/> という受領通知を返します。確認、待機、フォローアップに使えるよう、DevSpace エージェント ID を控えてください。
待機または確認する
先に作業を完了させる必要がある場合は、wait を使用してください。1 回の呼び出しで複数のエージェントを待機できます。
devspace agents wait <id>
devspace agents wait <id> <id> <id>
devspace agents wait <id> <id> --timeout 60
--timeout を指定しない場合、指定したすべてのエージェントの現在の作業が完了するまでコマンドは待機します。タイムアウトすると、一意のエージェントごとに初回の出現順で 1 つのフラグメントが返されます。作業が未完了の場合は、status="running" wait="timeout" となります。完了時の出力は要素のテキストです。失敗時には code と retryable 属性が含まれます。コマンドは途中の結果をストリーミングしません。
すぐに状況を確認するには show を使用してください。wait で依存関係を表現できる場合は、繰り返し確認しないでください。
devspace agents show <id>
devspace agents ls
ls は現在のプロジェクトのエージェントを一覧表示します。targets と ls の結果が空の場合、何も出力されません。
関連する作業を続ける
既存のプロバイダーコンテキストが役立つ場合は、エージェントを続行してください。関連しない作業には、別のエージェントを開始してください。
devspace agents continue <id> "<follow-up brief>"
devspace agents wait <id>
効果的な用途
- 変更の正確性、セキュリティ、またはテスト漏れをレビューする。
- コードベースの範囲を限定した部分を調査し、結果を報告する。
- 明確な受け入れ基準のある、独立した変更を 1 つ実装する。
- 他の作業の後に、対象を絞った検証を行う。