agent-sdk-development について
TypeScript と Python の Claude Agent SDK を扱う、ドキュメント委譲型スキルです。docs-management を通じて公式ドキュメントを参照し、セットアップ、セッション、ツール、権限、出力、デプロイを扱います。
主な機能
- 01公式ドキュメントへの問い合わせ委譲
- 02SDK トピック別のキーワード一覧
- 03TypeScript と Python SDK の対象範囲
- 04セッションとカスタムツールのガイド
- 05MCP、プラグイン、ホスティングの参照
活用シーン
- 01SDK セットアップの公式情報の検索
- 02セッション管理や権限の確認
- 03カスタムツールや構造化出力の設計
- 04MCP 統合や本番ホスティングの調査
MCP 対応
Claude Agent SDK の MCP サーバー統合に関する公式ドキュメントを案内しますが、このスキル自体は MCP ツールを公開しません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/agent-sdk-developmentを入力して読み込まれたか確認します。
同梱ファイルreferences/testing-and-notes.md
詳細
Agent SDK メタスキル
🚨 必須：最初に docs-management を呼び出してください
停止 — Claude Agent SDK に関する回答をする前に、必ず以下を実行してください：
docs-managementスキルを呼び出す- 次のキーワードで検索する：Agent SDK、TypeScript SDK、Python SDK、セッション、カスタムツール、権限、または関連トピック
- 読み込んだ公式ドキュメントのみに基づいて回答する
この手順を省略すると、情報が古くなったり、不正確になったりする可能性があります。
検証チェックポイント
回答する前に、次の項目を確認してください。
- docs-management スキルを呼び出しましたか？
- 公式ドキュメントが読み込まれましたか？
- 回答は公式ドキュメントのみに基づいていますか？
チェックが1つでも未完了の場合は、停止して、最初に docs-management を呼び出してください。
概要
Claude Agent SDK（TypeScript SDK と Python SDK）の一元的な情報源です。このスキルは、すべてを docs-management に委任しており、公式ドキュメントの重複は一切含みません。
アーキテクチャ： キーワードレジストリを使用した純粋な委任方式です。公式ドキュメントには、docs-management スキルへのクエリを通じてアクセスします。
リファレンスの読み込みガイド
このスキルは、3つの読み込みレイヤーから成る純粋な委任アーキテクチャを採用しています。
レイヤー 1：常にコンテキスト内
- SKILL.md（このファイル）— キーワードレジストリ、判断ツリー、委任パターン
レイヤー 2：docs-management 経由でオンデマンド
Agent SDK の公式ドキュメントには、すべて docs-management へのクエリを通じてアクセスします。
| doc_id | トピック |
|---|---|
| platform-claude-com-docs-en-agent-sdk-overview | SDK の概要と入門 |
| platform-claude-com-docs-en-agent-sdk-typescript | TypeScript SDK API リファレンス |
| platform-claude-com-docs-en-agent-sdk-python | Python SDK API リファレンス |
| platform-claude-com-docs-en-agent-sdk-sessions | セッション管理と再開 |
| platform-claude-com-docs-en-agent-sdk-streaming-vs-single-mode | 入力モードの選択 |
| platform-claude-com-docs-en-agent-sdk-custom-tools | カスタムツールの作成 |
| platform-claude-com-docs-en-agent-sdk-permissions | 権限の設定 |
| platform-claude-com-docs-en-agent-sdk-modifying-system-prompts | システムプロンプトのカスタマイズ |
| platform-claude-com-docs-en-agent-sdk-cost-tracking | コストと使用状況の追跡 |
| platform-claude-com-docs-en-agent-sdk-todo-tracking | Todo リストの統合 |
| platform-claude-com-docs-en-agent-sdk-structured-outputs | 構造化出力機能 |
| platform-claude-com-docs-en-agent-sdk-hosting | 本番環境でのホスティングパターン |
| platform-claude-com-docs-en-agent-sdk-mcp | MCP サーバーの統合 |
| platform-claude-com-docs-en-agent-sdk-plugins | プラグインの読み込み |
| platform-claude-com-docs-en-agent-sdk-subagents | サブエージェントの使用 |
| platform-claude-com-docs-en-agent-sdk-skills | スキルの統合 |
| platform-claude-com-docs-en-agent-sdk-slash-commands | スラッシュコマンドの使用 |
レイヤー 3：外部リソース（GitHub）
- TypeScript SDK：anthropics/claude-agent-sdk-typescript
- Python SDK：anthropics/claude-agent-sdk-python
読み込み戦略
このスキルにはローカルのリファレンスファイルがありません。 すべてのドキュメントには、以下のキーワードレジストリを使用した docs-management へのクエリを通じてアクセスします。これにより、次のことが実現します。
- 公式ドキュメントの重複がゼロ
- 正規の情報源から常に最新の情報を取得
- ドキュメントの同期に関する保守作業がゼロ
このスキルを使うタイミング
キーワード： Agent SDK、Claude Agent SDK、TypeScript SDK、Python SDK、npm install claude-agent-sdk、pip install claude-agent-sdk、セッション、セッションの再開、セッションのフォーク、ストリーミングモード、シングルモード、カスタムツール、allowedTools、disallowedTools、permissionMode、システムプロンプト、appendSystemPrompt、outputStyle、CLAUDE.md、settingSources、コストの追跡、ToDo の追跡、構造化出力、ホスティング、プラグイン SDK、MCP SDK、エージェントのブランディング
このスキルは次の場合に使用します：
- Claude Agent SDK をインストールまたは設定するとき
- 認証（API キー、Bedrock、Vertex）を設定するとき
- セッションと再開を管理するとき
- ストリーミングモードとシングル入力モードのどちらを使うか選ぶとき
- カスタムツールを作成するとき
- 権限（allowedTools、disallowedTools）を設定するとき
- システムプロンプトを変更するとき
- コストと使用状況を追跡するとき
- エージェントの ToDo リストを扱うとき
- 構造化出力を取得するとき
- エージェントを本番環境でホスティングするとき
- MCP を SDK と統合するとき
- SDK のブランディング要件を理解するとき
docs-management の問い合わせに使用するキーワード一覧
公式ドキュメントを問い合わせる際は、docs-management スキルに次のキーワードを使用してください。
SDK の基礎
| トピック | キーワード |
|---|---|
| 概要 | "Agent SDK", "Claude Agent SDK overview", "why use Agent SDK" |
| インストール | "Agent SDK installation", "npm install claude-agent-sdk", "pip install claude-agent-sdk" |
| SDK オプション | "SDK options", "TypeScript SDK", "Python SDK" |
| 移行 | "Claude Code SDK migration", "migration guide" |
認証
| トピック | キーワード |
|---|---|
| API キー | "Agent SDK authentication", "ANTHROPIC_API_KEY" |
| Bedrock | "CLAUDE_CODE_USE_BEDROCK", "Bedrock SDK" |
| Vertex | "CLAUDE_CODE_USE_VERTEX", "Vertex SDK" |
セッション
| トピック | キーワード |
|---|---|
| セッション管理 | "session management SDK", "session ID", "getting session ID" |
| 再開 | "session resumption", "resume option", "continuing sessions" |
| フォーク | "forking sessions", "forkSession", "session branching" |
入力モード
| トピック | キーワード |
|---|---|
| 概要 | "streaming vs single mode", "input modes SDK" |
| ストリーミングモード | "streaming input mode", "recommended mode" |
| シングルモード | "single input mode", "non-streaming" |
カスタムツール
| トピック | キーワード |
|---|---|
| ツールの作成 | "custom tools SDK", "creating custom tools" |
| ツールスキーマ | "tool schema", "tool definition SDK" |
| ツールハンドラー | "tool handlers", "tool execution SDK" |
権限
| トピック | キーワード |
|---|---|
| ツールの権限 | "allowedTools", "disallowedTools", "tool permissions SDK" |
| 権限モード | "permissionMode SDK", "permission strategy" |
| 権限の処理 | "handling permissions SDK", "permission callbacks" |
システムプロンプト
| トピック | キーワード |
|---|---|
| 概要 | "modifying system prompts", "system prompts SDK" |
| CLAUDE.md | "CLAUDE.md SDK", "settingSources", "project instructions" |
| システムプロンプトの追加 | "appendSystemPrompt", "custom instructions" |
| 出力スタイル | "outputStyle SDK", "agent persona" |
コストと追跡
| トピック | キーワード |
|---|---|
| コストの追跡 | "cost tracking SDK", "token usage", "billing SDK" |
| ToDo の追跡 | "todo tracking SDK", "todo lists SDK", "task management" |
構造化出力
| トピック | キーワード |
|---|---|
| 構造化出力 | "structured outputs SDK", "JSON results", "validated outputs" |
| スキーマ定義 | "output schema SDK", "result validation" |
ホスティングとデプロイ
| トピック | キーワード |
|---|---|
| ホスティングの概要 | "hosting Agent SDK", "production deployment" |
| エフェメラルセッション | "ephemeral sessions", "pattern 1 hosting" |
| 永続セッション | "persistent sessions", "pattern 2 hosting" |
プラグインと MCP
| トピック | キーワード |
|---|---|
| プラグイン | "plugins SDK", "loading plugins", "programmatic plugins" |
| MCP 統合 | "MCP SDK", "MCP servers SDK", "extending with MCP" |
ブランディング
| トピック | キーワード |
|---|---|
| ブランディングガイドライン | "agent branding", "Claude Agent naming", "SDK branding" |
SDK 機能の統合
| トピック | キーワード |
|---|---|
| サブエージェント | "subagents SDK", "SDK subagents", "subagent integration" |
| スキル | "skills SDK", "SDK skills", "agent skills SDK" |
API リファレンス
| トピック | キーワード |
|---|---|
| TypeScript リファレンス | "TypeScript SDK reference", "TypeScript API" |
| Python リファレンス | "Python SDK reference", "Python API" |
| 変更履歴 | "SDK changelog", "SDK updates" |
クイック決定ツリー
何をしたいですか？
- SDK をインストールする -> docs-management に問い合わせる：「Agent SDK installation」
- 認証を設定する -> docs-management に問い合わせる：「Agent SDK authentication」
- セッションを管理する -> docs-management に問い合わせる：「session management SDK」、「resume option」
- セッションをフォークする -> docs-management に問い合わせる：「forking sessions」、「forkSession」
- 入力モードを選択する -> docs-management に問い合わせる：「streaming vs single mode」
- カスタムツールを作成する -> docs-management に問い合わせる：「custom tools SDK」
- 権限を設定する -> docs-management に問い合わせる：「allowedTools」、「permissionMode SDK」
- システムプロンプトを変更する -> docs-management に問い合わせる：「modifying system prompts」
- CLAUDE.md ファイルを使用する -> docs-management に問い合わせる：「CLAUDE.md SDK」、「settingSources」
- コストを追跡する -> docs-management に問い合わせる：「cost tracking SDK」
- ToDo の追跡を追加する -> docs-management に問い合わせる：「todo tracking SDK」
- 構造化出力を取得する -> docs-management に問い合わせる：「structured outputs SDK」
- 本番環境でホストする -> docs-management に問い合わせる：「hosting Agent SDK」
- サブエージェントを使用する -> docs-management に問い合わせる：「subagents SDK」
- スキルを統合する -> docs-management に問い合わせる：「skills SDK」、「agent skills SDK」
- スキル（コマンド）を追加する -> docs-management に問い合わせる：「skills SDK」、「SDK commands」
- プラグインを読み込む -> docs-management に問い合わせる：「plugins SDK」
トピックの網羅範囲
SDK のインストールとセットアップ
- npm パッケージ：@anthropic-ai/claude-agent-sdk
- pip パッケージ：claude-agent-sdk
- TypeScript および Python SDK の選択肢
- Claude Code SDK からの移行
認証方法
- ANTHROPIC_API_KEY 環境変数
- Amazon Bedrock の統合（CLAUDE_CODE_USE_BEDROCK）
- Google Vertex AI の統合（CLAUDE_CODE_USE_VERTEX）
- サードパーティプロバイダーの設定
セッション管理機能
- セッションの自動作成
- init メッセージからのセッション ID の取得
- resume オプションによるセッションの再開
- セッションのフォーク（forkSession/fork_session）
- 実験用のセッション分岐
- セッション間でのコンテキストの保持
入力モードの設定
- ストリーミング入力モード（推奨）
- 単一入力モード
- モードの選択基準
- パフォーマンスに関する考慮事項
カスタムツールの開発
- ツールスキーマの定義
- ツールハンドラーの実装
- SDK へのツールの登録
- ツール実行のパターン
権限の設定
- allowedTools リスト
- disallowedTools リスト
- permissionMode の設定
- 権限コールバックと処理
システムプロンプトのカスタマイズ
- CLAUDE.md ファイルの読み込み（settingSources）
- appendSystemPrompt オプション
- エージェントのペルソナを設定する outputStyle
- プロジェクトレベルとユーザーレベルの指示
コストと使用状況の追跡
- トークン使用量の監視
- 請求の統合パターン
- 使用状況のレポート
- コストの見積もり
ToDo リストの統合
- ToDo 追跡 API
- タスクの表示と管理
- 進捗の監視
- ToDo 状態の永続化
構造化出力機能
- 出力スキーマの定義
- JSON 結果の検証
- 型安全な結果
- TODO 追跡エージェントの例
ホスティングパターン
- エフェメラルセッションのパターン
- 永続セッションのパターン
- 本番環境へのデプロイ戦略
- スケーリングに関する考慮事項
Claude Code の全機能
- サブエージェント（./.claude/agents/）
- エージェントスキル（./.claude/skills/）
- フック（./.claude/settings.json）
- プラグイン（プログラムによる読み込み）
- メモリ（CLAUDE.md ファイル）
ブランディング要件
- 使用可能な名称（Claude Agent、Claude）
- 使用できない名称（Claude Code）
- 製品のブランディングガイドライン
委任パターン
標準的なクエリパターン
User asks: "How do I create a custom tool in the Agent SDK?"
1. Invoke docs-management skill
2. Use keywords: "custom tools SDK", "creating custom tools"
3. Load official documentation
4. Provide guidance based EXCLUSIVELY on official docs
複数トピックのクエリパターン
User asks: "I want to build an agent with sessions, custom tools, and cost tracking"
1. Invoke docs-management skill with multiple queries:
- "session management SDK", "session resumption"
- "custom tools SDK", "creating custom tools"
- "cost tracking SDK", "token usage"
2. Synthesize guidance from official documentation
トラブルシューティングパターン
User reports: "My session resumption isn't working"
1. Invoke docs-management skill
2. Use keywords: "session management SDK", "resume option", "session ID"
3. Check official docs for session patterns
4. Guide user through proper session handling
トラブルシューティングのクイックリファレンス
| 問題 | docs-management 用のキーワード |
|---|---|
| 認証に失敗する | "Agent SDK authentication", "ANTHROPIC_API_KEY" |
| セッションを再開できない | "session resumption", "resume option" |
| カスタムツールが動作しない | "custom tools SDK", "tool handlers" |
| 権限によってブロックされる | "allowedTools", "permissionMode SDK" |
| システムプロンプトが読み込まれない | "CLAUDE.md SDK", "settingSources" |
| コスト追跡に関する問題 | "cost tracking SDK", "token usage" |
| 構造化出力が無効 | "structured outputs SDK", "schema definition" |
| ストリーミングが動作しない | "streaming input mode", "streaming vs single" |
関連スキル
agent-sdk-development と相性のよいスキル：
- docs-management - 主な委任先。Agent SDK の公式ドキュメントをすべて提供します
- mcp-integration - MCP サーバーの設定。Agent SDK は MCP サーバーと連携できます
- settings-management - 設定の構成。SDK は Claude Code の設定に従います
- hook-management - フックの設定。SDK はプログラムによる読み込みでフックをサポートします
- current-date - バージョン履歴や監査タイムスタンプに使用する現在の UTC 日付を取得します
委任の例：
When working with Agent SDK + MCP integration:
1. Use agent-sdk-development for SDK-specific guidance
2. Use mcp-integration for MCP server configuration
3. Both skills delegate to docs-management for official documentation
追加リソース
テストシナリオ、複数モデルのテストに関する注意事項、リポジトリ固有のガイダンス、外部参照については、以下をご覧ください。
- references/testing-and-notes.md - テストシナリオ、複数モデルのテスト、リポジトリに関する注意事項、外部リンク
バージョン履歴
-
v1.1.0 (2025-11-27)：包括的な監査と機能強化
- 17 件すべての公式 Agent SDK ドキュメントを対象とする明示的な doc_id テーブルを含む、リファレンス読み込みガイドを追加
- 5 つの一般的なユースケースシナリオを含む、テストシナリオのセクションを追加
- スキルの組み合わせパターンを説明する関連スキルのセクションを追加
- 複数モデルのテストに関する注意事項のセクションを追加
- タイプ B の監査メタデータを含め、最終確認日のセクションを強化
- キーワードレジストリが公式 SDK ドキュメントをすべて網羅していることを確認
-
v1.0.0 (2025-11-26)：初回リリース
- 純粋な委任アーキテクチャ
- 包括的なキーワードレジストリ
- クイック判断ツリー
- Agent SDK の全機能を網羅するトピック
- トラブルシューティングのクイックリファレンス
最終更新日
日付： 2025-11-28 モデル： claude-opus-4-5-20251101
コメント
Markdown 対応