用途:当需要用 GitHub Issues 规划项目、功能或复杂任务,并希望使用子问题嵌套与 wave 波次标签时使用。不适合执行既有 issue 计划(用 run-issue-plan)、审查 PR(用 review-pr)或与 GitHub Issues 无关的一般规划(用 plan-work)。
主要能力:以最大化方式分解任务,将工作编入顺序 wave(Wave 0 为基础设施),生成缩进树计划;为每个 issue 分配 wave、type、priority 标签;构建子问题层级与双向交叉引用;issue 正文遵循 subagent prompt 协议,含 Context & Rationale、Strategic Intent、Definition of Done(BSV 标准)与 Wave & Dependencies 四部分。
使用方式(须保留命令原样):先做前置检查,如 gh auth status、command -v jq >/dev/null、REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner);设定 SKILL_DIR 为包含 SKILL.md 的绝对路径。若缺少 wave/type/priority 标签,先记入草稿,不要直接改动仓库标签;仅在用户同时批准计划树与标签变更后运行 MAX_WAVE="${MAX_WAVE:-5}" bash "$SKILL_DIR/scripts/setup-labels.sh" "$REPO"。创建 issue 用 gh issue create --repo "$REPO" -t ... -l ... -b "$BODY",正文需先校验字符数(上限 60000)。子问题连接用 bash "$SKILL_DIR/scripts/link-sub-issue.sh" "$REPO" PARENT_NUMBER CHILD_NUMBER,必须自底向上创建 issue,并通过 link-sub-issue.sh 使用 GraphQL 连接。
限制:不在用户批准计划树前创建 issue;不跳过头脑风暴问题阶段;正文不得为空或含糊;不得忘记子问题连接;非琐碎项目不得少于 3 层嵌套;DoD 必须具体可验证,保持工具无关,不硬编码编辑器、测试运行器或构建工具命令。若用户不回答问题且未明确要求按假设推进,不得设计最终树或创建 issue。