SuperAPI AI 工具集

autopilot

部署与运维

查看项目

更新于 10-27 03:07

技能介绍

用途

autopilot 用于审计任意仓库,并将其配置为编码智能体能够安全交付大多数改动、人类只需承担产品决策与少量审查的“自动驾驶”状态。资料称其适用于任意技术栈和任意代码托管平台。

主要能力

工具以 kcd-skills 包形式提供,通过 npx kcd-skills@latest autopilot <command> 运行,每个命令可用 --help 查看选项。整体围绕三条原则和一个持续改进循环组织:

  • P1 好的 PR:仓库告诉智能体要构建什么、如何证明。包括一个简短的 AGENTS.md 地图、一个 verify 命令(本地与 CI 一致)、记录智能体可能反复提议的“不做”决策;指导内容以实际使用为准,地图从事实来源生成。
  • P2 审查、迭代与验证:可检查的事项由脚本判定(审计事实、CI、PR 状态),智能体负责判断;智能体在合并前自行运行改动并只声明已验证内容;功能测试证明功能,健康检查证明运行版本。
  • P3 限制影响范围:高风险改动以暗发布上线,恢复流程经过测试;产品决策和单向门交给人类。
  • KI 持续改进:智能体在每次 PR 后记录带优先级的摩擦,其他智能体按优先级修复。

使用方式

流程分为五个阶段:

  1. 审计(只读):保持已跟踪文件不变,安装依赖可以。用 npx kcd-skills@latest autopilot audit . --out .autopilot/before.json 收集事实,使用仓库内 .autopilot/ 目录。可通过 --verify "<command>" 记录验证命令。托管平台事实通过 host request 获取格式提示,人工只读采集后以 host 命令输入。用 score 按证据给各“梯级”打分,用 finding 添加判断,用 report 生成 HTML 报告。
  2. 访谈:根据审计填充默认值,向人类询问空字段,包括是否使用 Kody、智能体不得做的事、智能体可合并的风险等级、风险分层、AI 审查者、预览环境、始终需要人工批准的改动、部署/发布与版本检查、标志与指标来源、备份恢复、Issue 跟踪器与标签、优先级与决策机制。
  3. 计划:为缺失或部分完成的梯级各生成一行计划,包含文件变更的行会合并在一个 setup PR 中提交。用 plan add 添加计划行,重新生成报告,展示计划表、未决问题和人工清单,等待批准。
  4. 梯子(一个 setup PR):当至少一行计划列出文件时,只开一个 setup PR,携带所有计划梯级的文件变更。仓库设置类变更(分支保护、必需状态检查等)不在 PR 中,合并后通过托管平台 API 应用。必需检查需先确保其在默认分支运行过至少一次再加入保护。默认分支专属行为的工作流先作为文件合入,合并后验证。setup PR 始终由人类合并。
  5. 交接:复制 before.json 为 after.json,重新给覆盖的梯级打分,添加指向 setup PR 的 prs 行,运行 verify 命令和一次 ship-loop 步骤(ship-pr 或一次 Kody tick),生成前后对比报告,列出无法验证的内容、未决决策和未完成的人工清单。

适用场景

  • 希望让编码智能体承担大多数改动交付,同时保留人类对产品决策和单向门的控制。
  • 需要为仓库建立 AGENTS.md 地图、统一 verify 命令、ADR 决策目录、PR 模板、审查者与预览、标志回滚与备份恢复测试等工程基础。
  • 希望建立摩擦记录与分级处理的持续改进循环。

资料特别说明:对于库、自托管、CLI 和移动项目,“部署”指“发布”;不适用于备份的梯级标记为 n/a。社区仓库中应添加文件并保留现有 CI,若贡献政策排除智能体 PR 则停止。密钥不得写入文件、Issue 和 PR,人工步骤需以具体清单形式告知人类。

限制

  • 审计阶段不修改已跟踪文件,部署、发布和推送需等待梯子流程。
  • 需要人工完成的操作(密钥、应用安装、访问授权、代理无法修改的设置、外部服务)会在计划批准时和 setup PR 合并后以清单形式列出。
  • 部分验证需要命令或秘密,无秘密时只能标为部分完成。
  • 具体支持的托管平台范围、收费、价格和实际效果资料未说明,暂未提供。