post-pr-review

name	post-pr-review
description	PR レビュー結果を1回の API コールで1つの Review として GitHub に投稿する。複数のインライン指摘や総括コメントを含むレビューを投稿する場合は必ずこの skill を使うこと。`gh pr comment` や `gh pr review` を使った個別投稿は禁止。

post-pr-review skill

PR レビュー結果を 1回の API コールで「1つの Review」として投稿 する手順を提供する skill。 人間レビュアーの "Submit Review" と同じ構造で投稿する。

守ること

• レビュー結果は 必ず1回の API コール で投稿する。
• 個別投稿系のツール (mcp__github_inline_comment__create_inline_comment、gh pr comment 等) は 使わない。
• event は 常に COMMENT。APPROVE / REQUEST_CHANGES は使わない (Bot がマージブロックや承認権を持つことを避けるため)。
• インラインコメントの本文フォーマット (重要度ラベル等) は caller のレビュー方針に従う。本 skill は手続きのみを担い、レビュー文面の規約は規定しない。
• 総括 body の先頭には AI 自動投稿マーカーを必ず付与する (詳細は「手順 1」参照)。認証主体が人間 PAT でも投稿内容は AI 生成であることを明示するため。caller 側で事前に付与する必要はなく、本 skill が一律に prepend する。エージェント名 (Claude Code / Codex / Cursor 等) はマーカーに含めない (本 skill は複数の AI エージェントから呼ばれうる前提)。

入力 (caller から prompt 経由で渡される想定)

• OWNER / REPO / PR_NUMBER: 対象 PR の識別情報
• レビュー本文 (総括 + インラインコメント配列)
• COMMIT_ID (任意): レビューを紐づける head commit の SHA。caller 側で gh pr view ... --json commits の末尾 oid を取得できる場合は渡すことを推奨。指定があれば手順 1 の JSON および手順 2 の API リクエストに含める (force-push / rebase で行ズレが起きた際の誤コメント防止に有効)。未指定なら省略 (GitHub 側で最新 commit を採用)。

手順

1. body 先頭に AI 自動投稿マーカーを付与し、/tmp/review.json を Write ツールで書き出す

heredoc や cat リダイレクトは使わず、必ず Write ツールで書く。

caller から渡された総括本文 (Markdown 可) はマーカーと区切り線 (---) の後ろに連結する。指摘なしの場合 (comments が []) も同じマーカーを付ける。

マーカー文言 (エージェント非依存・固定):

> **[AI 自動投稿]** このレビューは AI エージェントによって自動生成されました。レビュー内容の判断は AI が行っています。

---

<caller から渡された総括本文 (指摘なし時は「特に指摘なし」相当)>

スキーマは以下のとおり (body は上記マーカー込みの文字列):

{
  "commit_id": "9f8e7d6c1a2b3c4d5e6f7890abcdef1234567890",
  "body": "> **[AI 自動投稿]** このレビューは AI エージェントによって自動生成されました。レビュー内容の判断は AI が行っています。\n\n---\n\n総括コメント本文 (Markdown可)",
  "event": "COMMENT",
  "comments": [
    {
      "path": "src/example.ts",
      "line": 42,
      "side": "RIGHT",
      "body": "[should] ここの処理は..."
    },
    {
      "path": "src/example.ts",
      "start_line": 50,
      "start_side": "RIGHT",
      "line": 55,
      "side": "RIGHT",
      "body": "[must] この複数行ブロックは..."
    }
  ]
}

• 単一行コメントは path / line / side を指定する。
• 複数行範囲のコメントは上記に加えて start_line / start_side を併用する (start_line は line より前の行)。
• commit_id は caller から COMMIT_ID が渡された場合のみ含める (詳細は「入力」参照)。
• 指摘がない場合: body はマーカー + 区切り線 + 「特に指摘なし」相当の文言、comments は []、event は COMMENT で投稿する。
• インラインコメント (comments[].body) には個別マーカーを付けない (Review 本文側のマーカーで帰属は十分であり、[must] 等の重要度ラベルとの衝突や冗長さも避けるため)。

2. gh api を1回だけ実行して投稿する

gh api \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  /repos/<OWNER>/<REPO>/pulls/<PR_NUMBER>/reviews \
  --input /tmp/review.json

<OWNER>/<REPO> と <PR_NUMBER> は caller から渡された値で置き換える。