用途:作为自动修复链(verify-in-repo → root-cause → apply-fix → open-pr → auto-review-pr)的第 1 步,在已检出的隔离分支上以只读方式快速判断该链条是否应继续。
参数:{issueId} 必填,为 GitHub issue 编号;{repo} 可选,格式 owner/name,省略时从当前 git remote 推断。
配置:仅需基础分支,从 .ai/agentic.config.json 读取 baseBranch。文件缺失时停止,并提示先运行 setup-agent-pipeline。基础分支始终取自配置,不得硬编码。
判断顺序(首个触发停止的条件生效):1) 获取 issue 与仓库信息,issue 已关闭则停止;2) 判断是否已被他人处理——带 in-progress 标签且 assignee 不含当前用户,或存在 30 分钟内的 🤖 声明评论;in-progress 标签超过 60 分钟且期间无评论或推送视为过期;3) 查找是否已有修复进行中或已发布——搜索引用该 issue 的开放/已关闭 PR,并在 origin/$BASE_BRANCH 上按 issue 号 grep 提交;4) 结合代码简短判断是否确为缺陷,例如行为属文档化预期、属使用者环境或用法错误、或已有测试与报告矛盾。
输出:停止时输出独立一行的 NO_ACTION_NEEDED 加一段理由,需引用提交哈希、PR 号、文件路径或测试名作为证据;继续时输出一段确认该缺陷真实且未修复,并指出预期根因所在文件或区域,整体不超过 200 词。
限制:全程只读,仅可读文件与搜索代码,可运行只读 gh 命令与只读 git 命令;不得编辑或写入文件,不得运行 gh issue edit/comment、git commit、git push,不得认领 issue 或创建分支与提交。倾向停止:若无法用至少一项证据证明“真实且仍未修复”,则输出 NO_ACTION_NEEDED。