用途:这是 GitHub 规划工作流的第二阶段编排器,把 GitHub issue 快照规划为 docs/<ISSUE_SLUG>-tasks.md。它负责路由阶段、调度子代理、保留阶段产物以支持恢复与评审,并返回简洁交接。
输入:ISSUE_SLUG 必填(示例 acme-app-42);RE_PLAN 可选(如 true);DECISIONS 可选(如 SSO decision changes task dependencies)。该阶段是文件驱动的,docs/<ISSUE_SLUG>.md 必须已作为 GitHub issue 快照存在。
主要能力:编排器上下文中只保留工作流状态、子代理裁决、路径、计数和用户决策;详细契约、模板、校验检查和来源背景按需从捆绑引用或可选外部 URL 加载。子代理注册表包括 task-planner(拆解 issue 并起草阶段 1 计划)、dependency-prioritizer(补充依赖顺序、优先级和分支名)、task-validator(校验优先级计划并追加 QA 发现)、stage-validator(检查预检、阶段间和最终结构门禁)。
使用方式:正常路径为预检快照校验、阶段 1 详细规划、阶段 1 校验、阶段 2 依赖/分支规划、阶段 2 校验、阶段 3 最终校验报告、阶段 3 校验、流水线后校验、交接。RE_PLAN=true 且带评审决策时走重规划路径。按需加载 ./references/execution-guide.md、./references/output-contract.md、./references/re-plan-cycle.md、./references/external-sources.md。需在磁盘保留 docs/<ISSUE_SLUG>-stage-1-detailed.md、docs/<ISSUE_SLUG>-stage-2-prioritized.md 和 docs/<ISSUE_SLUG>-tasks.md,它们是编排状态而非实现输出。仅使用定向修复循环:重新调度产生失败产物的阶段,只传校验器的问题列表,只重跑失败门禁,同一门禁连续失败 3 次后停止。
返回格式:仅返回阶段交接,全部阶段与阶段校验门禁通过时才用 PLANNING: PASS,字段包括 ISSUE_SLUG、File、Tasks、Branches、Cross-cutting questions、Validation warnings、Failure category、Reason、Artifacts preserved。
限制:外部 URL 为可选渐进增强,仅在本地契约需要背景或当前语法时获取,无网络时从捆绑引用继续。资料未提供具体收费、平台支持范围或效果保证。