SuperAPI AI 工具集

execute

通用与其它

查看项目

更新于 10-15 21:52

技能介绍

用途:当用户要求“执行蓝图”“运行计划”“按计划开始构建”等时,使用该技能驱动计划中的每个步骤,按严格的构建、审查、验证三阶段循环推进,由专用子代理承担实现、审查与验证工作,主对话保持精简,专注于编排和用户决策。每步必须满足验收标准后才标记完成并进入下一步。

主要能力:定位计划文件(扫描 docs/plans/,单个文件直接使用,多个文件或里程碑文件夹时让用户选择;里程碑文件夹从第一个未打勾步骤开始;用户直接指定文件则不再询问)。执行前完整读取计划,识别步骤标题、各阶段指令与依赖,统计总步骤数与已完成数并报告。支持只执行指定步骤(如“执行步骤 3-5”或“跳过步骤 2”),跳过含依赖的步骤时会警告。

使用方式:执行第一步前询问 git 模式,仅两个选项。用户管理模式:每步三阶段完成后暂停,由用户自行检查、暂存和提交,不自动创建提交,用户明确表示继续前不恢复执行;即使分批,也在批内每步后暂停。技能管理模式:每步通过三阶段后自动提交;若步骤需人工介入(阻塞性审查发现或验证失败),在完全解决并通过剩余阶段前不提交该步任何更改,部分完成的步骤永不提交;计划文件的进度更新(✅ 标题前缀与勾选复选框)与实现更改放在同一提交中,不单独提交进度;提交信息使用 conventional commits 格式并引用步骤,不得包含 Claude Code 或 AI 署名。暂停节奏:简单计划(单文档)连续执行全部步骤,完成后给出最终总结;复杂计划(多里程碑文档)在用户选择技能管理模式后询问暂停节奏,里程碑暂停(默认)在每个里程碑文档完成后暂停并询问是否继续,里程碑内连续执行不在批次边界暂停;全自动则跨里程碑连续执行至计划完成。用户选择在本次执行会话中保持一致,中途切换需明确说明,每次默认询问,不沿用上次会话。

步骤执行:将步骤分组为最多 3 步的批次,批内严格串行,每步必须完成完整构建、审查、验证并通过三阶段后下一步才开始构建;绝不批量构建、批量审查或批量验证,每阶段为下一阶段的门禁,每步为下一步的门禁。批次完成后按所选 git 模式处理并给出批次总结。批次不跨里程碑边界;剩余步骤少于批次大小时只含剩余步骤;批内某步失败则批内剩余步骤不执行,呈现失败并等待指示。

子代理调度:使用 Claude Code 的 Agent 工具,参考 references/subagent-prompts.md 中的提示模板,调度前替换占位符。构建子代理:将步骤目标、验收标准、第一阶段指令逐字传入对应占位符,具有完整文件系统读写权限,捕获结构化构建总结。审查子代理:传入验收标准、构建总结、第二阶段指令;审查子代理独立从磁盘读取文件,构建总结仅用于定位与聚焦,不作为可信事实来源;解析响应识别阻塞性发现。验证子代理:传入第三阶段清单与项目工具链配置(测试运行器、linter、类型检查器命令);工具链从计划的 Tool Chain 表提取(规划时经用户确认,为权威来源),无该表时从项目配置文件(pyproject.toml、package.json、Makefile 等)检测作为回退;缓存解析结果并复用于后续验证调度,除非计划明确更改工具链要求;验证子代理运行实际工具并按清单项报告通过/失败,任一检查失败即整个验证阶段失败。

失败处理:审查子代理返回任何阻塞性发现时立即停止,不进入验证,不自动修复,不重试构建,不提交该步更改,向用户呈现完整发现及 file:line 引用与说明并等待指示。用户可选择手动修复后要求重跑审查、要求技能带附加指令重跑构建、跳过该步(标记为跳过而非完成)或完全中止执行。验证子代理返回任何失败检查时同样立即停止,不进入下一步,不自动修复,不提交,呈现完整失败详情与错误输出并等待指示,选项同上。用户解决介入后,从失败点重跑剩余阶段;仅当步骤干净通过三阶段后才提交,提交捕获最终解决状态而非中间尝试。建议性审查发现不阻塞执行,在步骤通过三阶段后作为信息性说明呈现,用户可稍后处理或忽略。已通过三阶段并标记完成的步骤保留勾选,不因其他步骤后续失败而回滚。

进度跟踪:步骤通过三阶段后立即在计划文件中做两处更新:在步骤标题前加勾选(如将 ### Step 1: Auth middleware 变为 ### ✅ Step 1: Auth middleware),并将该步第三阶段验证清单及其他复选框由 - [ ] 改为 - [x];两处更改写入磁盘以跨会话持久化。恢复时扫描计划文件中第一个无 ✅ 前缀的步骤标题并从该步开始。若用户此前暂停(用户管理模式),恢复前重新读取整个计划文件,用户可能已增删、重排步骤或修改指令,以恢复时的计划文件为准。恢复时始终从磁盘重读计划,不依赖缓存版本;除非步骤依赖明显断裂(如引用已删除步骤的产物),否则不警告或质疑更改。

步骤报告:每步完成三阶段后给出报告,详细程度取决于模式。用户管理模式(每步暂停)给出完整报告,含步骤标签与状态、更改文件数、阻塞性与建议性发现数量(如有建议性发现则简要列出)、验证结果摘要(N/N 检查通过)及 git 操作(已暂停等待用户)。技能管理连续模式(简单计划或全自动)将每步报告压缩为一行,含步骤标签、状态、更改文件数、验证结果与提交哈希,运行结束时给出综合总结。技能管理里程碑暂停模式在里程碑内使用压缩单行格式,每个暂停点给出完整里程碑总结。批次完成后给出批次总结,列出该批完成的全部步骤与累计统计。

适用场景:已有蓝图或计划文件、希望按步骤受控推进实现并保留审查与验证门禁的开发工作流。限制:依赖 Claude Code 的 Agent 工具与计划文件结构;具体提示模板、工具链配置与计划格式细节需参考该技能仓库资料,本资料未提供完整模板内容。