用途:当已存在一棵 GitHub Issue 树、需要用子代理派发方式执行时使用。不在创建新计划、代码审查或尚无 Issue 时使用。
前置条件:gh auth status 必须已认证;command -v jq >/dev/null 为 scripts/read-tree.sh 所需。先解析辅助脚本路径(SKILL_DIR 为本技能安装目录,非目标仓库内路径),确定 REPO 后所有 gh 命令都传 --repo "$REPO"。用户提供根 Issue 编号,或通过标签 type:epic 与 wave:0-foundation 检测。本技能假定运行时能派发子代理;不能则止于阶段 2,交回就绪 Issue 集与派发提示。
工作流:阶段1用 FULL=1 bash "$SKILL_DIR/scripts/read-tree.sh" "$REPO" ROOT_NUMBER 读取计划并展示树及各波次开/关计数。阶段2识别当前波次,列出就绪的叶子 Issue(无未关闭子项、阻塞项已关闭、无 status:in-progress/blocked/failed/needs-review 标签)。阶段3派发子代理:完整查看 Issue、子 Issue 与最近评论,做派发前校验(正文含四个协议段落、DoD 为 BSV、工具无关、正文小于 60000 字符、交叉引用有效),标记 status:in-progress,并按 Issue 正文生成子代理提示。阶段4验证完成:逐条核对 DoD 后关闭或标记失败。阶段5波次切换,需用户确认后继续。
限制与护栏:不先展示计划树不得执行;不跳过波次顺序;不满足全部 BSV 标准不得关闭;不经用户确认不得进入下一波;不修改 Issue 正文,仅添加评论;失败不自动重试。所有 GitHub 操作使用 gh CLI,已知 REPO 后始终带上 --repo "$REPO"。