mcpField
P
platform-backend

platform-backend

github.com/ravnhq開発1643 回インストール21 週間前に更新
リポジトリ

platform-backend について

platform-backend は、バックエンド API 開発向けのスキルです。ガード節による早期失敗とエラーの記録・伝播を重視し、依頼の適合確認から出力の検証までの手順を示します。

主な機能

  1. 01ガード節による早期失敗
  2. 02すべてのエラーの記録または伝播
  3. 03依頼がスキルの対象かを確認
  4. 04具体的な出力を作るワークフロー
  5. 05必要に応じた結果の確認と修正

活用シーン

  1. 01API エンドポイントのエラー処理設計
  2. 02リクエストデータのバリデーション計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ravnhq/ai-toolkit --skill platform-backend

インストール後、Claude Code で/platform-backendを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
endpoint-blueprint.md
rules/
_sections.md
api-authorization-vs-authentication.md
api-output-schemas.md
api-request-lifecycle.md
api-select-sensitive-fields.md
error-domain-specific.md
error-http-codes.md
logging-structured.md
security-dont-expose-internals.md
security-dont-log-secrets.md
security-filter-by-tenant.md
security-never-commit-secrets.md
security-procedure-hierarchy.md
validation-at-boundary.md
validation-strict-schemas.md

詳細

原則

  • ガード節で早めに例外を投げます — 関数の冒頭で速やかに失敗させます
  • エラーを黙って握りつぶしてはいけません — すべての失敗をログに記録するか、伝播させます

ルール

詳しいパターンについては、ルールのインデックスを参照してください。

例

該当するケース

ユーザー:「この API エンドポイントのエラー処理と検証の方針を設計してください。」

期待される動作:platform-backend のガイダンスを使用し、そのワークフローに従って、実行可能な結果を返します。

該当しないケース

ユーザー:「Tailwind のデザイントークンスケールを作成してください。」

期待される動作:platform-backend を優先せず、より関連性の高いスキルを選ぶか、スキルを使わずに対応します。

トラブルシューティング

スキルが適用されない
  • エラー:期待したときにスキルが選択されません。
  • 原因:リクエストの表現が、説明にある適用条件と明確に一致していません。
  • 解決策:説明に記載されたドメインやタスクのキーワードを明示して言い換え、再試行してください。
ガイダンスが別のスキルと競合する
  • エラー:1つのタスクで複数のスキルの指示が競合します。
  • 原因:読み込まれたスキルの適用範囲が重複しています。
  • 解決策:現在のステップでどのスキルを優先するかを明示し、そのワークフローを最初に適用してください。
出力が汎用的すぎる
  • エラー:結果に具体性や実行可能な詳細がありません。
  • 原因:タスクの入力に、コンテキスト、制約、または出力形式が不足しています。
  • 解決策:具体的な制約(環境、範囲、形式、成功基準)を追加して再実行してください。

ワークフロー

  1. リクエストが platform-backend の適用範囲と適用条件に明確に一致するか確認します。
  2. スキルのルールと参照先のガイダンスを適用し、具体的な結果を作成します。
  3. 制約に照らして出力の品質を検証し、不足があれば、明示的な前提を置いて一度だけ修正します。

コメント