用途
该技能用于处理审查机器人(review bot)提交的开放 GitHub 问题。每个问题被视为一个发现(finding)的集合:有些成立,有些已过时,有些是误报。每个发现都必须依据默认分支上的代码单独给出结论,绝不能仅凭问题标题判断。只有当问题中不再有成立的发现时,问题才会关闭;修复只有进入默认分支才算数。
项目上下文
如果仓库中存在 .agents/github-review.md,应先阅读。其中的 ## Review bots(机器人问题标签)、## Auto-dismiss、## Never dismiss 和 ## Stack facts(机器人常犯的错误)记录了该仓库的事实;缺少某节则按默认处理。之后遵循仓库 AGENTS.md / CLAUDE.md 中关于测试、lint、缓存清理和脏工作区的规则。
主要能力与使用方式
-
构建工作集:确定默认分支,执行 git fetch origin,并对照 origin/<default> 而非本地分支进行校验。列出所有带机器人标签的开放问题(或用户指定的问题),按从新到旧排序,并检查列表未被截断。遍历顺序为新到旧,但证据可以重排:较新的提交引入了旧问题已指出的缺陷,则旧发现为 LEGIT;较新提交已修复旧发现,则为 STALE 并引用 sha。
-
分类每个发现:阅读问题正文和所有评论,阅读被审查的提交,然后为每个发现写一行结论(STALE、AUTO-DISMISS、HALLUCINATION、LEGIT)并附一行证据。验证规则包括:对“类、方法或权限缺失”的声明,在声明的位置用 rg 搜索该符号;对“X 可能破坏 Y”的声明,追踪真实调用点;文件:行不存在或与描述不符则为 HALLUCINATION;提交说明中的设计选择与发现矛盾则为 AUTO-DISMISS;发现自相撤回则为 AUTO-DISMISS。发现超过 5 条时,可将首批分类分给只读子代理按约 10 条一批处理,之后自行复核所有 LEGIT 或 UNSURE 的行,并在写代码前对 LEGIT 做第二轮复核。
-
修复合法发现:从 origin/<default> 新建 fix/issues-<run> 分支(工作区脏时用 worktree)。每个 LEGIT 发现做最小改动,不做顺手重构;涉及逻辑、认证或数据变更时添加测试并跑通;按 Conventional Commits 单独提交。仅在解决该问题最后一个合法发现的提交上写 fixes #NNN。无法修复的 LEGIT 发现(如密钥轮换、基础设施、需人工决策)保持问题开放并说明阻塞点。
-
落地修复:本地提交尚不能修复问题,需推送至 <default>;若分支保护或仓库规则禁止直接推送,则改为开 PR。用户指令(如“开 PR”“保留本地”)优先。落地后将用户检出切回步骤 3 记录的原始分支或提交,不得停留在 fix/issues-<run>。
-
发布处理说明:为工作集中每个问题发一条评论,每个发现一条要点(fixed in sha、stale、auto-dismiss、hallucination),并按情况关闭问题或说明修复位置及阻塞点;若后续发现误分类,应重开问题并附更正说明。
-
清理:删除所有已创建且修复已进入 <default>(或未做修复)的 worktree 和数据库,并在报告中列出。对无法删除的 worktree 及修复在 PR 中或保留本地的情况,只询问一次是否删除,且不使用 --force。最后报告统计:fixed、stale、auto-dismiss、hallucination、blocked,并标出 ⚠️。
适用场景
适合使用审查机器人(带问题标签)提交问题的代码仓库,尤其是需要批量、逐条核验机器人问题真伪并快速落地修复的维护工作。
限制
资料未提供具体的安装方式、依赖版本、支持平台和收费信息。部分步骤引用了外部文件(references/mechanics.md、Land、Disposition and close、Clean up、Scratch databases),这些内容在当前资料中暂未提供。