After a plan is created or updated with CreatePlan, self-evaluates it on a 100-point scale, lists deficiencies as a task list, improves the plan and any project design documents, and performs a final check for contradictions and omissions. Must be run in the same response immediately after CreatePlan; do not skip. Use when you have just called CreatePlan or updated a plan.
Install
npx skillscat add hrdtbs/agent-skills/plan-self-review Install via the SkillsCat registry.
Plan 自己評価・設計書改善
Plan 作成または更新の直後に、100点満点で自己評価し、不足点をタスクリスト化、設計書(Plan およびプロジェクト内の別設計書)を改善し、矛盾・記載漏れを最終確認する。
発動条件
このスキルは Plan を CreatePlan で作成または更新した直後に適用する。CreatePlan を呼んだら、同じ返答内で本スキルを省略せずに実行する。会話の文脈で「今プランを作成した」「プランを更新した」と分かる場合も実行する。
手順
Step 1: 100点満点で自己評価
Plan の内容を「評価基準」の 4 軸で採点する。合計点と各軸の点数・短い理由を「出力テンプレート」の形式で提示する。
Step 2: 不足点のタスクリスト作成
減点理由・抜け・曖昧さを「やることリスト」にする。優先度の高いものから並べ、チェックリスト形式(- [ ] 〜)で記載する。改善後に - [x] にする運用を推奨。
Step 3: 設計書の改善
- Plan: Step 2 のタスクに沿って、プランファイルを編集する(CreatePlan の更新、または Plan ファイルの Read 後に編集指示)。
- 別設計書: プロジェクト内に設計書(
DESIGN.md,docs/design.md,design/配下など)があるか検索する。存在する場合は、同じ不足点・矛盾・記載漏れの観点で参照し、Plan と整合するよう必要なら編集する。設計書が複数ある場合は Plan を主とし、他は必要に応じて対応する。
Step 4: 矛盾・記載漏れの最終確認
- 矛盾: 論理の食い違い、前提と結論の不一致、用語の二重定義がないか確認する。
- 記載漏れ: 前提・スコープ・成果物・担当・期限・リスク・依存が不足していないか確認する。
問題があれば Step 2 のタスクに追加し、再度改善する。問題がなければ「矛盾なし/記載漏れなし」を明示する。
評価基準(100点満点)
| 観点 | 配点 | 内容 |
|---|---|---|
| 明確性 | 25点 | 目的・スコープ・成果物が明確か |
| 網羅性 | 25点 | 前提・制約・リスク・依存が書けているか |
| 実行可能性 | 25点 | タスクの順序・担当・判断基準が分かるか |
| 一貫性 | 25点 | 矛盾・重複・用語の揺れがないか |
合計 100 点。各軸は 0〜配点で付与する。内訳はプロジェクトに合わせて SKILL 内で調整してよい。
出力テンプレート
自己評価ブロック
## Plan 自己評価
| 観点 | 得点 | 理由(短く) |
|------|------|--------------|
| 明確性 | /25 | |
| 網羅性 | /25 | |
| 実行可能性 | /25 | |
| 一貫性 | /25 | |
| **合計** | **/100** | |不足点タスクリスト
## 不足点タスクリスト
- [ ] (優先度 高)〜
- [ ] (優先度 中)〜
- [ ] (優先度 低)〜改善後は該当項目を - [x] に更新する。
最終確認
## 最終確認
- 矛盾: なし / 残課題: 〜
- 記載漏れ: なし / 残課題: 〜注意事項
- パスはスラッシュ表記(例:
docs/design.md)を使う。 - 用語は「Plan」「設計書」「自己評価」「不足点」「矛盾」「記載漏れ」で統一する。
- 設計書が複数ある場合は Plan を主とし、他は必要に応じて整合させる。