SuperAPI AI 工具集

gh-pr-review

写作与研究

查看项目

更新于 10-15 20:12

技能介绍

用途:对 Cherry Studio 仓库的代码或文档改动执行自动化评审,目标可为本地分支、PR、提交、提交区间、文件或目录、架构文档与项目技能。

主要能力:从参数识别评审目标,依据 diff 大小与运行能力选择评审引擎。小范围 diff 使用单智能体评审(references/local-review.md);大范围 diff 在具备独立子智能体时使用评审—验证多智能体流程(references/teams-review.md),否则回退为单智能体并声明该限制。PR 目标额外进行工作树准备与 GitHub 提交(references/pr-review.md)。Cherry Studio 专属规则位于 references/cherry-review-guidance.md,代码、混合、架构文档与项目技能评审需加载该文件以执行 DataApi、服务边界、渲染器钩子、React、UI 与类型契约检查。所有面向用户的文本与用户语言一致。

评审阶段按序执行:1 产品需求门禁;2 消费者(references/consumer-review.md);3 架构优先(references/cherry-review-guidance.md);4 实现(代码用 references/code-checklist.md,文档用 references/doc-checklist.md);5 风格与约定(同上 C 部分)。后续阶段只评审通过前序阶段的内容。

授权模型:评审请求默认仅授权分析与报告(report-only)。仅当调用时显式给出 fix 才允许本地修复,显式给出 submit 才允许发布到 GitHub。批准或合并始终需单独显式请求。commit 与 range 目标为不可变历史,始终 report-only。

用法示例:/gh-pr-review 评审未提交改动或分支 diff;/gh-pr-review a1b2c3d 评审提交;/gh-pr-review a1b2c3d..e4f5g6h 评审提交区间;/gh-pr-review src/foo.ts 评审文件或目录;/gh-pr-review 123 评审 PR;加 fix 或 submit 扩展权限;checklist 采纳清单项;diag 诊断技能缺口。

范围判定:diff 型目标以 git diff --numstat 统计增删行数与唯一变更文件数,未跟踪文本文件计为一个文件并按全文行数计为新增;路径目标按解析出的文件全文行数统计,目录递归展开。CHANGED_LINES<=1000、CHANGED_FILES<=20 且无二进制文件时 SMALL_SCOPE 为真。二进制文件一律使范围非小。范围为空的路径目标仍非空;解析范围为空时打印用法示例并退出。

限制:自动化会话不等待用户输入,遇到产品决策仅记录影响与待确认点,不作产品批准;遇到安全或环境阻塞会保留状态、停止受影响流程并报告阻塞与所需决策。应用修复后需按改动面运行验证:文档类运行 pnpm docs:check,代码类运行 pnpm lint 并加上覆盖该改动的测试。具体命令细节见原文各 reference 文件。