full-review-pr について
1件のプルリクエストを体系的にレビューするスキルです。Moderatorと専門Analystがコード品質、プロジェクト規則、関連するJira要件の観点から指摘を検証します。コメント案をユーザーに提示し、承認されたものだけを投稿します。
主な機能
- 01重大なバグとリグレッションの確認
- 02重複コードとプロジェクト規約の確認
- 03関連するJira要件の評価
- 04コメント投稿前のユーザー承認
- 05投稿前の議論の再確認
活用シーン
- 01マージ前のプルリクエストレビュー
- 02Jiraの受け入れ条件との照合
- 03ユーザー承認済みコメントのみの投稿
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ sztadii/ agent-skills --skill full-review-prインストール後、Claude Code で/full-review-prを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/analyst.mdmoderator.mdpr-comments.mdREADME(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
Full Review PR
Scope
Review one PR once and publish only the comments the user accepts. The subject is the PR named by the user or inferred from context. A Moderator gives four fixed categories to eight Analysts, one Codex and one Claude per category, and turns their reports into validated findings:
- Critical bugs: defects, regressions, data loss, security holes and broken contracts the PR introduces.
- Duplication: new code that repeats existing helpers, components, patterns or other code in the PR without need.
- Project rules: inconsistencies with the repository's instructions, conventions and patterns already in use.
- Jira requirements: whether the PR meets the linked Jira task's requirements and acceptance criteria. Only when the PR relates to a Jira task; otherwise this category and its two Analysts are skipped.
Each role's model, effort, responsibilities and output live in its reference file; use them as written unless the user overrides a setting:
Invocation authorizes checking out the PR branch locally, reading code, the PR and its Jira task, and starting the agents above. Publishing a comment requires the user's acceptance of that comment. The agents are read-only. Do not fix code, commit, push, approve, request changes, resolve threads, merge or monitor the PR. Never discard local work. Honor narrower user constraints and pass them to every agent.
Workflow
Agents start with no parent history, so every brief must be self-contained:
include the subject, constraints, relevant context and the absolute path of the
role's reference file, and tell the agent to read it first. The Moderator also
needs the absolute path of the Analyst's file to pass it down. In T3 Code, check
orchestrator_capabilities once per thread and start agents with
delegate_task using the provider, model and options from the reference file;
follow each task's next without polling.
Review
- Identify the PR; ask if it is missing or ambiguous. If it is merged or closed, report that and stop. Read its title, description, base, head, diff, repository instructions and conventions.
- Check out the PR branch locally (
gh pr checkout <number>) and record the head SHA. If the working tree has uncommitted changes, stop and ask the user instead of stashing or discarding them. - Look for a Jira key in the PR title, description, branch name and commits. If one is found, read the issue (description, acceptance criteria, relevant comments and subtasks) through the available Atlassian tools. If the issue cannot be read, tell the user and continue without category 4.
- Start the Moderator (
role: "review", shared checkout) with the PR, head SHA, diff, repository rules and Jira requirements if any. It runs the Analysts in parallel according to its reference file and returns validated findings. Do not start the Analysts yourself.
Ask
If there are no findings, report that and stop without publishing. Otherwise
draft one comment per finding as in PR comments
and show each with a short ID (C1, C2, …), its category, location, exact
text and evidence. Ask the user to accept all, some or none, and wait. Never
publish rejected or unanswered drafts.
Publish
- Right before publishing, fetch the PR's review comments, review bodies and discussion anew, including resolved and outdated threads. Skip each accepted comment that raises the same or a closely related problem as an existing comment by anyone, and keep it for the report with a link to that comment.
- Publish the remaining accepted comments, with any user edits, in one COMMENT review against the recorded head SHA as in PR comments. If the head moved, recheck that each comment still applies and tell the user about dropped ones.
- Verify the published bodies and URLs, then stop.
Result
Report the reviewed PR and head SHA, the checked-out branch, the Jira task or that none was linked, and the categories covered with any unavailable Analyst. List each finding with its ID, category, location and status: published (with URL), rejected, or skipped because someone already left a similar comment (with a link to it). State that no approval or change request was submitted and the PR is not monitored. If the workflow stopped, say which stage completed and what blocks the rest.