mcpField
E
explain-pr

explain-pr

github.com/carlitose開発042 回インストール2 週間前に更新
リポジトリ

explain-pr について

検証済みの検証バンドルからプルリクエスト本文を作成するスキルです。証拠に基づく変更説明と本文の検証を行い、コードレビューやマージ判断、プロバイダー操作は担当しません。

主な機能

  1. 01必須のPRセクションを生成
  2. 02変更前後のMermaid図を掲載
  3. 03証拠のIDと判定をそのまま使用
  4. 04生成した本文を検証
  5. 05依頼時にPR本文を更新して読み戻し

活用シーン

  1. 01検証済み証拠に基づくPR説明の作成
  2. 02PR本文が契約を満たすか確認
  3. 03依頼されたPR本文更新の公開と再検証

インストール

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

$npx skills add https://github.com/carlitose/agent-skills --skill explain-pr

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

同梱ファイルagents/openai.yaml

詳細

PR の説明

担当範囲：すでに検証済みのバンドルから PR 本文をレンダリングします。コードのレビュー、証拠の再解釈、主張の上限の引き上げ、マージの承認、統合の判断は行いません。

必須セクション、可視性のルール、表現の上限は、正規の Verification Record およびその バリデーターに従います。

入力

以下を必須とします。

  • PR 識別子、または準備済みのブランチ／ベース／ヘッドのコンテキスト
  • 正規化されたチケットの概要
  • 固定済みの CandidateRef と、観測されたプロバイダー PR のヘッド SHA
  • 検証済みの検証バンドル
  • 簡潔なコードマップまたは差分の事実

バンドルがない、または古い場合は拒否します。シミュレーション済み、スキップ済み、またはゲートで阻止された証拠を、より強い説明に置き換えてはいけません。

ticket-autopilot から呼び出された場合は、ランナーからの render-required リクエスト全体も必須です。その render_request_hash と expected_head_sha を文字どおり保持し、どちらの識別情報も再計算したり置き換えたりしてはいけません。

レンダリング

次の内容を含む、コントラクトで必須とされる見出しを出力します。

  • 何を、なぜ変更したか
  • 変更前／変更後の動作
  • コードマップ
  • テストと分類済みの証拠
  • 未解決／失敗したゲートと残る制限
  • レビュアー向けチェックリスト
  • 変更前／変更後を示す Mermaid 図をちょうど 1 つ

バンドルに含まれる ID と処置内容をそのまま使い、各記述を機械とレビュアーが追跡できるようにします。禁止された表現を加えたり、プロバイダーの機能を推測したりしてはいけません。

レンダリングした本文を次の値で検証します。

VERIFICATION_AUDIT_ROOT は、リポジトリの cwd ではなく、スキルカタログから解決された verification-audit スキルルートの絶対パスです。

python3 -B "$VERIFICATION_AUDIT_ROOT/scripts/verification_contract.py" \
  validate-pr <bundle.json> <body.md> --pr-head-sha <observed-sha>

検証に失敗した場合は、レンダリングだけを修正します。バンドルの意味上の問題は verification-audit に戻し、ヘッドが変更された場合は上流の証拠を新たに取得する必要があります。

ユーザーまたはスケジューラーが公開を要求した場合は、選択されたプロバイダーアダプターを通じて PR 本文のみを更新し、読み戻して、観測された本文とヘッドを再検証します。本文、検証結果、プロバイダーでの観測結果、および公開エラーがあればその内容を返します。マージは決して行いません。

ランナーに引き渡す際は、render_request_hash、expected_head_sha、 rendered_body、同じ検証済みの verification_bundle、および絶対パスの verification_audit_root を返します。コンテンツアドレス指定されたアーティファクトの永続化、プロバイダーの変更と読み戻し、pr-open に到達可能かどうかの判断は、このスキルではなくランナーが行います。

コメント

Markdown 対応