plan-deep-review について
plan-deep-reviewは、計画の範囲、戦略上の選択、実行リスクを評価するスキルです。内容に応じてエンジニアリング、デザイン、開発者向けチェックを行い、準備状況を判定します。
主な機能
- 01範囲拡張モードの設定
- 02計画領域に応じたレビューの振り分け
- 03既存コードと根拠の確認
- 04代替案と障害要件の記録
- 05準備状況の判定
活用シーン
- 01計画承認前の範囲評価
- 02アーキテクチャと実行リスクのレビュー
- 03合意範囲と未決事項の記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ borkweb/ skills --skill plan-deep-reviewインストール後、Claude Code で/plan-deep-reviewを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlstrategy.md
詳細
詳細な計画レビュー
計画のスコープ、戦略上の選択、実行リスクを評価します。詳細なレビュー資料を読み込む前に、モードを決定します。
スコープと進め方
提示された計画と、関連する既存の実装を確認します。計画のみの依頼では、ブランチは必須ではありません。ハイブリッドの依頼では、指定された差分も固定します。確定済みの制約、保護対象のパス、これまでの決定事項を維持します。
ユーザーが指定した対話モードに従います。指定がない場合は、独立した指摘をまとめ、本当に未解決でスコープや設計に影響する選択についてのみ質問します。独立した質問は最大4件まで1つの質問プロンプトにまとめ、1件ずつ質問するのではなく、TODOや延期に関する判断は最終チェックポイントにまとめます。質問はまとめてもすべて保持します。質問を評議会にかける場合は、ユーザーがサブエージェントを求めない限り、クイックモードでその場で実行します。独立した評議会は同時に実行し、先の判断に依存する判断のみ保留します。改善が求められている場合は、明らかな計画の修正を適用します。報告のみの依頼では編集しません。「質問を省略」と指定された場合はすぐに従い、前提を明示して有用な作業を続けます。前提がスコープ変更を許可するわけではありません。すでに決定済みの事項を再度質問しません。
計画をレビューし、実装は行いません。ソースの変更、コミット、プッシュ、リモートタスクの作成は行いません。該当する受け入れ基準に対処した時点で終了するか、残る阻害要因を報告します。評価は任意の要約であり、10/10にするために繰り返し磨き込む必要はありません。
モード
| モード | スコープの契約 |
|---|---|
| SCOPE EXPANSION | より広範な機会を提案します。追加には承認が必要です。 |
| SELECTIVE EXPANSION | 基本スコープを維持し、有益な追加案をいくつか提示します。 |
| HOLD SCOPE | 機能を追加も削除もせず、厳密さを高めます。 |
| SCOPE REDUCTION | 必須要件を維持しつつ、より小さく完結した解決策を提案します。 |
指定されたモードに従います。指定がない場合はHOLD SCOPEを既定とし、依頼の意図するスコープを推測できない場合に限り質問します。strategy.md の該当セクションのみを読みます。
レビューの振り分け
- アーキテクチャ、データ、セキュリティ、障害、テスト、パフォーマンス、デプロイについては、engineering checks の該当セクションを確認します。
- UIのスコープについては、既存プロダクトに基づいて、該当するdesign checksを確認します。
- 開発者向けの契約については、該当するDX checksを確認します。
フルモードでは、該当するすべての領域をレビューします。クイック/バッチモードでは、計画によって変更される判断と障害経路を優先します。重要な確認範囲の制限を記録します。代替案を提案する前に、現行コード、計画、根拠を確認します。範囲の狭い変更では、システム全体の監査や競合他社の調査を必須としません。
提出内容
承認されたスコープ、再利用する既存コンポーネント、重要な代替案、障害時および検証の要件、未解決の判断事項を記録します。障害テーブルは1つにまとめ、複雑な関係を明確にする場合に限り図を使います。スコープの拡大/縮小については、承認済みの作業と提案中の作業を明記します。承認された場合は、依頼された計画を更新します。依頼に含まれていない限り、バックログの変更は別扱いとします。
最後に、READY、NEEDS DECISIONS、INCOMPLETEのいずれかと、具体的に残っている要件を示します。計画の準備が整ったことと、実装やテストが済んでいることを混同しないでください。