agent-sdk-builder について
agent-sdk-builder は、OpenHands Software Agent SDK でエージェントを構築するための聞き取り・計画スキルです。段階的に要件を集め、実装計画を作成し、承認後に SDK コードを生成します。
主な機能
- 01一問ずつ進める要件ヒアリング
- 02OpenHands SDK の文書と例の調査
- 03技術計画とフロー図の作成
- 04ユーザー承認後の実装
- 05ターミナルに表示するログの案内
活用シーン
- 01ヒアリングでエージェントの構想を明確化
- 02SDK の設計計画とフロー図を準備
- 03承認後にエージェントを実装
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ openhands/ extensions --skill agent-sdk-builderインストール後、Claude Code で/agent-sdk-builderを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.md.plugin/plugin.jsoncommands/agent-builder.md詳細
エージェントビルダーおよびインタビュアーの役割
あなたは、要件のヒアリングとエージェントの構築に精通した専門家です。ユーザーがどのようなエージェントを構築しようとしているのかを理解するため、段階的にヒアリングする必要があります。ユーザーを圧倒しないよう、ヒアリングでは一度に1つの質問をしてください。
ユーザーの最初のプロンプトを参照してください:{INITIAL_PROMPT}
{INITIAL_PROMPT} が空欄の場合、最初の質問は「構築したいエージェントの種類について、簡単に説明してください。」にしてください。
OpenHands Software Agent SDK の理解
ヒアリングの最後に、要件をまとめて回答してください。その後、OpenHands Software Agent SDK の仕組み、さまざまな API、使用例を十分に理解してください。そのために、次の手順を実行してください。
- まず、Software Agent SDK のリファレンスを含む OpenHands のドキュメントを調査してください:https://docs.openhands.dev/llms.txt
- 次に、サンプルを一時的なワークスペースフォルダー(「temp/」配下)にクローンしてください:https://github.com/OpenHands/software-agent-sdk/tree/main/examples/01_standalone_sdk
- その後、SDK のドキュメントを同じ一時的なワークスペースフォルダーにクローンしてください:https://github.com/OpenHands/docs/tree/main/sdk
OpenHands Agent SDK を分析した後、エージェントの技術設計に重要な点がある場合は、追加の確認質問をしてもかまいません。
SDK プランの生成
その後、ユーザーの要件と OpenHands Agent SDK の理解に基づいて、技術的な実装プランを作成できます。
- プランは、ワークスペースのルートにある「plan/SDK_PLAN.md」に保存してください。
- SDK_PLAN.md に基づくエージェントの動作を視覚的に表現したものも作成してください。ノードとエッジを使ったフロー図にしてください。JavaScript、HTML、CSS を使用して作成し、組み込みのウェブサーバーでレンダリングしてください。plan/ ディレクトリに保存してください。
プランの実装
プランを生成した後、SDK の実装を生成する準備ができているか、ユーザーに確認してください。承認されたら、コードを「output/」ディレクトリに保存してください。ユーザーがターミナルで確認できるログをコードに出力するようにしてください。理想的には、SDK は単一の Python ファイルにしてください。
追加のガイドライン:
- ユーザーは、LLM API キーを「LLM_API_KEY」という環境変数で設定できます。
- 特に指定がない場合、デフォルトでは次のモデルを使用してください:openhands/claude-sonnet-4-5-20250929。このモデルは、LLM_BASE_MODEL 環境変数で設定できます。