SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场autopilot

autopilot

编程与开发

查看项目

更新于 10-15 11:46

技能介绍

用途

Autopilot 用于从一句想法出发，端到端自动执行到可运行的代码。当用户希望全自动、无需逐步介入地完成一个需要多阶段协作的软件任务时使用它：规划、编码、测试和验证。它适合用户说“autopilot”“autonomous”“build me”“create me”“handle it all”等意图，或者任务本身需要多个阶段才能完成的情况。

不适合的场景包括：用户想探索选项或头脑风暴（应使用 plan 技能）；用户只想解释、只做草稿或询问建议（应进行对话式回答）；只需要单一聚焦的代码改动（使用 ralph 或委托给执行代理）；需要审阅或批评已有计划（使用 plan --review）；任务只是快速修复或小 bug（直接委托执行代理）。

主要能力

Autopilot 把非平凡的软件任务拆分为协调的阶段并自动编排，让用户只需描述想要什么，就能获得可运行的代码。其执行策略要求每个阶段完成后才进入下一阶段，并在可行时于阶段内使用并行执行（第 2 和第 4 阶段）。QA 循环最多重复 5 次；如果同一个错误持续出现 3 次，则停止并报告根本性问题。验证需要所有审查者批准，被拒绝的条目会修复并重新验证。它还支持预算停止（可选）：当设置 OMC_RUN_BUDGET_TOKENS 时，在每个阶段边界比较会话 token 消耗，达到 90% 时完成当前阶段，达到 100% 时停止并给出预算报告，状态保留以便恢复。

使用方式

工作流分为五个阶段：

  • 第 1 阶段 规划：从规格创建实现计划。如果已存在 ralplan 共识计划则跳过（在 3 阶段流水线中已完成）。由 Architect（Opus）以直接模式创建计划（无访谈），再由 Critic（Opus）验证计划。输出为 .omc/plans/autopilot-impl.md。
  • 第 2 阶段 执行：使用执行代理实现计划，必要时配合 Ralph 持久化。简单任务用 Executor（Haiku），标准任务用 Executor（Sonnet），复杂任务用 Executor（Opus）。独立任务并行运行。
  • 第 3 阶段 QA：循环直至所有测试通过。构建、lint、测试、修复失败，最多重复 5 个周期。如果同一错误重复 3 次则提前停止，表示存在根本性问题。
  • 第 4 阶段 验证：多视角并行审查。Architect 审查功能完整性，security-reviewer 检查漏洞，code-reviewer 审查质量。所有审查者必须批准，被拒绝则修复并重新验证。
  • 第 5 阶段 收尾与清理：在状态清理前运行 closeout，向 .omc/notepads/autopilot/problems.md 追加最多三行事实性记录（blocker 另外记入 .omc/notepads/autopilot/issues.md），仅追加、不替换共享文件。成功完成后删除所有状态文件，包括 .omc/state/autopilot-state.json、ralph-state.json（以及遗留的 ultraqa-state.json/ultrawork-state.json 副本，如存在），并运行 /oh-my-claudecode:cancel 干净退出。

可使用 /oh-my-claudecode:cancel 随时取消；在终止状态清理前运行第 5 阶段 closeout，并保留可恢复的进度产物。如果被取消或失败，再次运行 /oh-my-claudecode:autopilot 可从停止处恢复。

工作流配置

命名工作流配置（v1）通过 /autopilot --workflow <name> <task> 选择。配置写在项目或用户的 JSONC 中，路径为 autopilot.workflows.<slug>。每个 v1 配置必须包含 version: 1 和 stages。允许的阶段序列为：[ralplan, execution]、[ralplan, execution, ralph]、[ralplan, execution, qa]、[ralplan, execution, ralph, qa]。其中 ralplan 创建 execution 使用的计划，execution 创建 ralph 和 qa 所需的已实现工作区。省略或重排前置阶段、重复阶段、非内置阶段均无效。配置名称需匹配 ^[a-z][a-z0-9-]{0,62}$，仅为经过校验的元数据，不得与内置阶段、autopilot/模式名称或已弃用别名冲突。

命名工作流配置在 v1 中要求 Linux 及 flock 工具，因为其 transcript 证据边界使用 Linux no-follow 文件描述符遍历，可恢复的变更锁使用内核咨询锁。不支持的环境会在状态变更前拒绝显式 --workflow 激活，应改用传统 autopilot。

V1 不支持 stageModels、模型路由、provider 或角色选择；不支持内联/无生成执行；不支持动态命令、模式或状态文件；不支持任意阶段、提示、插件、分支、循环、DAG 或回调；也不支持由环境定义配置。

可选设置

在 .claude/omc.jsonc（项目）或 ~/.config/claude-omc/config.jsonc（用户）中可设置 autopilot 的 maxIterations、maxQaCycles、maxValidationRounds、pauseAfterExpansion、pauseAfterPlanning、skipQa、skipValidation、execution 等参数。若要通过 tmux CLI team 运行时并优先使用 Cursor 执行工作者，可设置 execution 为 team，并将 team.agentTypes 设为 ["cursor"]，执行阶段须通过 omc team 1:cursor "<implementation task>" 或 /omc-teams 1:cursor "<implementation task>" 启动。Cursor 工作者支持实现和审查者类团队角色；critic、code-reviewer、security-reviewer 和 test-engineer 工作者必须产出团队负责人消费的结构化裁决文件，最终批准仍由 lead 会话负责。Cursor 需要安装并认证 cursor-agent CLI；若不可用，应报告该设置要求，而不是静默回退到仅 Claude 执行。

适用场景

适合用户希望放手执行、愿意让系统运行至完成的多阶段软件任务，例如需要规划、编码、测试和验证的完整功能开发。建议输入时明确领域（如“bookstore”而非“store”）、提及关键功能（如“with CRUD”“with authentication”）、说明约束（如“using TypeScript”“with PostgreSQL”），并尽量避免打断。

扩展与停止条件

当同一 QA 错误持续 3 个周期、验证在 3 轮重新验证后仍失败、用户说“stop”“cancel”或“abort”时，停止并报告。如果需求过于模糊且扩展后产生不清晰的规格，可建议转向 /deep-interview 进行苏格拉底式澄清，或在继续前暂停并询问用户。AFK 假设协议适用于无回答的情况（无头运行、未回答的重定向提议或用户选择仍然扩展）：继续推进但不静默，将每个本应作为访谈问题的猜测记录为假设（陈述、依据、可逆性）写入规格的 ## Assumptions 部分；通过 ADR 测试的猜测不作为假设，而是落到 .omc/autopilot/decisions-pending.md（选项、建议、可逆性说明），受影响范围仅按可逆方向实现或推迟。完成报告以 Open Assumptions 开头，按返回的人类最想否决的程度排序。

与其他技能集成

推荐完整流水线串联三个质量门：/deep-interview "vague idea" → 苏格拉底问答 → 规格（歧义 ≤ 20%）→ /ralplan --direct → 共识计划（Planner/Architect/Critic 批准）→ /autopilot → 跳过第 0+1 阶段，从第 2 阶段（执行）开始。当 autopilot 检测到 ralplan 共识计划（.omc/plans/ralplan-.md 或 .omc/plans/consensus-.md）时，会跳过第 0 阶段（扩展）和第 1 阶段（规划），因为计划已完成需求验证、架构审查和质量检查，autopilot 直接以执行代理和 Ralph 持久化从第 2 阶段开始。

模糊输入时，第 0 阶段可重定向到 /deep-interview 进行苏格拉底式澄清。如果已存在 .omc/specs/deep-interview-*.md 规格，autopilot 会直接将其作为第 0 阶段输出。

并行会话注意事项

多仓库工作区锚点：在父目录放置 .omc-workspace 标记，使跨子仓库的多个会话共享一个 .omc/。解析顺序为 OMC_STATE_DIR > .omc-workspace > git > cwd。会话 id 来源：CLI 上下文中 OMC_SESSION_ID 环境变量优先，hook 上下文中 hook payload 的 data.session_id 优先。Autopilot 状态按会话隔离；同一工作区中的两个 autopilot 需要不同的会话 ID。并行执行是受支持的（会话级状态）。

限制

资料未提供具体平台兼容性、收费与价格信息。命名工作流配置 v1 仅支持 Linux 与 flock。Cursor 执行需要安装并认证 cursor-agent CLI。V1 存在多项明确不支持的能力（见工作流配置部分）。