SuperAPI AI 工具集

run-plan

智能体与模型

查看项目

更新于 10-16 02:02

技能介绍

用途

run-plan 用于执行一份已经写好的实施计划文档。它先加载计划并批判性审查,然后按任务依赖顺序执行,最终报告完成情况。它属于工程纪律类技能,配合计划编写技能使用。

核心原则:不要盲从计划。若计划有问题,应在执行前标记出来;但若计划清晰,则忠实执行。

主要能力

  • 计划加载与批判性审查:读取计划文件,检查任务依赖是否正确、文件路径是否存在、步骤中是否有占位符、每个任务是否都有目标与可二元判定的验收标准、是否存在不清楚之处。
  • 硬性门禁:先完整阅读并审查计划;验收标准具有约束力,步骤只是路径;不得跳过验证;可并行任务必须并行;worker 与 validator 必须为独立子代理;validator 不得接收 worker 输出;被阻塞时停止并向用户提问。
  • 项目能力发现:在审查计划前,先发现项目可用的验证与执行基础设施(e2e 测试、集成测试、验证技能/代理、测试套件、构建与 lint),以及项目级 agents 和 skills。
  • 任务执行循环:每个任务经过合规检查、worker 实现、validator 评审的循环;validator 拒绝则反馈给 worker 重新实现。
  • 信息隔离的验证者:validator 仅接收计划中的任务目标、验收标准、文件清单和测试命令,使用固定模板填写,不得接收 worker 的 diff、日志或实现细节。
  • 并行执行规则:无依赖、不修改同一文件、不改动共享状态的任务必须并行派发;并行为任务不各自提交 git,由主代理在各任务通过后顺序暂存并提交。
  • 计划修订协议:当失败被判定为计划缺陷时,诊断代码库实际状态,仅修订受影响任务,并在计划文件底部的 Plan Amendment Log 中追加记录;验收标准的修订仅限于事实性过时,不得因实现失败而弱化或删除标准。
  • E2E 验证门:全部任务完成后,运行最高层验证、全量测试套件做回归检查,并核对计划成功标准。
  • 停止条件:出现阻塞、计划存在关键缺口、指令无法理解或验证反复失败时,停止并请求用户帮助。

使用方式

在已有一份计划文档并准备开始实施时启用。技能会先做 Step 0 项目能力发现,再进入 Step 1 加载并审查计划,随后按 Step 2 的任务执行循环(合规检查 → worker 实现 → validator 评审)逐个任务推进,最后经过 Step 3 的 E2E 验证门。若用户说“run this plan”或“execute the plan”,也适用该技能。

适用场景

  • 已用 plan-crafting 技能完成计划之后。
  • 用户要求运行或执行该计划。
  • 存在计划文档且应开始实施。

限制

  • 尚无计划文档时不应使用,应先使用 plan-crafting。
  • 工作范围仍不明确时不应使用,应回到澄清技能。
  • 不需要计划的单步任务不适用。
  • 被阻塞时不得猜测,应向用户提问。
  • 同一任务连续失败 3 次(含 worker 重试与计划修订)应上报用户请求介入。
  • E2E 验证失败时最多做 2 次定向修复,之后必须升级给用户,不得静默重试。
  • 关于本技能的具体收费、价格、平台版本、安装命令等事实,资料中暂未提供。