用途
implement-issue 用于在给定 GitHub Issue 编号和基础分支的情况下,端到端地实现该 Issue。它通过一个编排脚本(orchestrator script)驱动整个流程,从获取 Issue 到最终创建并审核 PR。
主要能力
该技能会按阶段自动推进工作,每个阶段由不同的智能体负责:
- setup(default):获取、创建工作树、研究、评估、规划
- implement(per-task):执行计划中的每个任务
- task-review(spec-reviewer):验证任务是否达成目标
- fix(per-task):处理审查发现的问题
- simplify(cdd-code-simplifier):清理代码
- test(bats-test-validator):运行测试套件(shellcheck + BATS)
- lint(default):运行 shellcheck 和 actionlint
- review(code-reviewer):内部代码审查
- pr(default):创建或更新 PR
- spec-review(spec-reviewer):验证 PR 是否达成 Issue 目标
- code-review(code-reviewer):最终代码质量检查
- complete(default):发布总结
任务会根据 Issue 类型分配给专业智能体:
- patch-engineer:build.sh 中的压缩 JS 补丁、sed/regex 模式
- packaging-specialist:.deb、.rpm、AppImage 打包、control 文件
- electron-linux-specialist:BrowserWindow、Wayland/X11、DBus 托盘、原生主题
- ci-workflow-architect:GitHub Actions 工作流、发布自动化
- bash-script-craftsman:Shell 脚本、启动器、构建系统
使用方式
调用时需要两个参数:
- $1 — GitHub Issue 编号(必填)
- $2 — 基础分支名(必填)
开始时需声明:"Using implement-issue to run orchestrator for #$ISSUE against $BRANCH"
立即启动编排器:
.claude/scripts/implement-issue-orchestrator.sh \
--issue $ISSUE_NUMBER \
--branch $BASE_BRANCH
或显式指定智能体:
.claude/scripts/implement-issue-orchestrator.sh \
--issue $ISSUE_NUMBER \
--branch $BASE_BRANCH \
--agent patch-engineer
监控与日志
通过 status.json 检查进度:
jq . status.json
实时观察:
watch -n 5 'jq -c "{state,stage:.current_stage,task:.current_task,quality:.quality_iterations}" status.json'
日志写入 logs/implement-issue/issue-N-timestamp/ 目录,包括:
- orchestrator.log — 主日志
- stages/ — 各阶段 Claude 输出
- context/ — 解析后的输出(如 tasks.json)
- status.json — 最终状态快照
Schema 位于 .claude/scripts/schemas/implement-issue-*.json。
退出码
- 0:成功,PR 已创建并批准
- 1:某个阶段出错
- 2:超出最大迭代次数
- 3:配置或参数错误
集成
该技能由 handle-issues 通过 batch-orchestrator.sh 调用。