Skip to content
cccskills
FreePublished on GitHub

claude-agent-sdk

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

Trigger: Agent SDK, claude_agent_sdk, claude-agent-sdk, ClaudeAgentOptions, ClaudeSDKClient, Agent SDKで, エージェントSDK, エージェントを作りたい, agent-sdkを使って, query(), createSdkMcpServer, サブエージェント構成, agent architecture

The English summary is being prepared. Showing the original description.

See how to install

Files included (33)

  • SKILL.md9.3 KB
  • agents/interview-requirements.md6.9 KB
  • references/agent-architecture/custom-tools.md7.0 KB
  • references/agent-architecture/index.md5.8 KB
  • references/agent-architecture/mcp.md6.9 KB
  • references/agent-architecture/plugins-and-skills.md6.6 KB
  • references/agent-architecture/subagents.md10.6 KB
  • references/core-concepts.md17.1 KB
  • references/deployment-and-operations.md24.4 KB
  • references/examples/01-cli-oneshot.md2.6 KB
  • references/examples/02-v2-session.md3.3 KB
  • references/examples/03-websocket-chat.md4.5 KB
  • references/examples/04-multi-agent.md5.4 KB
  • references/examples/05-mcp-tools.md4.7 KB
  • references/examples/06-electron-desktop.md2.7 KB
  • references/examples/07-doc-generation.md2.6 KB
  • references/examples/common-patterns.md3.2 KB
  • references/io-and-streaming/approval-and-input.md8.7 KB
  • references/io-and-streaming/index.md9.6 KB
  • references/io-and-streaming/streaming-output.md7.8 KB
  • references/io-and-streaming/structured-output.md5.7 KB
  • references/sdk-reference/common-options.md16.5 KB
  • references/sdk-reference/hooks-api.md8.1 KB
  • references/sdk-reference/index.md8.1 KB
  • references/sdk-reference/python-api.md8.4 KB
  • references/sdk-reference/tools-api.md6.7 KB
  • references/sdk-reference/types.md12.6 KB
  • references/sdk-reference/typescript-api.md6.4 KB
  • references/system-configuration/checkpoints.md8.3 KB
  • references/system-configuration/commands-and-todo.md8.8 KB
  • references/system-configuration/hooks.md16.8 KB
  • references/system-configuration/index.md7.1 KB
  • references/use-cases-index.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Claude Agent SDK 設計サポート

概要

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

設計原則

原則説明
Hearing Firstまずヒアリングで要件を明確化してから設計提案
Use Case Driven公式デモの実装パターンを基にした具体的なユースケース提案
Progressive Disclosure必要なリファレンスのみを読み込み
Both LanguagesPython / TypeScript 両方の実装パターンを提示
Design-Orientedコード生成ではなく設計判断を支援

ワークフロー

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 で特定した番号に対応するファイルを読み込む:

ユースケースファイル
#1 CLIツール(ワンショット)references/examples/01-cli-oneshot.md
#2 セッション型マルチターンreferences/examples/02-v2-session.md
#3 WebSocket チャットアプリreferences/examples/03-websocket-chat.md
#4 マルチエージェントシステムreferences/examples/04-multi-agent.md
#5 MCPツール統合アプリreferences/examples/05-mcp-tools.md
#6 デスクトップアプリ(Electron)references/examples/06-electron-desktop.md
#7 ドキュメント自動生成references/examples/07-doc-generation.md

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

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

トピックリファレンス
SDK基礎・セッションreferences/core-concepts.md

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

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

トピックリファレンス読み込み条件
サブエージェント・ツール・MCPreferences/agent-architecture/index.mdカスタムツール・MCP使用時(→詳細: subagents, mcp, custom-tools, plugins-and-skills)
ストリーミング・構造化出力references/io-and-streaming/index.mdI/Oモード選択時(→詳細: streaming-output, structured-output, approval-and-input)
権限・フック・設定references/system-configuration/index.md権限・フック設計時(→詳細: hooks, commands-and-todo, checkpoints)
デプロイ・セキュリティreferences/deployment-and-operations.md本番デプロイ・セキュリティ設計時
API詳細references/sdk-reference/index.mdAPI仕様確認時(→詳細: python-api, typescript-api, common-options, hooks-api, tools-api)

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 比較表

特徴PythonTypeScript
パッケージclaude-agent-sdk@anthropic-ai/claude-agent-sdk
メイン関数query()query()
オプション型ClaudeAgentOptionsClaudeAgentOptions
永続セッションClaudeSDKClient-
スキーマ検証PydanticZod
V2 API-unstable_v2_prompt()

権限モード早見表

モードファイル操作Bash全ツール
default承認要求承認要求承認要求
acceptEdits自動承認承認要求承認要求
bypassPermissions自動承認自動承認自動承認
plan実行不可実行不可実行不可

入力モード比較

機能ストリーミングシングル
画像アップロード可不可
メッセージキュー可不可
フック可不可
リアルタイムフィードバック可不可
シンプルさ-可

デプロイパターン

パターン説明適用場面
エフェメラルリクエスト毎にコンテナAPI/Webhook
長時間実行永続プロセス常駐サービス
ハイブリッド用途に応じて切替大規模システム
シングルコンテナ1コンテナ内で実行開発・テスト

ベストプラクティス

すべきこと避けるべきこと
ストリーミング入力を使う(本番)シングルモードを本番で使う
最小権限の原則で権限モード選択bypassPermissionsを無条件で使う
フックで危険なコマンドを制御権限チェックなしでBash実行
セッションIDを保存して再開可能に毎回新規セッションを作成
maxTurnsでコスト制限トークン使用量を監視しない
カスタムツールにZod/Pydanticスキーマ型なしのツール定義

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

See all skills by ryryo

Report a problem with this skill