api-test-postman について
Postman向けのAPIテスト計画や成果物を作成するスキルです。プロジェクトの背景情報を取り込み、リスクを考慮し、情報不足時はギャップや仮定を明記します。
主な機能
- 01Postman向けAPIテスト計画
- 02プロジェクト情報の追加ガイド
- 03リスクに基づく出力
- 04仮定と不足情報の記録
- 05既定のMarkdown出力
活用シーン
- 01Postmanワークフロー用APIテストの準備
- 02既存Postmanプロジェクトのテスト計画
- 03入力不足時の初期計画の作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/api-test-postmanを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlevals/eval.yamlevals/cases/basic-success.yamledge-incomplete-input.yamledge-scope-boundary.yamlreview-collection-auth-cleanup.yamlreview-unknown-expectation.yamlexamples/sample-context.mdoutput-templates/template-markdown.mdprompts/api-test-postman.mdreferences/framework-spec.mdsetup-and-ci.mdscripts/run-tests.sh詳細
Postman API テスト（EN）
中国語版： 対応する中国語スキルを参照してください。
使用する場面
- Postman API テストのワークフローで活用する出力が必要な場合。
- プロジェクトですでに Postman を使用している場合、または Postman に対応した計画を求めている場合。
出力形式の選択肢
リクエストで別の形式が明示的に指定されていない限り、デフォルトは Markdown です。
使用方法
prompts/api-test-postman.mdを開き、メインプロンプトとして使用します。- 範囲、環境、制約、リスク、依存関係、期待する成果物など、実際のプロジェクトのコンテキストを追加します。
- 入力が不完全な場合は、使える初版を作成し、不足している情報と前提を明記します。
参考ファイル
prompts/api-test-postman.md：このスキルのメインプロンプト。references/framework-spec.md：ツール固有の構成とテスト範囲に関する注意事項。references/setup-and-ci.md：セットアップ、実行、CI に関する注意事項。examples/sample-context.md：リクエストコンテキストのサンプル。scripts/run-tests.sh：ローカル実行用の軽量なエントリーポイント。
よくある落とし穴
- 範囲が曖昧で、コンテキストがない状態では使用しないでください。
- すべての領域を同じ重要度として扱わないでください。
- 前提や不足している情報を省略しないでください。
ベストプラクティス
- プロンプトファイルを起点にし、重要なコンテキストだけを追加します。
- リスクを重視し、実行可能な出力にします。
- リクエストが不完全な場合は、使える初版を作成し、不足事項を明記します。
コメント
Markdown 対応