SuperAPI AI 工具集

ac-execute

编程与开发

查看项目

更新于 10-16 09:17

技能介绍

用途

ac-execute 是一条执行类技能,用于按已确认的计划实施代码改动,并完成最小验证。它强调“实施主权”:所有产品代码的修改由当前会话的主线程直接执行,辅助性的 Subagents 只负责检索、分析与只读自审。

主要能力与核心协议

  • 语言协议:与工具交互使用英语,与用户交互使用中文。
  • 实施主权:所有产品代码修改由 Claude 主线程直接执行。
  • 按需使用 subagents:仅在上下文检索范围大、实现涉及多个模块、或交付前需要额外只读自审时,使用 Agent 工具启动 subagents 辅助。
  • 只读辅助:subagents 只负责检索、分析、自审,不直接编辑代码、不写计划文件、不替代主线程交付。
  • 最小变更:只修改计划范围内的必要代码。
  • 前置条件:优先基于 /ac-plan 生成且已批准的计划执行;若缺失计划或计划信息不全,先向用户确认。

使用方式(执行工作流)

Phase 0:读取计划

  • 识别输入类型:计划文件路径(如 .claude/plan/xxx.md)或直接的任务描述。
  • 读取计划内容,提取任务类型、实施步骤、关键文件、风险与验证要求。
  • 执行前确认:若输入为直接任务描述,先确认是否已有已批准的计划;若计划中缺失关键文件、验收标准或范围边界,先向用户补充确认;若无法确认用户是否已同意执行,必须先询问。

Phase 1:上下文检索

  • 优先读取计划中列出的关键文件。
  • 若计划未给出完整路径或实现涉及多个模块,由主线程按需使用 Agent 工具并行启动 subagents,可按文件组、模块或关注点拆分检索任务。
  • 补充读取实施所需的入口文件、依赖模块、相关类型定义。
  • 若发现计划与当前代码明显不一致,暂停并向用户确认。

Phase 2:主线程实施

  • 基于计划与上下文直接实施,先读取目标文件理解现有实现方式。
  • 由主线程使用 Edit / Write 工具执行实际修改,遵循项目现有代码风格与结构。
  • 仅修改必要代码,避免顺手重构和超范围变更;若发现计划需要变更,先暂停并向用户确认。

Phase 3:验证

  • 优先运行最小相关范围的 lint / typecheck / tests。
  • 若验证失败,先修复回归问题再继续交付;若项目缺少自动化检查,给出最小手动验证步骤。
  • 未验证通过前不进入最终交付。

Phase 4:主线程自审与交付

  • 自审:检查逻辑正确性、边界条件与副作用、安全性与输入边界、是否存在超范围修改、是否与计划目标一致。
  • subagents 附加审查(复杂场景按需启用):当改动跨多个模块、验证成本高或存在集成风险时,使用只读 subagents 并行审查不同关注点,典型拆分为“正确性与回归风险”“可维护性与集成一致性”。
  • 整合修复:根据主线程与 subagents 审查结果执行必要修复,修复后重复最小验证,风险可接受后再交付。
  • 交付确认:向用户报告变更摘要(文件、操作、说明)、验证结果(已执行的检查与结果)以及后续建议。

执行约束与重要规则

  • 工作目录:使用当前工作目录的绝对路径作为上下文检索与代码修改根目录;若通过 /add-dir 添加了多个工作区,先用 Glob/Grep 确定任务相关的工作区,无法确定时用 AskUserQuestion 询问用户选择目标工作区。
  • subagents 使用条件:适用于关键路径不明确、需要并行摸排多个模块、改动完成后需要额外只读审查;优先使用 Explore 进行上下文检索;不适用于单文件小改动、路径明确、主线程一次阅读即可完成的简单任务。
  • 不允许使用 Bash 调用外部模型、生成原型或执行额外编排;不允许保存、引用或交接任何外部会话标识。
  • subagents 不得直接实施代码修改,禁止多代理并行写同一任务。
  • 已委托给 subagents 的检索或审查内容,主线程不要重复执行。
  • 仅在本地验证时,按需运行最小相关范围的 lint / typecheck / tests;若信息不足,必须先提问再继续执行。

适用场景

已有经 /ac-plan 生成且获批的计划,需要按计划落地代码改动并做最小验证的开发任务;涉及多模块、需要先检索上下文再实施的改动;以及交付前需要额外只读审查的复杂场景。

限制

缺少计划、关键文件或验收标准时必须先向用户确认,不能直接执行;不得调用外部模型、生成原型或执行额外编排;不得保存、引用或交接外部会话标识;Subagents 不得直接改代码,禁止多代理并行写同一任务。关于本技能的安装命令、收费方式、所支持的平台等具体信息,资料暂未提供。