用途:自动挑选并完成已分诊的 GitHub issue,从选题到提交 PR 全流程自动化。
前置条件:gh CLI 已通过认证并可访问仓库;使用标准 git 且支持 worktree;仓库需有标签 triaged、priority:must/should/could、size:xs/s/m/l/xl、in-progress。
主要流程:
- 用 gh issue list --label "triaged" --state open --json number,title,labels,body,comments --limit 50 拉取候选,跳过无 triaged 标签、已有 in-progress 标签,以及带 duplicate、wontfix、auto-dismissed 标签的 issue。
- 评分选题:优先级权重 must=3、should=2、could=1;规模权重 xs=1、s=2、m=3、l=4、xl=5;得分=优先级×10−规模,取最高分,同分取编号最小(最旧)。
- 认领:gh label create "in-progress" --description "Being worked on by an agent" --color "1D76DB" --force,再 gh issue edit <NUMBER> --add-label "in-progress"。
- 深读 issue 正文、评论及相关代码与测试,结合产品定位(murmur 是 Claude Code 的 cron 守护进程,强调最小构建块)理解设计意图。
- 先制定实现计划再写代码,保持改动最小、可读。
- 创建 worktree:git worktree add -b "issue-<NUMBER>-<slug>" ../murmur-issue-<NUMBER> main,进入后运行 bun install。
- 按 CLAUDE.md 约定实现(Bun、Conventional Commits、语义化命名),遵循 /effect-ts-patterns,运行 bun test src/、bun run build、bun test test/ 验证。
- 用约定式提交,消息中写 Closes #<NUMBER>。
- 运行 /final-review 检查质量门禁。
- 推送 git push -u origin issue-<NUMBER>-<slug>,并用 gh pr create 创建 PR,正文含 Summary 与测试计划。
- 失败时清理:移除 in-progress 标签、留言说明原因、git worktree remove 删除工作树。
限制与注意:不重新实现 /effect-ts-patterns 与 /final-review,而是委派;不对共享分支强推或改写历史;issue 含义不清时留言请求澄清并改选下一个;一次只处理一个 issue。具体依赖版本、环境配置等资料暂未提供。