用途:端到端处理一个 GitHub issue,读取 issue 正文、其引用的仓库文档与代码、已有评论,对照已落地的实现与意图核验,产出带证据的发现并作为评论落回 issue,而非留在对话里。
主要能力:按 issue 性质分五类处理——doc-review(评审 issue 中讨论的新设计,找漂移、独立发现、reframe,产出评审评论与拆分建议);doc-audit(逐篇审计存量文档,对照代码重验、跑测试、给结论);system-audit(对子系统、跨平台 parity 或 runtime 做全面代码审计,要求完整执行、逐条 path:line 坐实、真跑测试、开 gap/bug/security issue);research(调研外部系统与本系统结合点,只产出评论,不改仓库代码);idea(内部提案,先澄清再评估,只产出评估评论与澄清问题,不改代码、不开 spin-off)。
使用方式:命令为 /agentloop:issue-review <issue-number-or-url> [--dry-run],用 gh 读取 issue;--dry-run 只产出预览,不发评论、不开 spin-off、不动 label。运行前先读 .claude/repo-profile.md 获取 repo_slug、verification_entry、kb_issue、plugin_root、toolchain 等配置。并发控制使用 agent:hold 与 agent:processing 两个 label,agent:processing 为 TTL 30 分钟的 advisory 互斥锁,开工 acquire、收尾 release;无分支兜底的终态动作用 issue-graph 的 claim.ts 做 claim-comment fencing。
适用场景:issue 在讨论或评审仓库内文档、需要独立于人类 reviewer 的视角、或搭建自动处理 issue 的 agent loop。不适用纯代码 PR review(用 /code-review 或 /review)与不走 issue 的本地文档(用 /agentloop:design-review <path>)。
限制:agent:processing 只是 advisory 锁,非完美分布式锁;沙箱可能缺平台工具链(如 Xcode、Android SDK),测试跑不动时须贴确切报错并退为静态对照,不得假装跑过;research 与 idea 类绝不改仓库代码、不开 PR、不开 spin-off;输出语言遵循 repo profile 的 comment_language,代码标识符、路径、命令、path:line 保持原样。