autopilot-phase2-3-openspec

name	autopilot-phase2-3-openspec
description	Use when the autopilot orchestrator main thread reaches Phase 2 or Phase 3 and must dispatch the mechanical OpenSpec change creation and Fast-Forward artifact generation as background tasks against the prepared requirements bundle.
user-invocable	false

Autopilot Phase 2-3 — OpenSpec 创建与 FF 生成

前置条件自检：本 Skill 仅在 autopilot 编排主线程中使用。如果当前上下文不是 autopilot 编排流程，请立即停止并忽略本 Skill。

Phase 2 和 Phase 3 均为机械性 OpenSpec 操作，共享同一 agent 和 model tier。本 Skill 描述两者在统一调度模板中的特殊行为。（下文 <name> 表示从需求推导出的 kebab-case change 名）

dispatch 的具体 prompt 构造逻辑保持在 autopilot-dispatch 中。

共同执行规范

Phase 2 与 Phase 3 共用以下派发约束：

• 执行位置: Task 子 Agent
• Agent: config.phases.openspec.agent（默认 Plan）
• Model Tier: fast / haiku
• 必须使用 run_in_background: true：机械性操作不应占用主窗口上下文
• JSON 信封 schema（输出最后一行）：{"status": "ok", "summary": "...", "artifacts": [...]}

  Hook 验证要求 status 与 summary 必须存在，缺一即 block。

Phase 2: 创建 OpenSpec

• 任务：从需求推导 kebab-case 名称，初始化 OpenSpec change 目录并编写 proposal.md

关键事实：openspec new change "<name>" 仅创建 .openspec.yaml 元数据文件（2 行：schema + created），不会自动生成 proposal.md 或 context 文件。子 Agent 必须自行编写所有制品文件。

子 Agent 必须执行的操作步骤：

1. Bash('openspec new change "<name>"') — 初始化 change 目录
2. Bash('mkdir -p openspec/changes/<name>/context/phase-results/') — 创建 checkpoint 目录
3. Bash('openspec instructions proposal --change "<name>"') — 获取 proposal 写作指引
4. 根据指引 Write openspec/changes/<name>/proposal.md
5. 返回 JSON 信封

示例 summary：

{"status": "ok", "summary": "已创建 OpenSpec change: <name>，包含 proposal.md", "artifacts": ["openspec/changes/<name>/proposal.md"]}

Phase 3: FF 生成制品

• 任务：按 openspec instructions 指引依次生成 design.md、specs/、tasks.md

关键事实：openspec CLI 不自动生成制品文件。openspec instructions <artifact> --change <name> 输出写作指引和模板，子 Agent 根据指引自行 Write 文件。

子 Agent 必须执行的操作步骤：

1. Bash('openspec instructions design --change "<name>"') — 获取 design 写作指引
2. Write openspec/changes/<name>/design.md
3. Bash('openspec instructions specs --change "<name>"') — 获取 specs 写作指引
4. Write openspec/changes/<name>/specs/*.md（按 proposal 中声明的 capabilities 逐个创建）
5. Bash('openspec instructions tasks --change "<name>"') — 获取 tasks 写作指引
6. Write openspec/changes/<name>/tasks.md
7. 返回 JSON 信封

示例 summary：

{"status": "ok", "summary": "已生成 OpenSpec 制品: design/specs/tasks", "artifacts": ["openspec/changes/<name>/design.md", "openspec/changes/<name>/specs/", "openspec/changes/<name>/tasks.md"]}

共享约束

• Phase 2/3 采用联合调度快速路径：单次 gate 验证 + 单次 model routing + 两个串行 background Task
• Phase 2 完成后直接进入 Phase 3，无需再次调用 Skill("autopilot-gate") 或 resolve-model-routing.sh
• Phase 3 的前置 checkpoint 验证由 Hook L2 (check-predecessor-checkpoint.sh) 在 Task 派发时自动执行
• 两者均为 full 模式专属，lite/minimal 模式跳过
• Skill 名 autopilot 内的 "Phase 2-3 联合调度快速路径" 章节定义了完整的 Fast-Step 0-9 流程