mcpField
A
assess

assess

github.com/akshay-diwadkarテスト・品質174 回インストール今日更新
リポジトリ

assess について

assessは、特定の変更を読み取り専用で評価するスキルです。依頼、権威ある要件、リポジトリのルール、証拠を照合し、対象を変更したり承認したりせずに評価結果を作成します。

主な機能

  1. 01対象・ベース・ヘッドの特定
  2. 02要件と変更証拠の確認
  3. 03blocked・findings・clearの判定
  4. 04評価結果の封印と検査

活用シーン

  1. 01依頼内容に照らしたPull Requestの評価
  2. 02範囲を限定したレビューでの重大な欠陥の発見
  3. 03評価の制約と証拠の記録

インストール

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

$npx skills add https://github.com/akshay-diwadkar/first-four-hours --skill assess

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

skill-protocol.json
agents/
openai.yaml
references/
assess-guidance.md
blueprint-evidence.md
delegation-protocol.md
delta-review.md
publishing.md
pull-requests.md
scripts/
_diagnostic_contract.py
_script_support.py
_skill_protocol_runtime.py
assess_contract.py
check_assessment.py
cli.py
prepare_assessment_workspace.py
publish_findings.py
seal_assessment.py
templates/
assessment-bundle.json

詳細

評価

権限

Assess は、厳密に指定された 1 つのターゲット／ベース／ヘッドを、元のユーザーリクエスト、権威ある要件、利用可能な Blueprint、リポジトリのルール、テスト、ベースの動作と照合します。使用した外部ターゲット、権威ある情報、証拠、証明、診断はすべてスナップショットを取得してください。Git／リポジトリ内の情報には必要ありません。必須の外部情報の最新性が不明な場合、結果は blocked です。

評価は読み取り専用です。ターゲットの修正や編集、マージ、承認、GitHub の変更は行わないでください。実装は Construct が担当し、より広範な不具合／リスクの調査は Diagnose が担当します。assessment.md は結果であり、承認、認定、マージ権限を与えるものではありません。その結果の投稿は check の後に行う別の手順であり、ユーザーが明示的に「はい」と答えた場合に限ります。

評価

このコンテキストでこの変更を書いた、または計画した場合は、他には何も読まずに、Bounded Delegation Protocol に従ってこのステージ全体を新しいコンテキストの担当者に引き継いでください。ほかの委任を行う場合も、まずこれを読んでください。

それ以外の場合は、まず 評価ガイダンス を読み、封印済みの Blueprint がある場合は Blueprint evidence を、以前の評価がある場合は delta review を、ターゲットのプルリクエストのヘッドが現在のリポジトリに存在しない可能性がある場合は pull requests も読んでください。厳密なターゲット／ベース／ヘッド、現在の権威ある情報、ベースの真実、要求された差分を一度だけ確定します。PR の説明文、コメント、監査、以前のレビューを読む前に、権威ある情報から要件を、ベース／ヘッドから変更内容を導き出してください。それらは候補の追加に役立つヒントにはなりますが、候補を除外する根拠にはなりません。

次に、変更の規模にかかわらず、評価方法を決める前に reason を参照し、完全レビューか差分レビューか、対象範囲、深さを決定してください。

作成と封印

最小バンドルテンプレートをスキルとターゲットリポジトリの外にコピーし、ガイダンスに記載されたバンドルフィールドに従って入力してください。デフォルトの判定結果はありません。最初に新しいスラッグを用意してください。封印できるのは、そのスラッグの無視対象ファイル .first-four-hours/assessments/<slug>/assessment.md のみで、既存のファイルを置き換えることはありません。最新性、深さ、準拠性、重大度、指摘事項、制限、Diagnose の必要性、結果はエージェントが判断します。スクリプトが検証するのは、形式、厳密な Git／スナップショットの識別情報と鮮度、位置情報、安全な出力、整合性のみです。

python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
  --input slug=<slug> --format json prepare
python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
  --input bundle=/absolute/assessment-bundle.json \
  --input output=<prepared output_path> --format json run

結果の優先順位は次のとおりです。信頼できる結果を妨げる権威ある情報／証拠／証明が入手不能または矛盾している場合は blocked、それ以外の場合、範囲を限定した評価で見つかった独立して重要な欠陥をすべて報告する場合は findings、それ以外は clear です。assessment.md には簡潔な結果のみを記載します。

完了

python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
  --input output=<prepared output_path> --format json check

封印済みの結果、パス、および各指摘事項の重大度、欠陥、シナリオを、封印された内容どおりに報告してください。それを超える承認や準備状況については主張しないでください。結果が findings で、target がプルリクエストの URL の場合は、publishing を読み、指摘事項の投稿を提案してください。最新の assessment.md が封印され、チェック済みで、提案への対応が済んだら終了してください。最後に、この結果に合った任意の次の手順を 1 つ示してください。必要なリポジトリ、Issue、PR、成果物を明記した、フェンス付きの自己完結したプロンプトを提示するか、次の手順は不要だと伝えてください。「はい」と答えた場合に限り、指定されたスキルを介してその手順を開始できます。ただし、charter、diagnose、または ticket の手順は、ユーザーが /<skill> コマンドとして実行します。

コメント

Markdown 対応