关于 full-review-pr
用于协调单个 Pull Request 结构化审查的技能,由 Moderator 和专门 Analyst 验证代码质量、项目规则及关联 Jira 需求。它先展示拟议评论供用户确认,只发布获准的评论。
主要功能
- 01检查严重缺陷与回归
- 02核查重复代码和项目规范
- 03评估关联的 Jira 需求
- 04评论发布前须经用户确认
- 05发布前重新检查讨论
适用场景
- 01合并前审查 Pull Request
- 02核对 PR 是否符合 Jira 验收条件
- 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
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
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.