Claude Agent Sdk

Claude Agent SDK 設計サポート

概要

Claude Agent SDK（Python / TypeScript）を使った機能実装の設計をサポートするスキル。 ヒアリング型ワークフローでユーザーの要件を明確化し、公式ドキュメントに基づいた最適なアーキテクチャと実装パターンを提案する。

設計原則

ワークフロー

Phase 1: 要件ヒアリング
  → agents/interview-requirements.md を読み込み
  → AskUserQuestion で要件を明確化
  → references/use-cases-index.md を読み込み、近いユースケース番号を特定
      ↓
Phase 2: ユースケース詳細 & リファレンス参照
  → Phase 1 で特定したユースケース番号の examples/0X-*.md を読み込み
  → 組合せ設計時は examples/common-patterns.md も読み込み
  → ヒアリング結果に基づき必要な references/ を追加読み込み
      ↓
Phase 3: 設計提案
  → examples/ のアーキテクチャ図・コード例を土台に設計提案

Phase 1: 要件ヒアリング

1. agents/interview-requirements.md を読み込み、ヒアリング項目を把握する
2. references/use-cases-index.md を読み込み、ユースケースカタログを把握する
3. AskUserQuestion で以下を確認する:
   • 目的: 何を作りたいか（エージェントの用途）
   • 機能: 必要な機能（ツール、MCP、サブエージェント等）
   • 言語: Python or TypeScript
   • I/O: ストリーミング / シングル / 構造化出力
   • セッション: ワンショット / 継続 / フォーク
   • デプロイ: ローカル / コンテナ / クラウド
   • セキュリティ: 権限モード、サンドボックス
   • コスト: トークン制限、最適化要件
4. ヒアリング結果を use-cases-index.md の選定ガイドと照合し、該当ユースケース番号（#1〜#7）を特定してユーザーに提示する

Phase 2: ユースケース詳細 & リファレンス参照

Phase 1 で特定したユースケース番号に基づき、以下の順で読み込む:

Step 1: ユースケース詳細を読み込む（必須）

Phase 1 で特定した番号に対応するファイルを読み込む:

複数ユースケースを組み合わせる場合は、該当する複数ファイル + references/examples/common-patterns.md を読み込む。

Step 2: 基礎リファレンスを読み込む（必須）

Step 3: 追加リファレンスを読み込む（該当時のみ）

ヒアリング結果に基づき、必要なリファレンスのみを追加で読み込む:

Phase 3: 設計提案

Phase 2 で読み込んだ examples/ のアーキテクチャ図・コード例を土台に、以下の形式で提案する:

## 設計提案

### 参考ユースケース
- ベースパターン: #X（examples/0X-*.md のタイトル）
- 追加パターン: #Y（該当する場合）
- 参照元: examples/0X-*.md のアーキテクチャ図・実装ポイント

### アーキテクチャ概要
[examples/0X-*.md のアーキテクチャ図をベースに、ユーザー要件に合わせてカスタマイズした構成図・説明]

### 推奨構成
- 言語: Python / TypeScript
- 入力モード: ストリーミング / シングル
- 権限モード: default / acceptEdits / bypassPermissions
- セッション: ワンショット / 継続 / フォーク
- デプロイ: パターン名

### 実装ステップ
1. [examples/0X-*.md の実装ポイントを参考に具体的なステップを記述]
2. ...

### コード例（Python / TypeScript）
[examples/0X-*.md のコード例をベースに、ユーザー要件に合わせて調整したコードを提示]
[複数パターン組合せ時は common-patterns.md のコード例も活用]

クイックリファレンス

Agent SDK 比較表

権限モード早見表

入力モード比較

デプロイパターン

ベストプラクティス