SuperAPI AI 工具集

implement-issue

编程与开发

查看项目

更新于 10-15 08:08

技能介绍

用途

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 调用。