01
このSkillでできること
- ✓APIエンドポイントやGraphQLスキーマの設計方針を整理する
- ✓モジュール間・フロントエンドとバックエンド間の契約を定義する
- ✓公開インターフェースの変更、非推奨化、移行時の互換性を検討する
- ✓境界での入力検証や一貫したエラー処理など、誤用しにくい設計を検討する
02
使い方
01
STEP 1
新しいAPI、モジュール境界、コンポーネントのプロパティインターフェースを設計するときに使う
02
STEP 2
実装前に契約、入力、出力、エラー時の振る舞いを定義する
03
STEP 3
公開される挙動を意識し、実装詳細を漏らさず、将来の非推奨化を設計段階で考える
04
STEP 4
既存の公開インターフェースを変更する場合は、フィールド追加や互換性への影響を確認する
03
Skillのインストール
初心者におすすめ
AIにこのSkillを追加してもらう
GitHub URLごとCodexやClaude Codeへ渡し、現在の環境に合う方法を判断してもらいます。
このGitHubリポジトリにあるSkillを確認し、現在の環境に適した方法でインストールしてください。
インストール後、正常に利用できることを確認し、基本的な使い方も簡潔に説明してください。
Repository:
https://github.com/MikeKharr/ai-advent-202604
このSkillを使うプロンプト例
Skill名を明示すると、意図したSkillを使わせやすくなります。自動発動型では必須とは限りません。
新しいタスク管理REST APIの契約を設計してください。エンドポイント、入出力、エラー処理、入力検証、後方互換性、非推奨化の方針を一貫した形で整理してください。出力例を見る
契約を先に定義し、エンドポイント、リクエストとレスポンス、エラー形式、境界での検証、互換性維持の方針を整理します。05
安全性チェック
自動解析による参考情報です。Skillの安全性を保証するものではありません。
外部API通信明確な記述なし
Shellコマンド実行明確な記述なし
ファイル読み取り明確な記述なし
ファイル書き込み明確な記述なし
ネットワークアクセス明確な記述なし
認証情報明確な記述なし
06
関連Skill
api-design-review
API設計レビュー
REST、GraphQL、gRPC、非同期イベントAPIの設計や契約を、互換性・ページネーション・認可など7項目でレビューします。
評価確度：暫定agent-skillsai-agentscursor
add-customer-to-user-list
Langfuseユーザー一覧への顧客追加
Langfuseの公開ユーザー・導入企業一覧に、企業情報や利用用途、ユーザーストーリーまたは外部参照を追加・更新するスキル。
agent-skillsagentsgenai
humanizer
humanizer
AIらしい文章のパターンを取り除き、内容や主張を変えずに自然な文章へ書き換えるスキル。
評価確度：暫定AI文章文章リライト自然な文章