platform-backend について
platform-backend は、バックエンド API 開発向けのスキルです。ガード節による早期失敗とエラーの記録・伝播を重視し、依頼の適合確認から出力の検証までの手順を示します。
主な機能
- 01ガード節による早期失敗
- 02すべてのエラーの記録または伝播
- 03依頼がスキルの対象かを確認
- 04具体的な出力を作るワークフロー
- 05必要に応じた結果の確認と修正
活用シーン
- 01API エンドポイントのエラー処理設計
- 02リクエストデータのバリデーション計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ravnhq/ ai-toolkit --skill platform-backendインストール後、Claude Code で/platform-backendを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/endpoint-blueprint.mdrules/_sections.mdapi-authorization-vs-authentication.mdapi-output-schemas.mdapi-request-lifecycle.mdapi-select-sensitive-fields.mderror-domain-specific.mderror-http-codes.mdlogging-structured.mdsecurity-dont-expose-internals.mdsecurity-dont-log-secrets.mdsecurity-filter-by-tenant.mdsecurity-never-commit-secrets.mdsecurity-procedure-hierarchy.mdvalidation-at-boundary.mdvalidation-strict-schemas.md詳細
原則
- ガード節で早めに例外を投げます — 関数の冒頭で速やかに失敗させます
- エラーを黙って握りつぶしてはいけません — すべての失敗をログに記録するか、伝播させます
ルール
詳しいパターンについては、ルールのインデックスを参照してください。
例
該当するケース
ユーザー:「この API エンドポイントのエラー処理と検証の方針を設計してください。」
期待される動作:platform-backend のガイダンスを使用し、そのワークフローに従って、実行可能な結果を返します。
該当しないケース
ユーザー:「Tailwind のデザイントークンスケールを作成してください。」
期待される動作:platform-backend を優先せず、より関連性の高いスキルを選ぶか、スキルを使わずに対応します。
トラブルシューティング
スキルが適用されない
- エラー:期待したときにスキルが選択されません。
- 原因:リクエストの表現が、説明にある適用条件と明確に一致していません。
- 解決策:説明に記載されたドメインやタスクのキーワードを明示して言い換え、再試行してください。
ガイダンスが別のスキルと競合する
- エラー:1つのタスクで複数のスキルの指示が競合します。
- 原因:読み込まれたスキルの適用範囲が重複しています。
- 解決策:現在のステップでどのスキルを優先するかを明示し、そのワークフローを最初に適用してください。
出力が汎用的すぎる
- エラー:結果に具体性や実行可能な詳細がありません。
- 原因:タスクの入力に、コンテキスト、制約、または出力形式が不足しています。
- 解決策:具体的な制約(環境、範囲、形式、成功基準)を追加して再実行してください。
ワークフロー
- リクエストが
platform-backendの適用範囲と適用条件に明確に一致するか確認します。 - スキルのルールと参照先のガイダンスを適用し、具体的な結果を作成します。
- 制約に照らして出力の品質を検証し、不足があれば、明示的な前提を置いて一度だけ修正します。
コメント
Markdown 対応