メニュー
API エンドポイントの設計・実装・変更を行うとき（HTTP ハンドラ、OpenAPI スキーマ、ヘルスチェック、ルーティング、認証方式の追加、MCP サーバーの構築など）に参照する。OpenAPI 準拠、RFC 9457 エラー、パスバージョニング、Bearer 認証（loopback サービスは Origin 検証で代替可）、Spectral リント、HTTP サーバー層の統一と MCP トランスポートの選定を定義する。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/philtzjp/live-connector --skill api-designコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
パッチバグフィクス以外の実装作業を行うときに必ず参照する。Issue 起票、専用ブランチ作成、実装、PR 作成、同期状態確認、ahead/behind がない場合のみマージする標準フローを定義する。巨大モノレポ、複数会社・複数人で同時実装する状況、機能追加、仕様変更、リファクタリング、設計変更、依存関係変更、DB/API/UI/アーキテクチャ変更で使用する。
既存スキルに従って作業しても期待通り進まないとき、Web 検索などで異なる情報・より新しい情報が得られたとき、スキルの条件分岐を厳守するとスタックや実装の自由度が制限され最良の結果が得られないと判断したときに参照する。`.agents/skills/<name>/SKILL.md` をローカルで改変する手順、および改変内容が有用と判断した場合に `philtzjp/skills` リポジトリへ変更提案 Issue を起票する手順とテンプレートを定義する。
コミット、プッシュ、ブランチ作成/切り替え/削除、マージ、リベース、`gh pr merge` による PR マージなどあらゆる Git / GitHub 操作を行うときに参照する。コミットメッセージのフォーマット (`type(scope): 説明`)、マージコミット件名 (`merge(scope): 説明`) の `--subject` / `--body ""` 指定、`--author` の扱い、`git fetch --prune` などの安全チェック、マージコミット件名・本文への PR/Issue 番号 (`#N`) 禁止、`Co-Authored-By` 禁止、`git add .` 禁止などを定義する。
SOC 職業分類に基づく
SKILL.md を表示中
| name | api-design |
| description | API エンドポイントの設計・実装・変更を行うとき（HTTP ハンドラ、OpenAPI スキーマ、ヘルスチェック、ルーティング、認証方式の追加、MCP サーバーの構築など）に参照する。OpenAPI 準拠、RFC 9457 エラー、パスバージョニング、Bearer 認証（loopback サービスは Origin 検証で代替可）、Spectral リント、HTTP サーバー層の統一と MCP トランスポートの選定を定義する。 |
/api/v1/）kebab-case を使用する/users ではなく /user）http）で実装する; IF: MCP サーバーを構築; THEN MUST: 採用した HTTP 層に対応する MCP トランスポートを使用する（フレームワーク採用時はそのアダプタ。例: Hono なら @hono/mcp。フレームワーク不採用時は SDK 同梱トランスポート。例: TypeScript SDK の StreamableHTTPServerTransport）