mcpField
S
solo

solo

github.com/scottwaterエージェントワークフロー137 回インストール6 日前に更新
リポジトリ

solo について

Soloは、コーディングエージェントとプロジェクト単位の協調状態を管理するデスクトップアプリで、MCPサーバー経由で利用します。このスキルでは、エージェントへのタスク割り当てや監視、スクラッチパッドやTODOなどの管理方法を説明します。

主な機能

  1. 01コーディングエージェントとプロセスの管理
  2. 02エージェントタスクの割り当てと監視
  3. 03プロジェクト用スクラッチパッドの読み書き
  4. 04TODOの管理
  5. 05任意のタイマー・キー値ツールの確認

活用シーン

  1. 01複数のエージェントにプロジェクト作業を委任
  2. 02エージェントからの質問や権限要求を確認
  3. 03プロジェクトの協調情報を記録
  4. 04TODOを追跡

MCP 対応

SoloはMCPサーバー経由でのみ利用でき、クライアントからプロジェクト、プロセス、エージェント管理用ツールを呼び出せます。スクラッチパッド、TODO、タイマー、キー値ストレージの任意ツールは設定で制御されます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/scottwater/skills --skill solo

インストール後、Claude Code で/soloを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Solo

Solo は、コーディングエージェントとプロジェクト単位の調整状態を管理するデスクトップアプリケーションです。Solo を利用できるのは MCP サーバー経由のみです。Solo CLI はありません。

Pi の動作

PI_CODING_AGENT=true によって Pi の実行環境だと検出された場合は、Solo MCP サーバーの機能に pi-soloterm 拡張機能のツールを使用します。

  • solo_status — SoloTerm/MCP の利用可否、ID、機能サポートを確認します。
  • solo_task — Solo が管理するコーディングエージェント／プロセスを起動し、プロンプトを送信します。並列作業では、tasks: [...] を指定して 1 回の呼び出しで実行します。
  • solo_scratchpad — Solo のスクラッチパッドを一覧表示、読み取り、書き込みします。
  • solo_todo — Pi のセッションをフォールバックとして利用し、利用可能な場合は Solo の ToDo を管理します。

最初に solo_status を呼び出します。準備完了と報告されたら、該当する solo_* ツールを使用します。これらのツールは Pi 上で Solo MCP を完全にサポートするものであり、pi-soloterm はそのブリッジです。

必要な solo_* ツールが見つからない場合は、ユーザーに pi-soloterm のインストール／有効化を案内してください。solo_status が Solo MCP を利用できないと報告した場合は、Solo を起動して Settings → MCP を有効にするようユーザーに案内してください。

Pi 以外の動作

Pi の実行環境でない場合は、現在のハーネスの Solo MCP ツールを直接使用します。正確なツール名が不明な場合は、MCP ツールカタログを確認します。

機能ツール

Solo は、コアのプロジェクト／プロセス管理に加えて、スクラッチパッド、ToDo、タイマー、キーと値のストレージといった任意の機能ツールを提供します。これらの機能は Solo の設定によって制御されます。スクラッチパッド、ToDo、タイマーは通常、MCP サーバーの有効化設定を引き継ぎます。キーと値のツールは個別に有効化が必要な場合があります。正確なツール名は MCP カタログで確認してください。

起動したエージェント

新しいエージェントを起動したら、質問や権限リクエストがないか監視し、与えたプロンプトの完了に必要なリクエストのみ承認してください。

ユーザーが別のエージェントを指定していない限り、現在のプロセスの起動に使われたものと同じ名前のエージェントツールでワーカーを起動します。次のセクションで説明する方法で特定してください。

単純なタスクの場合は例外として、1 段階下のエージェントを使用します。現在のプロセスが fable エージェントで動作している場合は、単純なタスクのワーカーを sol で起動します。sol で動作している場合は、terra を使用します。単純なタスクとは、対象が限定され、結果を検証できる機械的な作業を指します。ファイルやシンボルの特定、単発のコマンドを実行して出力を報告する作業、単一の文書の取得や要約などが該当します。判断を要する作業、たとえばコードの作成やレビュー、デバッグ、複数段階の調査などは実質的な作業であり、現在のプロセスのエージェントツールを使用します。

スキル委任のためのエージェントのディスパッチ

別のスキル（レビュークォーラムなど）がワーカーエージェントを Solo 経由で割り当てる場合は、実行を確定する前に利用可能か確認してください。solo_status（Pi）または whoami（直接 MCP）でプローブします。ツールが表示されているだけでは証明になりません。プローブによって、このプロセスが Solo によって管理され、エージェントの起動が利用可能だと確認できた場合にのみ進めてください。プローブに失敗するか、エージェントの起動が利用できない場合は、ディスパッチせず、その旨を委任元のワークフローに報告してください。

起動するワーカーは、同じハーネスであるだけでなく、現在のプロセスの起動に使われたものと同じ名前付きエージェントツールで実行する必要があります。複数の名前付きエージェントツールが、異なる設定フラグ、モデル、引数を指定しながら、同じハーネスをラップしている場合があります。また、汎用のデフォルトはハーネスの種類だけで解決されるため、それに頼ると、別のエージェントにワーカーがひそかにディスパッチされる可能性があります。

ディスパッチする前に、現在のプロセスに設定されているエージェントツールを特定してください。Pi では、solo_status のプロセス ID を使って solo_process status を実行し、そのプロセス名と起動コマンドを、solo_status が報告する有効なエージェントツールと照合します。正確にツール名が一致する場合にのみ、確かな一致として扱ってください。各 solo_task には、そのツールを agentTool として明示的に渡します。選択したエージェントツールですでに定義されている場合は、model や thinking を個別に上書きしないでください。直接 MCP の場合は、whoami が返す同等のエージェントツール ID を使い、起動のたびに明示的に渡してください。現在のプロセスを有効なツールに明確に対応付けられない場合は、停止して、使用する有効なエージェントツールをユーザーに確認してください。

委任元のスキルが独自の受け入れレイヤーを提供する場合は、各 solo_task に acceptance: "none" を渡して、Solo の受け入れゲートを無効にしてください。

コメント

Markdown 対応