SuperAPI AI 工具集

reviews

测试与质量

查看项目

更新于 10-15 17:17

技能介绍

用途:驱动一次代码评审得到具体结果——明确改动意图、发起评审、听取反馈、处理有依据的意见、验证修复并展示新代码再审。本地代码评审不需要 Task、PR 或 Jobs 守护进程;发布与自动 PR 管理是需单独授权的独立操作。

主要能力:支持人工本地评审、自行编写评审元数据、打开 Needs review 收件箱、打开已有 PR、发现/查看/运行 AI 评审工作流 DAG、仅生成发布 JSON、发布或更新分支 PR。命令如 reviews local、reviews inbox、reviews open <PR>、reviews workflows list/show/run、reviews generate、reviews publish。

用法:先解析本 SKILL.md 所在绝对目录(非当前仓库)执行 bootstrap 获取 archdev 可执行路径,如 bash /绝对路径/reviews/scripts/bootstrap.sh。选择本地基线 ref(默认 origin/main,可用 --base HEAD)。运行 reviews local --feedback-format jsonl --no-open 并以持久进程保持运行,从 JSONL 的 ready 事件取 session_id 和 url,在人的浏览器中打开一次。反馈含稳定 ID、文件路径、LEFT/RIGHT、行或行区间与正文;drafts_changed 时替换草稿视图,submitted 时以最终集合为准再实施。改完用原基线重跑 reviews local 得到新快照与新 URL 再审。

适用场景:本地代码评审、行内反馈迭代、AI 评审工作流试验、按需发布 PR。需要发布或 GitHub 动作时用 reviews publish 并核对实际 PR/head。

限制:local 捕获的是不可变快照,编辑或刷新页面不会重新捕获;无 CLI 反馈游标、会话文件更新或就地修订命令;URL 含能力令牌与回环端点,须当作私有交接,不可提交或公开;浏览器须能访问运行 CLI 的机器。会话八小时后过期,进程退出无 submitted 即非反馈。空流不等于完成或批准,提交反馈也不代表批准 GitHub 评审或合并。此外,本地评审会把捕获的 diff/上下文发送给所选模型提供方生成语义元数据,并非纯离线模式。