メニュー
Ensure OpenAPI specs define consistent request/response schemas, error model, auth, pagination, and backward compatibility.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/s977043/river-review --skill openapi-contract-completenessコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| id | openapi-contract |
| name | OpenAPI Contract Completeness |
| description | Ensure OpenAPI specs define consistent request/response schemas, error model, auth, pagination, and backward compatibility. |
| version | 0.1.0 |
| category | upstream |
| phase | upstream |
| applyTo | ["**/openapi/**/*.{yml,yaml,json}","**/*openapi*.{yml,yaml,json}","**/*swagger*.{yml,yaml,json}","**/*api*.{yml,yaml,json}","docs/**/*api*.md"] |
| tags | ["api","openapi","contract","upstream"] |
| severity | major |
| inputContext | ["diff","fullFile"] |
| outputKind | ["summary","findings","actions","questions"] |
| modelHint | balanced |
| dependencies | ["repo_metadata"] |
Primary pattern: Reviewer Secondary patterns: Inversion Why: OpenAPI仕様の差分から契約不備・互換性事故・型の曖昧さをレビューし、クライアント側の破綻シナリオを逆照射する。
このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。
ゲート不成立時の出力: NO_REVIEW: openapi-contract — OpenAPI/API仕様に関する差分がない
required/nullable/oneOf/anyOf/format が曖昧でないか。securitySchemes と各 operation の security が整合しているか。requestId/相関ID 等、障害調査に必要な情報が契約に反映されているか。すべて日本語。<file>:<line>: <message> 形式で出力する。
(summary):1: <追加/変更endpointと互換性の要点><message> に [severity=critical|major|minor|info] を含める。エラーレスポンスは { code, message, requestId } を共通化）。