kyosei

コマンドの実行方法

このスキルはnode <プラグインルート>/dist/bin/*.js形式でヘルパーコマンドを実行します。 Claude Codeはコマンド例中の変数CLAUDE_PLUGIN_ROOTの参照を絶対パスへ展開しますが、 展開されず文字通りのまま残っている環境(OpenCodeなど)ではこの形式は動きません。 その場合は代わりにPATH上のget-review-infoとsubmit-reviewを同じ引数で実行してください。

get-review-infoでの情報の取得

以下のコマンドでレビューに必要な情報を取得して、 用途別のファイルに書き出します。

node ${CLAUDE_PLUGIN_ROOT}/dist/bin/get-review-info.js $ARGUMENTS

標準出力にはレビュー情報自体ではなく、 書き出したファイルの絶対パスを持つJSONが1行だけ返されます。 出力をtailやパイプなどで加工せず、 JSON全体をそのまま受け取ってください。

以下は出力例です。

{
  "context": "/run/user/1000/coding-agent-work/kyosei/review-info-example/context.json",
  "patch": "/run/user/1000/coding-agent-work/kyosei/review-info-example/changeset.patch",
  "commits": "/run/user/1000/coding-agent-work/kyosei/review-info-example/commits.log",
  "changesetMetadata": "/run/user/1000/coding-agent-work/kyosei/review-info-example/changeset-metadata.json",
  "conversation": "/run/user/1000/coding-agent-work/kyosei/review-info-example/conversation.json",
  "previousReview": "/run/user/1000/coding-agent-work/kyosei/review-info-example/previous-review.json",
  "incrementalChangeset": "/run/user/1000/coding-agent-work/kyosei/review-info-example/incremental-changeset.json"
}

返されたパスのファイルをReadツールで直接読んでください。 レビュー情報を1つのJSONへ結合したり、 一部を取り出すためにシェルコマンドで加工したりしないでください。

パスJSONの解釈

context

context.jsonへのパスです。

context.outputフィールドで出力先を判別します。

"github"

GitHub出力。 結果はGitHub PRにインラインコメントとして投稿されます。 hostとpr(owner, repo, prNumber)が含まれます。

"local"

ローカル出力。 結果はターミナルに直接出力されます。 ブランチに紐付くPRが特定できた場合はprが含まれます。

patch

レビュー対象の差分をdiffフォーマットで保存したchangeset.patchへのパスです。

commits

コミットログを保存したcommits.logへのパスです。

changesetMetadata (headCommitIdが存在する場合のみ)

headCommitIdを保存したchangeset-metadata.jsonへのパスです。 主にGitHub出力時に含まれます。

conversation (PRが特定できた場合のみ)

PRの既存コメント・レビュー情報を保存したconversation.jsonへのパスです。 GitHub出力モードでは常に含まれます。 ローカル出力モードでもブランチに紐付くPRがあれば含まれます。 PRが特定できない場合はパスJSONから省略されます。

トップレベルにPR自体の情報(title, body, author, urlなど)があり、 以下の3つのサブフィールドがあります。