pr-diff-comment

name	pr-diff-comment
description	参考にした既存実装と今回実装の差分を比較し、GitHub Pull Request の特定コード位置に review comment として投稿する。Codex/Claude/Pi agent から `gh` CLI ベースで使う時に使用
argument-hint	--repo <owner/repo> --pr <number> --reference-path <path> --implementation-path <path> --comment-path <path> --line <number> [--dry-run]

PR diff comment skill

呼び出し側が渡した既存実装と今回実装の差分を作り、GitHub Pull Request の特定コード位置に review comment を投稿する skill です。

使いどころ

• 参考にした既存実装との差分を PR の特定コード位置に紐づけて残したいとき
• Files changed 上の対象行に紐づく review comment を投稿したいとき
• 比較対象を自動探索せず、呼び出し側で明示的に渡せるとき

前提

• gh CLI が使えること
• 対象 PR へ review comment できる権限で gh auth login 済みであること
• 比較対象のファイルは呼び出し側が明示的に渡すこと
• comment 対象の path と line は呼び出し側が明示的に渡すこと

実行方法

python3 ~/.claude/skills/pr-diff-comment/scripts/post_pr_diff_comment.py \
  --repo owner/repo \
  --pr 123 \
  --reference-path path/to/reference.sql \
  --implementation-path path/to/implementation.sql \
  --comment-path path/in/pr/file.sql \
  --line 42

Codex からは symlink 後に以下でも実行できます。

python3 ~/.codex/skills/pr-diff-comment/scripts/post_pr_diff_comment.py \
  --repo owner/repo \
  --pr 123 \
  --reference-path path/to/reference.sql \
  --implementation-path path/to/implementation.sql \
  --comment-path path/in/pr/file.sql \
  --line 42

Pi agent からは以下を使います。

python3 ~/.pi/agent/skills/pr-diff-comment/scripts/post_pr_diff_comment.py \
  --repo owner/repo \
  --pr 123 \
  --reference-path path/to/reference.sql \
  --implementation-path path/to/implementation.sql \
  --comment-path path/in/pr/file.sql \
  --line 42

よく使うオプション

• --reference-label: comment 上で表示する参考元ラベルを上書きする
• --implementation-label: comment 上で表示する実装側ラベルを上書きする
• --comment-path: review comment を付ける PR 上のファイルパス
• --line: review comment を付ける行番号
• --side: RIGHT または LEFT。通常は RIGHT
• --max-diff-lines: comment に含める diff 行数の上限
• --title: comment タイトルを上書きする
• --dry-run: 投稿せず本文だけ標準出力に出す

例

python3 ~/.claude/skills/pr-diff-comment/scripts/post_pr_diff_comment.py \
  --repo eure/metis-dbt \
  --pr 2383 \
  --reference-path models/marts/legacy/foo.sql \
  --implementation-path models/marts/bar.sql \
  --comment-path models/marts/bar.sql \
  --line 18 \
  --reference-label "legacy/foo.sql" \
  --implementation-label "bar.sql" \
  --dry-run

振る舞い

• unified diff を生成する
• 追加行数、削除行数、ハンク数を要約する
• 長い diff は --max-diff-lines を超えた分を省略する
• 差分がない場合もその旨を comment 本文に含める
• 投稿時は対象 PR の head SHA を取得し、指定した path と line に review comment を付ける

注意

• この skill は通常 comment ではなく review comment を投稿する
• comment-path と line は PR の diff 上で有効な位置である必要がある
• LEFT 側や複数行 comment などの細かいケースは初版では簡易対応に留める
• 初版ではファイルパス比較を前提とする