plan-self-review について
plan-self-reviewは、作成または更新した計画を確認するエージェントスキルです。明確さ、網羅性、実現可能性、一貫性を採点し、不備の特定と改善を促します。
主な機能
- 014項目による計画の採点
- 02優先順位付きの不備リスト
- 03計画の改善と最終確認
- 04形式化されたレビュー出力
活用シーン
- 01新しい実装計画のレビュー
- 02実行前に更新済み計画を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hrdtbs/ agent-skills --skill plan-self-reviewインストール後、Claude Code で/plan-self-reviewを入力して読み込まれたか確認します。
詳細
計画の自己レビュー
計画を作成または更新した直後に、このスキルを使用してください。論理的な抜けや曖昧な手順、依存関係の欠落を早期に見つけることで、実行中に問題が連鎖するのを防げます。計画を自己レビューすると、問題に体系的に取り組めるようになり、後で大幅な修正が必要になる可能性を減らせます。
レビュー手順
- 計画を採点する(100点満点):以下の基準に基づいて計画を評価します。
- 明確さ(25点):手順は明確で、簡単に実行できますか?使用するファイルやツールが指定されていますか?
- 網羅性(25点):タスクに必要なすべての要素が計画に含まれていますか?考慮されていないエッジケースはありませんか?
- 実現可能性(25点):利用可能なツールとコンテキストで手順を実行できますか?実行に必要な情報は十分にありますか?
- 一貫性(25点):論理的な矛盾や要素の欠落はありませんか?手順は論理的な順序になっていますか?
- 不足点を列挙する:計画で見つかった抜け、漏れ、曖昧な点を優先順位順にタスクリスト(
- [ ])で作成します。 - 改善する:見つかった不足点を解消するように計画を編集します。適切なツールを使って計画を更新します。
- 最終確認:論理的な矛盾や要素の欠落が残っていないことを最終確認します。
出力形式
以下の構成でレビュー結果を提示します。
自己評価スコア:[Score]/100
- 明確さ:[Score]/25
- 網羅性:[Score]/25
- 実現可能性:[Score]/25
- 一貫性:[Score]/25
不足点
- [不足点1]
- [不足点2]
実施した改善
- [計画に加えた改善について簡潔に説明します]
最終確認
- [計画に論理的な矛盾がなく、必要な要素がそろっていることを確認します]
例
例1:新しい API エンドポイントを追加する計画のレビュー
初期計画:
- 新しいエンドポイントを作成する。
- テストを更新する。
自己レビューの出力:
自己評価スコア:40/100
- 明確さ:10/25(編集するファイルとエンドポイントの内容が指定されていません)
- 網羅性:10/25(ドキュメントの更新やエラー処理の詳細が不足しています)
- 実現可能性:10/25(具体性が足りず、追加の確認なしでは実行できません)
- 一貫性:10/25(論理的には問題ありませんが、具体的な手順が不足しています)
不足点
- 新しいエンドポイントの対象ファイルとルートを指定する
- エラー処理の要件を追加する
- 更新するテストファイルと、追加するテストケースを明示する
- API ドキュメントを更新する手順を追加する
実施した改善
- 対象ファイル(
src/api/users.js)とルート(POST /users)を指定するよう計画を更新しました。 - 入力検証とエラー処理を実装するサブステップを追加しました。
- テストファイル(
tests/api/users.test.js)を指定し、エラーケースのテストを明確に求めました。 docs/api.mdを更新する手順を追加しました。
最終確認
- 改訂後の計画は明確かつ網羅的で、対象ファイルと実行する作業が具体的に示されています。論理的にも妥当で、実行に移せる状態です。
コメント
Markdown 対応