用途
code-review-local 用于审查 GitHub 拉取请求(PR)或本地代码改动,将审查结果写入本地文件而非发布到 GitHub。它属于 bitwarden/ai-plugins 项目中的一个技能,调用名为 bitwarden-code-review:bitwarden-code-reviewer 的子代理完成实际审查。
主要能力
- 目标解析:从参数中识别 PR(支持 123、https://github.com/org/repo/pull/456、PR #789 等形式,最终提取为纯整数编号),或在参数为空/无法解析时通过 AskUserQuestion 询问是审查 PR 还是本地改动。
- 基线指定:本地改动模式支持 --base <ref> 参数,指定本地 diff 的对比 ref;未提供时默认使用 origin/HEAD。PR 模式下不使用该参数,PR 的基线由 GitHub 记录,gh pr diff 会自行使用。
- 参数校验:--base 的 ref 必须匹配 ^[A-Za-z0-9][A-Za-z0-9._/-]*$;PR 编号必须匹配 ^[0-9]+$。不符合时中止并请用户重新提供,不继续使用默认基线,以避免静默地审查错误范围。
- 重复评论规避(仅 PR):通过 gh pr view --json comments 获取一般评论,通过 GraphQL 获取行内审查线程(含已解决与未解决),按同文件同行、同文件行号相差 ±5、正文相似度 >70% 三种规则匹配已有线程,匹配则复用,不匹配才新建。
- 本地输出:生成 review-summary.md(总体评估 APPROVE / REQUEST CHANGES、1–2 句中性描述、折叠的审查明细,含 ❌ ⚠️ ♻️ 🎨 ❓ 等发现分类及文件行号)与 review-inline-comments.md(按 ## [file-path]:[line-number] 组织行内评论,含 emoji、单行描述及折叠的详情与修复建议)。若没有行内评论,该文件留空。
- 只读不写远端:不调用 gh pr review --comment 或 gh pr comment 发布任何内容,只从 GitHub 读取、只向本地写入。
使用方式
命令回合负责解析 --base、校验 ref 与 PR 编号、确定目标,然后以如下形式调用 Task 工具(subagent_type 为 bitwarden-code-review:bitwarden-code-reviewer),提示词首行为 TARGET: PR #<number> 或 TARGET: local changes;本地改动且存在有效 ref 时下一行加 BASE: <ref>,否则省略;再下一行固定为 OUTPUT: local files。命令回合自身只包含 AskUserQuestion 与 Task 调用,不执行 gh、git、Skill 或 Write 操作,这些由子代理依据其自身授权完成。
适用场景
适合希望获得代码审查意见但不希望向 GitHub PR 发布评论的场合,例如本地提交前的自查、对他人 PR 的只读审阅并留存本地记录。
限制
- 该技能只写本地文件,不发布到 GitHub。
- PR 模式下 --base 不适用,会被丢弃并告知。
- 非法的 --base 形式(如 --base=<ref>、末尾无值的 --base、重复出现)会中止并请求重新输入。
- 子代理运行期间无法交互提问,目标必须在命令回合中解析完成。
- 该命令回合不能列出开放的 PR,因此 PR 编号需以自由文本提供。
暂未提供
价格、收费、支持的平台范围及性能表现等信息暂未提供。