mcpField
P
plan-self-review

plan-self-review

github.com/hrdtbsエージェントワークフロー052 回インストール17 週間前に更新
リポジトリ

plan-self-review について

plan-self-reviewは、作成または更新した計画を確認するエージェントスキルです。明確さ、網羅性、実現可能性、一貫性を採点し、不備の特定と改善を促します。

主な機能

  1. 014項目による計画の採点
  2. 02優先順位付きの不備リスト
  3. 03計画の改善と最終確認
  4. 04形式化されたレビュー出力

活用シーン

  1. 01新しい実装計画のレビュー
  2. 02実行前に更新済み計画を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hrdtbs/agent-skills --skill plan-self-review

インストール後、Claude Code で/plan-self-reviewを入力して読み込まれたか確認します。

詳細

計画の自己レビュー

計画を作成または更新した直後に、このスキルを使用してください。論理的な抜けや曖昧な手順、依存関係の欠落を早期に見つけることで、実行中に問題が連鎖するのを防げます。計画を自己レビューすると、問題に体系的に取り組めるようになり、後で大幅な修正が必要になる可能性を減らせます。

レビュー手順

  1. 計画を採点する(100点満点):以下の基準に基づいて計画を評価します。
    • 明確さ(25点):手順は明確で、簡単に実行できますか?使用するファイルやツールが指定されていますか?
    • 網羅性(25点):タスクに必要なすべての要素が計画に含まれていますか?考慮されていないエッジケースはありませんか?
    • 実現可能性(25点):利用可能なツールとコンテキストで手順を実行できますか?実行に必要な情報は十分にありますか?
    • 一貫性(25点):論理的な矛盾や要素の欠落はありませんか?手順は論理的な順序になっていますか?
  2. 不足点を列挙する:計画で見つかった抜け、漏れ、曖昧な点を優先順位順にタスクリスト(- [ ])で作成します。
  3. 改善する:見つかった不足点を解消するように計画を編集します。適切なツールを使って計画を更新します。
  4. 最終確認:論理的な矛盾や要素の欠落が残っていないことを最終確認します。

出力形式

以下の構成でレビュー結果を提示します。

自己評価スコア:[Score]/100
  • 明確さ:[Score]/25
  • 網羅性:[Score]/25
  • 実現可能性:[Score]/25
  • 一貫性:[Score]/25
不足点
  • [不足点1]
  • [不足点2]
実施した改善
  • [計画に加えた改善について簡潔に説明します]
最終確認
  • [計画に論理的な矛盾がなく、必要な要素がそろっていることを確認します]

例

例1:新しい API エンドポイントを追加する計画のレビュー

初期計画:

  1. 新しいエンドポイントを作成する。
  2. テストを更新する。

自己レビューの出力:

自己評価スコア: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 を更新する手順を追加しました。
最終確認
  • 改訂後の計画は明確かつ網羅的で、対象ファイルと実行する作業が具体的に示されています。論理的にも妥当で、実行に移せる状態です。

コメント