메뉴
Notion の仕様ページをレビューし、セキュリティ・考慮漏れ・既存実装との整合性などの問題点をコメントとして報告するスキル。「仕様をレビューして」「スペックをチェックして」「review-spec」などの指示で呼び出される。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
GitHub に関する全ての操作やこのプロジェクトの GitHub に関する情報が欲しい時に呼び出されるスキル（PR, Issue）
git に関する全ての操作やこのプロジェクトのgitに関する情報が欲しい時に呼び出されるスキル（branch, commit, push, pull, merge ...）
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
app 側のページ実装を `@playlistwizard/ui` へページ単位で移行するための方針。`@/components/ui/*` import の置換、共通コンポーネント化、既存表示差分の抑制、packages/ui 側の variant 設計を伴う作業で参照すること。
Next.js AppRouter における、データフェッチング、データベースへのクエリ発行のベストプラクティス。データフェッチを伴う処理を実装、変更する場合はこのドキュメントを参照すること。
ユーザーと対話しながら機能仕様を策定し、Notion に自動でドキュメント化するスキル。「仕様を作ろう」「スペックを書いて」「仕様を詰めよう」などの指示で呼び出される。
| name | review-spec |
| description | Notion の仕様ページをレビューし、セキュリティ・考慮漏れ・既存実装との整合性などの問題点をコメントとして報告するスキル。「仕様をレビューして」「スペックをチェックして」「review-spec」などの指示で呼び出される。 |
| allowed-tools | ["Read","Glob","Grep","AskUserQuestion","mcp__notion__notion-fetch","mcp__notion__notion-create-comment"] |
Notion の仕様ページを取得・読み込み、セキュリティ・整合性・考慮漏れを多角的にレビューし、問題点を Notion コメントとして報告する。仕様ページ自体は変更しない。コメントのみ追加する。
ARGUMENTS) から Notion URL を取得する
mcp__notion__notion-fetch で Notion ページを取得し、仕様の全内容を把握する。
その後、仕様に登場する関連ファイル・API・スキーマ・型などを Glob/Grep/Read でコードベースから実際に読み込み、実装と仕様を照らし合わせる。
以下の優先順位でレビューする。各問題点には必ず重大度を付ける。
| ラベル | 基準 |
|---|---|
| 🔴 Critical | セキュリティホール・データ破壊・サービス停止につながるもの。即時修正が必要。 |
| 🟠 Major | 正しく動作しない・重大なバグになるもの。リリース前に修正が必要。 |
| 🟡 Minor | 改善推奨・ベストプラクティス逸脱。対応は任意だが記録する。 |
accId・playlistId などを、DB の所有確認なしに信頼していないか？userId はリクエストボディから取らず、セッション or ジョブ DB から取得しているか？仕様を読んで判断できない箇所があれば 必ず AskUserQuestion ツールで確認を取る。会話文での質問は禁止。
特に以下は判断できないまま進めない:
mcp__notion__notion-create-comment で仕様ページにコメントを追加する。
以下のフォーマットでコメントを作成すること。問題がない観点は「問題なし」と明記する。
## 仕様レビュー結果
### サマリー
- 🔴 Critical: {N} 件
- 🟠 Major: {N} 件
- 🟡 Minor: {N} 件
---
### 🔴 Critical
#### [C-1] {問題タイトル}
- **場所**: {仕様の該当セクション名}
- **問題**: {問題の詳細説明}
- **リスク**: {放置した場合に起こりうること}
- **改善案**: {具体的な修正案}
#### [C-2] ...
---
### 🟠 Major
#### [M-1] {問題タイトル}
- **場所**: ...
- **問題**: ...
- **リスク**: ...
- **改善案**: ...
---
### 🟡 Minor
#### [N-1] {問題タイトル}
- **場所**: ...
- **問題**: ...
- **改善案**: ...
---
問題なし ✅
- {問題がなかった観点のリスト}
---
*review-spec skill によるレビュー*
## 仕様レビュー結果 ✅
重大な問題は見つかりませんでした。
確認した観点:
- ✅ セキュリティ・認可
- ✅ 考慮漏れ・エッジケース
- ✅ 既存実装との整合性
- ✅ UX・フロー
---
*review-spec skill によるレビュー*
投稿後、Notion ページの URL とレビュー結果のサマリーをユーザーに表示して完了を伝える。