用途:在 agents 库中审查拉取请求(PR),适用于“review PR”“code review”“gh pr view”等场景。
依赖与运行环境:需要 gh CLI 和 git;PR 分支需在本地检出以获得权威 diff;工作目录为仓库根目录(即该 .claude 的父目录)。
主要命令: gh pr view <PR_NUMBER> --json title,number,body,files,commits,additions,deletions,changedFiles,baseRefName,headRefName,author,labels gh pr diff <PR_NUMBER> git diff $(gh pr view <PR_NUMBER> --json baseRefName --jq '.baseRefName') -- $(gh pr view <PR_NUMBER> --json files --jq '[.files[].path] | join(" ")')
Diff 优先级:gh pr diff 在最近推送后可能过期,需与本地 git diff <base> 及 Read 工具读取的变更文件交叉核对;出现分歧时以本地 git diff 和文件内容为准。
审查清单:提交信息需符合 type: message 格式(由 commitizen 强制),有效类型为 feat、fix、improvement、docs、style、refactor、perf、test、build、ci、chore、revert;PR 采用 squash 合并,PR 标题会成为提交信息,不符合约定需标记;新行为须用 feat: 前缀,破坏性变更需主版本号提升。PR 标题和正文须包含 GUS 工作项编号,正文中工作项须前后加 @ 且无空格(如 @W-12345678@)。每个新增 .ts 文件须包含 Apache 2.0 许可证头。TypeScript 质量方面:不得使用 any 类型(仓库使用 tsconfig-strict-esm),公共 API 应显式标注类型,新导出须加入 src/index.ts。代码正确性需关注回归与边界情况;错误不得被吞掉,重新抛出的错误须将原始错误设为 cause;错误信息须包含建议修复或明确失败原因;API 边界需做输入校验。安全方面不得硬编码或泄露凭据、令牌、密钥或 PII。用户可见字符串应放在 messages/ 而非源码中,新消息须在 messages/ 下相应 .md 文件中有条目。新代码应在 test/ 中有对应测试(镜像 src/ 结构),单元测试用 .test.ts 后缀,NUT 用 .nut.ts,新代码覆盖率目标 95%+;测试应使用 @salesforce/core/testSetup 的 TestContext 和 MockTestOrgData;HTTP 调用须用 test/mocks/ 中的 fixture 模拟,单元测试不得调用真实 org;断言使用 Chai(expect 而非 assert)。新依赖须为 Salesforce 批准的包,新增 npm 依赖需在库中给出充分理由。Agent 特定模式:AgentBase、ScriptAgent、ProductionAgent 构成类层次,新 agent 类型应继承 AgentBase;Agent 类的静态方法(create、list、init)是公共入口,签名应保持稳定;模板文件位于 src/templates/。
输出格式:先列发现,按严重程度排序(Critical → High → Medium → Low),每条发现引用文件路径和行号,必要时设 Questions/Assumptions 部分,最后给出简要总结。
限制:资料未提供该技能的安装方式、收费或平台信息。