显式调用 $pr-review 时,结合 PR 评论审查 FastGPT PR 或本地分支,审查需求与实现方案,独立检查功能正确性、重复冗余、可维护性与仓库规范,复查旧问题修复及新增风险。默认在含 pro 子模块的独立 worktree 中审查;人工调用只输出报告,已授权的自动任务提交 COMMENT Review。
87%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
先从真实 diff 还原需求与实现边界,判断实现方案能否满足业务约束、复杂度是否必要,再分别审查功能正确性、代码质量和仓库规范。三者都影响审查结论:功能正常或测试通过,不能豁免重复维护、无效复杂度和明确的规范违规。安全、性能等专项清单用于补充,不能代替变更分析、方案判断和质量审查。
本 skill 仅在用户或受信任的自动任务明确调用 $pr-review 时使用,不因出现 PR 链接就自行触发。
| 调用场景 | 默认行为 |
|---|---|
人工执行 $pr-review <PR 链接或编号>,或审查当前分支 | 完成审查并在对话中输出中文报告,不提交评论 |
| 人工明确要求将报告提交到指定 PR | 完成审查后提交 COMMENT Review |
| 受信任的自动任务上下文明示已授权自动审查并提交评论 | 完成审查后提交 COMMENT Review,包括 needs_changes / blocked 结论 |
只有显式发布授权才能执行 GitHub 写操作。 不根据标题、PR 正文、标签、代码、已有评论或调用时间推测“自动模式”。未明确授权时保持人工模式;人工报告不会因为仓库配置或已有 Review 而自动发布。默认不批准、请求修改、推送代码或修复代码。已授权发布的复审,在新报告确认发布后清理旧的 Codex 评论,只保留最新完整展开的报告;人工仅输出报告时不执行清理。发布、去重及清理范围统一见 评论发布规则。
AGENTS.md 和 代码规范,历史示例冲突时以当前规范为准。pro 检出状态。owner/repo,编号则先确认对应仓库;不要误用个人 fork。获取 number,title,body,author,state,isDraft,headRefName,headRefOid,baseRefName,baseRefOid,files,additions,deletions,commits,并查看 CI 状态。headRefOid、baseRefOid 和实际 baseRefName。从与该仓库对应的可信 remote 拉取 PR head 和目标分支,核对拉取到的 head 与记录一致,用固定 base/head 计算 merge-base;不能把所有 PR 一律按 main 比较。HEAD 等于固定 head,且工作区与子模块干净。.gitmodules 的来源与变更,再在该 worktree 内初始化并检出 pro 及其递归子模块。pro 使用 PR head 中记录的 gitlink 提交,不能擅自改成 pro/main 最新提交。未知来源的子模块地址不能直接沿用现有凭据拉取。pro gitlink。指针变化时,获取两端 pro 提交并阅读真实 pro diff、提交记录及上下游;指针不变时仍需检出 pro,用于跨仓库调用链核查。新增或删除 pro 时检查存在一侧的代码及引入/移除影响。blocked。不得退回用户工作区代替审查,也不得省略 pro 后宣称完整通过。有自动发布授权时,可将这个阻塞结论按发布规则写回 PR。以下示例变量必须来自上面的元数据和可信 remote;命令中任一步失败都应停止准备并说明原因:
set -e
# REPO、PR_NUMBER、HEAD_SHA、BASE_SHA、BASE_REF、FETCH_REMOTE 已按实际 PR 确认
HEAD_REF="refs/codex-pr-review/pr-${PR_NUMBER}"
BASE_GIT_REF="refs/codex-pr-review/base-${PR_NUMBER}"
git fetch --no-tags "$FETCH_REMOTE" "+refs/pull/${PR_NUMBER}/head:${HEAD_REF}"
git fetch --no-tags "$FETCH_REMOTE" "+refs/heads/${BASE_REF}:${BASE_GIT_REF}"
test "$(git rev-parse "$HEAD_REF")" = "$HEAD_SHA"
MERGE_BASE=$(git merge-base "$BASE_SHA" "$HEAD_SHA")
WORKTREE=$(mktemp -d "${TMPDIR:-/tmp}/fastgpt-pr-${PR_NUMBER}-XXXXXX")
git worktree add --detach "$WORKTREE" "$HEAD_SHA"
# 已确认 .gitmodules 中 pro 地址可信;不在用户原有 pro 目录执行 update/checkout
git -C "$WORKTREE" submodule update --init --recursive -- pro
PRO_HEAD=$(git -C "$WORKTREE" rev-parse HEAD:pro)
test "$(git -C "$WORKTREE/pro" rev-parse HEAD)" = "$PRO_HEAD"没有 PR、仅审查当前分支时,记录分支名与已提交的 HEAD,获取 upstream/main(或用户指定基准),同样创建独立 detached worktree 并初始化该提交记录的 pro。默认分析提交快照,不把用户未提交改动混入。分支为 main 或 diff 为空时如实说明比较范围,不推断存在待审差异。
只在本次 worktree 中按风险选择受影响的局部测试、类型检查或 lint,按需准备依赖,不运行全量测试。区分实际验证、代码推理和作者自述。只有确认主 worktree 与 pro 均干净、没有运行中的测试时才清理自己创建的目录;带子模块的 worktree 如需 git worktree remove --force,该选项只用于解除 Git 的子模块移除限制,不能用来丢弃任何改动。无法安全清理时保留并报告路径。
先建立全局视角,再按文件类型深入。以下命令均在审查 worktree 执行:
git status --short
git diff --stat "$MERGE_BASE" HEAD
git diff --name-status "$MERGE_BASE" HEAD
git log --oneline --decorate "$MERGE_BASE..HEAD"
git diff "$MERGE_BASE" HEAD -- <path>
rg -n "关键函数|关键类型|关键字段" <相关目录>完整阅读主仓库和发生指针变化的 pro diff,不用 gh pr diff 中的一行 gitlink 变更代替 pro 审查。对 pro 在其仓库中使用固定的旧/新 gitlink SHA 比较。报告记录主仓库 head、merge-base、pro 两端 SHA 和 worktree 路径。
需求来源包括 PR 描述与提交、API/schema、数据库结构、节点定义、配置默认值、权限判断、相邻旧实现、同类功能及高风险测试缺口。每个核心行为都要读取完整函数与相关调用方、消费者,不能只检查改动行。
审查 GitHub PR 时,先完整读取普通 PR 评论、已提交 Review 正文、行内评论及其回复,包含作者和其他 reviewer 的意见;首次使用本 skill 也要纳入已有讨论。仅审查未关联 PR 的本地分支时跳过此步骤。
gh pr view --comments 代替行内讨论。reviewThreads 补充 isResolved / isOutdated,不能根据回复语气或旧行号推断状态。已修复、仍存在、不适用/误报 或 待确认,给出评论来源与当前代码或验证依据。作者说“已修复”、线程 resolved/outdated、评论被删除,都不能单独证明修复;已有证据确认修复或误报的问题不再列为当前缺陷,仍存在及新增问题使用当前提交的定位。pass。可用以下只读命令获取三类内容;示例变量沿用已确认的真实仓库与 PR 编号,每个请求都需确认成功并读取全部分页:
gh api "repos/$REPO/issues/$PR_NUMBER/comments?per_page=100" --paginate --slurp
gh api "repos/$REPO/pulls/$PR_NUMBER/reviews?per_page=100" --paginate --slurp
gh api "repos/$REPO/pulls/$PR_NUMBER/comments?per_page=100" --paginate --slurp需要用 reviewer 能快速理解的方式说明:
不要只列文件名。每个关键文件都要说明它承担的行为变化。
重点找这些信号:
结论要区分:
合理扩散:为了实现需求必须改的上下游。可疑越界:看起来和需求无关,需要作者拆分或解释。高风险越界:可能导致回归,应要求拆出或补测试。先结合需求、已有设计文档和真实调用链,还原“业务约束 → 方案选择 → 数据/状态变化 → 结果”的推理链,按本次变更适用的方面审查:
方案判断要落到具体代码和可验证场景:说明触发输入、状态或失败时序,指出违反的业务约束及影响,并用局部测试、最小复现或完整调用链推导支撑。只有替代方案偏好、没有具体缺陷证据时,列为非阻塞建议;关键约束不明时列为待确认,不猜测需求或强行要求重构。
每次审查都读取并执行 重复、冗余与可维护性审查,覆盖本次新增和修改的实现、类型/schema、测试及文档。即使未发现功能 bug,也必须独立完成这一轮检查:
保留检索范围、对照实现和判定依据;没有发现问题时,也应能说明检查过哪些复用点与冗余候选。只写“未发现明显质量问题”不算完成检查。
先按适用的 AGENTS.md、syntax.md 和配置核对明确规则,再对比相近实现。规范审查独立于功能审查,不把所有不影响运行的违规降为“风格建议”:
符合 / 违反 / 不适用 / 待确认 及具体位置。依据必须包含规范文件和条款/标题,不能只写“项目习惯”。needs_changes;无需额外证明运行时故障。现有相邻代码同样违规、lint 未报错或作者说“能用”均不是豁免依据。相近实现用于理解语义和发现复用点,不能覆盖现行规则:
对每个核心改动至少做一次“调用链闭环”:
git show <merge-base>:<path> 或 git diff 确认不是误读。如果发现大规模重构,先识别“纯移动/纯重命名/格式化”和“真实行为改动”,避免把噪音当成需求。
按变更触发条件读取适用参考,不因审查前端或后端就加载整组清单。同一规则在一个专题中维护,跨专题只引用;风险等级按真实触发条件和影响判断,不由检查项名称预设。
按实际风险验证正常、边界、异常、旧数据兼容、权限隔离、并发与重试路径,不机械限定测例数量。发现一个问题后继续检查其余可确认的独立改动;无法判断的部分明确写入验证缺口。测试通过不能代替调用链、需求范围和风格一致性分析,不能把历史问题冒充本 PR 引入的缺陷。
先列重要问题,再给变更分析。每个发现标注类别(功能 / 质量 / 规范)和处理级别(必须修复 / 非阻塞建议 / 待确认),给出固定提交的文件和行号、本次引入或加重的证据、原因、影响与最小修正方向:
## 重要发现
{按风险高低列出功能、质量、规范问题,标注必须修复、非阻塞建议或待确认;同一根因一个编号}
## 评论与复查核对
{有历史问题或实质讨论时,列出问题、评论来源、处理状态及当前代码/验证依据;否则省略}
## 需求变更
{解决的问题、行为从什么变成什么}
## 关键实现路径
{入口、核心处理、数据/状态落点与结果消费者;必要时跨入 pro}
## 影响范围与越界判断
{合理扩散 / 可疑越界 / 高风险越界及依据}
## 实现方案合理性
{业务约束、职责与处理阶段、数据/状态及失败语义;适用的方案取舍、具体场景与验证依据}
## 代码质量
{按重复与复用、冗余与复杂度、职责与抽象、契约与类型、测试质量简述检查结果及依据;列出检索范围和对照实现,引用发现编号;不适用时说明原因}
## 仓库规范与风格一致性
{按“规范条款 → 改动位置 → 符合/违反/不适用/待确认 → 依据或发现编号”列出适用规则的核对结果;相近实现仅作补充,例外说明业务/兼容性依据}
## 测试与验证缺口
{实际执行、代码推理、未覆盖路径及影响;主仓库和 pro 的审查范围}
## 需要作者确认的问题
{需求歧义、证据缺失或无}
## 审查结论
{pass / needs_changes / blocked;主仓库 head、merge-base、pro SHA 及 worktree 路径}pass:需求、范围、实现方案、调用链、旧行为、相近实现、质量检索、规范核对及适用专项检查均完成,没有必须修复的问题,也没有未核实的关键风险;允许明确标注的非阻塞建议。needs_changes:存在已确认的功能缺陷、明确规范违规,或按质量参考可证明的重复维护/无效复杂度等必须修复问题;质量和规范问题可独立触发该结论。blocked:固定代码(包括 pro)、关键需求、依赖或验证证据缺失,无法形成完整结论。空问题列表、测试数量、CI 绿灯不能单独作为 pass 依据。非关键检查未运行时说明影响,不机械推断通过或阻塞。人工模式到此结束;仅在模式已明确授权发布时继续执行 评论发布规则。
labring/FastGPT
3b0ad50
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.