用途:指定父 Issue 编号,自动实现其下全部子 Issue(含孙及更深后代),保持依赖顺序,在独立 git worktree 中并行执行,覆盖实现、push 前本地 diff 评审、push 与创建 PR、CI 监控、修复循环,直至 PR 进入可合并状态。
主要能力:末端实现 Issue 按 post-order DFS 优先级贪心投入空槽,最多并行 parallel 件(默认 3,范围 1〜8);各 implement/fix 在独立 worktree 隔离,避免分支与工作副本冲突;仅功能依赖 dependsOn 与父子关系(父等待全部子完成)构成等待条件。采用 push 前评审设计以节省 CI:实现阶段只在本地分支提交,评审全部通过后才 push 并创建 PR;评审不收敛则不 push、不建 PR。push 前会先合入 base 分支,push 后检查是否产生 check-run 与 mergeable。
使用方式:通过 Workflow 工具指定 scriptPath 为该技能目录内 scripts/implement-issue-tree.js,并在 args 中传入 parent(父 Issue 编号)、skillDir(技能目录绝对路径,非 dryRun 时必填)、branch(默认 main)、parallel、phaseGate、dryRun、externalChecks、optinTestCommands、autoMerge、maxResidualWorktrees、maxResidualWorktreeBytes、maxBaseMerges、agentCallLimit、repo、models、securityReview 等参数。dryRun: true 仅做事前估算,不写状态文件、worktree、PR 或 issue。
适用场景:GitHub 上以 sub-issues API 关联的 Issue 树批量开发;需要并行推进多个子任务并自动产出 PR 的仓库。
限制:需已安装并认证 gh CLI、安装 jq 与 awk,git working tree 须 clean,需目标仓库写权限,父子 Issue 须已通过 sub-issues API 关联。autoMerge 默认 false,仅在 autoMerge: true 且 externalChecks 明确声明全部可信 check context 时才执行客户端 squash merge,否则停在可合并状态由人工合并;并要求 base 分支 ruleset 的 required status checks strict 为 false。merge-guard hook 与 opt-in 自动合并不可并用。具体 gh 最低版本、价格与效果资料暂未提供。