mcpField
P
pr

pr

github.com/akshay-diwadkar開発173 回インストール今日更新
リポジトリ

pr について

差分、正式な要件、記録済みの検証結果に基づいて PR を準備・作成するスキルです。公開前に確認済みの全文へのユーザー承認を求め、マージやブランチコードの変更は行いません。

主な機能

  1. 01差分と要件に基づく説明作成
  2. 02検証コマンドと結果の記録
  3. 03根拠や証拠の不足を草稿で確認
  4. 04PR 作成前にユーザー承認を要求
  5. 05マージやブランチコードの変更なし

活用シーン

  1. 01完了した変更の PR 説明を作成
  2. 02申告したテストの実行有無を確認
  3. 03全文を確認してから PR を作成

インストール

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

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

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

同梱ファイル

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

skill-protocol.json
agents/
openai.yaml
references/
description-guide.md
update.md
scripts/
_diagnostic_contract.py
_skill_protocol_runtime.py
check_description.py
cli.py
pr_contract.py
publish_pr.py
record_run.py

詳細

PR

レビュー担当者に必要な情報のうち、差分からは分からないものを書き、機械的にチェックし、ユーザーが正確な文章を確認してから PR を作成します。マージ、承認、ブランチのコード編集は決して行わないでください。

根拠

  1. ベースの参照先（例：origin/main）を固定し、git diff <base>...HEAD の全体を読みます。gh pr view <branch> --json state が OPEN を示す場合は、先に更新を読んでください。
  2. 根拠となる情報を確認します。リンクされた Issue（gh issue view <n>）または封印された .first-four-hours/blueprints/*/blueprint.md です。その意図、決定事項、受け入れ基準にリンクするか、それらを引用してください。二つ目の信頼できる情報源として書き直してはいけません。どちらもない場合は、その旨を伝え、ユーザーから意図を確認してください。
  3. プッシュするコミットのクリーンなワークツリーから、主張する各検証を record 経由で実行します。各 arg は argv の要素を一つずつ指定してください。
python <skill-root>/scripts/cli.py --repo-root <repo> --input runs=<runs.jsonl> \
  --input arg=<argv0> --input arg=<argv1> --format json record

その結果に、実際の exit_code と引用する command 文字列が示されます。

下書き

説明ガイドを読み、リポジトリの外で、<runs.jsonl> の隣に下書きを書きます。

チェック

python <skill-root>/scripts/cli.py --repo-root <repo> --input draft=<draft.md> \
  --input runs=<runs.jsonl> --input base=<base> --format json check

下書きの診断内容を一つずつ修正するか、不足している実行記録を追加し、通過するまで再実行してください。このスクリプトがチェックするのは、根拠、記録された実行、Mermaid の形式だけです。文章の品質はチェックしません。内容とすべての図の判断はあなたに委ねられています。

確認して作成

タイトルとチェック済みの下書き全文をユーザーに提示し、PR を作成するかどうかを尋ねます。ブランチのアップストリームが存在しない、または遅れている場合は、先にブランチをプッシュするかどうかも尋ねてください。明示的な「はい」だけが作成を許可します。返答がない場合や、それ以前の承認は許可になりません。「はい」の後、必要であればプッシュしてから、次を実行します。

python <skill-root>/scripts/cli.py --repo-root <repo> --input draft=<draft.md> \
  --input runs=<runs.jsonl> --input base=<base> --input title=<title> \
  --input confirm=<body_sha256 from check> --format json publish

confirm は、ユーザーが確認した正確な文章にひも付きます。編集した場合は、再度チェックし、提示して、確認を求めてください。PR の URL を報告します。この結果に合った、任意の次のステップを一つ添えてください。必要なリポジトリ、Issue、PR、成果物を明記した、フェンス付きの自己完結型プロンプトを提示するか、不要であると伝えます。「はい」があった場合に限り、プロンプト内で指定したスキルを使って開始します。ただし、charter、diagnose、または ticket のステップは、ユーザーが /<skill> コマンドとして実行します。PR をマージしてはいけません。

コメント

Markdown 対応