メニュー
PR 前の DeepReview を標準フローで進める。一次情報確認、source of truth の確認、 非破壊性・回帰・配布経路の点検、別タスク review、修正後の再レビューまでを整理する。 「DeepReview」「事前レビュー」「PR前レビュー」「commit前にチェック」の依頼時。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
こんなときに使う: Ubuntu / Linux サーバーに SSH で接続し、sudo、systemd サービス、HTTP 監視を一連で安全に進めたいとき。 接続前に SSH_AUTH_SOCK を含む認証状態を固定し、認証で止まらずに サーバー接続・権限確認・サービス起動・停止・再起動・状態確認を一気に行いたいとき。
調査→修正→検証→ふりかえり/後続 Issue 化までを 1 つの改善ループで回したいときに使う。 実装前の再現確認や、review 指摘・検証結果をもとに次のアクションへつなぐ。
こんなときに使う: 現在の会話内容をもとに、実装・エージェント発注に直結する PRD を作りたいとき。 追加のインタビューはせず、すでに会話に出ている内容だけから構成する。 情報が不足している場合は捏造せず「未確定」として明示する。
こんなときに使う: ユーザーが「インタビューして」「質問して」「設計を詰めたい」などと言ったら使う。 計画や設計の重要な判断軸を洗い出し、具体例・反例・影響範囲まで深掘りして要件整理に落とす。
Copilot の custom skill / agent / repository instructions の作成・改善・構造確認を 1 つの入口にまとめる。複合スキルとして、対象に応じて適切な authoring ルートへ 分けつつ、実行時のモデル呼び出しを抑止してルーティングを優先する。試作から `plugins/*` 配布へ昇格するときの name / description 整備も扱う。skill / agent / repo-wide instructions / path-specific instructions を新規作成したいとき、既存定義を育てたいとき、公開前に責務や導線を確かめたいとき。
新しい custom agent を既存 agent 群と同じ型で立ち上げる。agent の新規追加、役割分離のための専門 agent 作成、既存群の隙間を埋めたいとき。
| name | deep-review-preflight |
| description | PR 前の DeepReview を標準フローで進める。一次情報確認、source of truth の確認、 非破壊性・回帰・配布経路の点検、別タスク review、修正後の再レビューまでを整理する。 「DeepReview」「事前レビュー」「PR前レビュー」「commit前にチェック」の依頼時。 |
| license | Personal |
| compatibility | built-in /review or code-review agent |
PR 前に「まだ reviewer が掘りそうな論点」を先回りで洗うためのスキルです。 単発の diff チェックではなく、一次情報 -> 深掘り review -> 修正 -> 再 review の流れを型にします。
| 状況 | 次にやること | 使うもの |
|---|---|---|
| ローカル差分の事前レビュー（品質） | Step 1 から開始 | built-in /review または code-review agent |
| ローカル差分の事前レビュー（セキュリティ） | Step 1 から開始 | built-in /review + セキュリティ観点の明示 |
| 認証・権限・migration 等の両面変更 | Step 1 から開始 | built-in /review または code-review agent |
| 値オブジェクト風クラスの guard / invariant / 例外文言が中心の変更 | Step 2 で guard 観点を追加 | built-in /review または code-review agent |
| custom agent が未導入 | Step 1 から開始 | built-in /review または code-review agent |
| すでに PR コメントが来ている | この skill ではなくレビュー応答へ進む | gh-pr-respond |
| 軽微な文言修正だけ | 必要最低限の確認に留める | 手動確認 or 軽量 review |
差分だけを見て始めず、まず「何を変えたか」と「何を根拠にすべきか」を固定します。
git diff --staged / git diff / 必要なら直近コミットを確認するWhy: reviewer はコードだけでなく、仕様の穴と責務のズレを掘ってくるからです。
references/checklist.md を使い、今回の変更に当てはまる観点だけを残します。
最低でも次を確認します。
guard / invariant 系の変更では、追加で次を確認します。
review は実装スレッドと分けます。実装中の思考をそのまま正当化しないためです。
優先順:
/review または code-review agent を使うreview 依頼時の要件:
出た指摘は severity ごとに分けます。
CRITICAL / HIGH: PR 前に解消するMEDIUM: 今回解消するか、理由付きで保留するLOW: ノイズなら捨てる。意味があるなら follow-up に分ける同時に、今回の修正で reviewer が次に掘りそうな 2〜3 手先も確認します。
修正後は、変更に対応する既存コマンドで再確認します。
validate_skill.pyその後、同じ観点で短い再 review を 1 回だけ回します。
Why: 初回 review の修正で別の穴を作るのを防ぐためです。
DeepReview を通過したら、結果を短く残して gh-pr-create へ進みます。
最低限残す内容:
gh-pr-create — DeepReview 後の PR 作成とレビュー待機gh-pr-respond — 実際の PR コメント対応safe-refactor — 振る舞いを変えずに差分を小さくしたいときdeep-review-preflight/
├── SKILL.md
└── references/
└── checklist.md