---
name: autopilot
description: 从想法到可用代码的全自主执行
level: 4
---

<Purpose>
Autopilot 接收一个简短的产品想法，并自主处理完整生命周期：需求分析、技术设计、规划、并行实现、QA 循环以及多视角验证。它可以从 2-3 行描述中产出可运行且经过验证的代码。
</Purpose>

<Use_When>
- 用户希望从一个想法到可用代码进行端到端的自主执行
- 用户说了 "autopilot"、"auto pilot"、"autonomous"、"build me"、"create me"、"make me"、"full auto"、"handle it all" 或 "I want a/an..."
- 任务需要多个阶段：规划、编码、测试和验证
- 用户希望免干预执行，并愿意让系统一直运行直到完成
</Use_When>

<Do_Not_Use_When>
- 用户想探索选项或头脑风暴，改用 `plan` skill
- 用户说了 "just explain"、"draft only" 或 "what would you suggest"，此时应以对话方式回应
- 用户只想做一次单点代码修改，改用 `ralph` 或委派给 executor agent
- 用户想审查或批判现有计划，改用 `plan --review`
- 任务只是快速修复或小 bug，改用直接委派给 executor
</Do_Not_Use_When>

<Why_This_Exists>
大多数非平凡的软件任务都需要协调多个阶段：理解需求、设计方案、并行实现、测试以及验证质量。Autopilot 会自动编排所有这些阶段，因此用户只需描述想要的内容，就能在无需逐步管理的情况下获得可运行的代码。
</Why_This_Exists>

<Execution_Policy>
- 每个阶段都必须先完成，才能进入下一个阶段
- 在可能的情况下，阶段内部使用并行执行（Phase 2 和 Phase 4）
- QA 循环最多重复 5 次；如果同一个错误连续出现 3 次，则停止并报告根本问题
- 验证需要所有评审者批准；被拒绝的项目需要修复并重新验证
- 可随时使用 `/oh-my-claudecode:cancel` 取消；进度会被保留以便恢复
</Execution_Policy>

<Steps>
1. **Phase 0 - Expansion**：将用户的想法扩展为详细规格
   - **如果已存在 ralplan 共识计划**（来自 3 阶段流水线的 `.omc/plans/ralplan-*.md` 或 `.omc/plans/consensus-*.md`）：跳过 Phase 0 和 Phase 1，直接进入 Phase 2（Execution）。该计划已经过 Planner/Architect/Critic 验证。
   - **如果已存在 deep-interview 规格**（`.omc/specs/deep-interview-*.md`）：跳过 analyst+architect 扩展，直接使用这个已预验证的规格作为 Phase 0 输出。继续进入 Phase 1（Planning）。
   - **如果输入含糊**（没有文件路径、函数名或具体锚点）：在扩展前提供跳转到 `/deep-interview` 进行苏格拉底式澄清的选项
   - **否则**：由 Analyst (Opus) 提取需求，由 Architect (Opus) 创建设计技术规格
   - 输出：`.omc/autopilot/spec.md`

2. **Phase 1 - Planning**：基于规格创建实现计划
   - **如果已存在 ralplan 共识计划**：跳过，此步骤已在 3 阶段流水线中完成
   - Architect (Opus)：创建计划（直接模式，无需 interview）
   - Critic (Opus)：验证计划
   - 输出：`.omc/plans/autopilot-impl.md`

3. **Phase 2 - Execution**：使用 Ralph + Ultrawork 实现计划
   - Executor (Haiku)：简单任务
   - Executor (Sonnet)：标准任务
   - Executor (Opus)：复杂任务
   - 并行运行相互独立的任务

4. **Phase 3 - QA**：循环直到所有测试通过（UltraQA 模式）
   - Build、lint、test，并修复失败项
   - 最多重复 5 个循环
   - 如果同一个错误重复出现 3 次则提前停止（表明存在根本性问题）

5. **Phase 4 - Validation**：并行进行多视角评审
   - Architect：功能完整性
   - Security-reviewer：漏洞检查
   - Code-reviewer：质量审查
   - 所有评审都必须通过；若被拒绝则修复并重新验证

6. **Phase 5 - Cleanup**：在成功完成后删除所有状态文件
   - 移除 `.omc/state/autopilot-state.json`、`ralph-state.json`、`ultrawork-state.json`、`ultraqa-state.json`
   - 运行 `/oh-my-claudecode:cancel` 以干净退出
</Steps>

<Tool_Usage>
- 在 Phase 4 架构验证中使用 `Task(subagent_type="oh-my-claudecode:architect", ...)`
- 在 Phase 4 安全审查中使用 `Task(subagent_type="oh-my-claudecode:security-reviewer", ...)`
- 在 Phase 4 质量审查中使用 `Task(subagent_type="oh-my-claudecode:code-reviewer", ...)`
- Agents 会先形成自己的分析，再生成 Claude Task agents 进行交叉验证
- 永远不要因外部工具而阻塞；如果委派失败，就使用可用 agents 继续推进
</Tool_Usage>

<Examples>
<Good>
User: "autopilot A REST API for a bookstore inventory with CRUD operations using TypeScript"
Why good: 领域明确（bookstore）、功能清晰（CRUD）、技术约束明确（TypeScript）。Autopilot 有足够上下文可将其扩展为完整规格。
</Good>

<Good>
User: "build me a CLI tool that tracks daily habits with streak counting"
Why good: 产品概念清晰，并带有一个明确功能。"build me" 触发词会激活 autopilot。
</Good>

<Bad>
User: "fix the bug in the login page"
Why bad: 这只是一次单点修复，不是多阶段项目。应改用直接委派给 executor，或使用 ralph。
</Bad>

<Bad>
User: "what are some good approaches for adding caching?"
Why bad: 这是探索/头脑风暴类请求。应以对话方式回应，或使用 plan skill。
</Bad>
</Examples>

<Escalation_And_Stop_Conditions>
- 当同一个 QA 错误持续跨越 3 个循环仍存在时，停止并报告（这表明存在需要人工输入的根本问题）
- 当验证在 3 轮重新验证后仍持续失败时，停止并报告
- 当用户说 "stop"、"cancel" 或 "abort" 时停止
- 如果需求过于模糊，导致扩展产出的规格仍不清晰，则提供跳转到 `/deep-interview` 进行苏格拉底式澄清，或先暂停并向用户请求澄清后再继续
</Escalation_And_Stop_Conditions>

<Final_Checklist>
- [ ] 已完成全部 5 个阶段（Expansion、Planning、Execution、QA、Validation）
- [ ] Phase 4 中所有验证者均已批准
- [ ] 测试通过（以新的测试运行输出为准进行验证）
- [ ] Build 成功（以新的构建输出为准进行验证）
- [ ] 状态文件已清理
- [ ] 已通知用户完成情况，并总结构建了什么
</Final_Checklist>

<Advanced>
## Configuration

`.claude/settings.json` 中的可选设置：

```json
{
  "omc": {
    "autopilot": {
      "maxIterations": 10,
      "maxQaCycles": 5,
      "maxValidationRounds": 3,
      "pauseAfterExpansion": false,
      "pauseAfterPlanning": false,
      "skipQa": false,
      "skipValidation": false
    }
  }
}
```

## Resume

如果 autopilot 被取消或失败，请再次运行 `/oh-my-claudecode:autopilot`，即可从中断位置继续。

## Best Practices for Input

1. 尽量明确领域，用 "bookstore" 而不是 "store"
2. 说明关键功能，如 "with CRUD"、"with authentication"
3. 指明约束条件，如 "using TypeScript"、"with PostgreSQL"
4. 让它运行，除非确有必要，否则避免中断

## Troubleshooting

**卡在某个阶段？** 检查 TODO 列表中是否有被阻塞的任务，查看 `.omc/autopilot-state.json`，或取消后再恢复。

**QA 循环耗尽？** 同一个错误出现 3 次说明存在根本问题。请审查错误模式；可能需要人工介入。

**验证持续失败？** 审查具体问题。需求可能过于模糊，先取消并提供更多细节。

## Deep Interview Integration

当 autopilot 以含糊输入被触发时，Phase 0 可以跳转到 `/deep-interview` 进行苏格拉底式澄清：

```
User: "autopilot build me something cool"
Autopilot: "Your request is open-ended. Would you like to run a deep interview first?"
  [Yes, interview first (Recommended)] [No, expand directly]
```

如果在 `.omc/specs/deep-interview-*.md` 已存在 deep-interview 规格，autopilot 会直接将其用作 Phase 0 输出（该规格在清晰度方面已经过数学化验证）。

### 3-Stage Pipeline: deep-interview → ralplan → autopilot

推荐的完整流水线会串联三个质量门：

```
/deep-interview "vague idea"
  → Socratic Q&A → spec (ambiguity ≤ 20%)
  → /ralplan --direct → consensus plan (Planner/Architect/Critic approved)
  → /autopilot → skips Phase 0+1, starts at Phase 2 (Execution)
```

当 autopilot 检测到 ralplan 共识计划（`.omc/plans/ralplan-*.md` 或 `.omc/plans/consensus-*.md`）时，会跳过 Phase 0（Expansion）和 Phase 1（Planning），因为该计划已经完成了以下检查：
- 需求已验证（deep-interview ambiguity gate）
- 架构已审查（ralplan Architect agent）
- 质量已检查（ralplan Critic agent）

Autopilot 会直接从 Phase 2 开始（通过 Ralph + Ultrawork 执行）。
</Advanced>
