SuperAPI AI 工具集

feature-implement

编程与开发

查看项目

更新于 11-06 09:13

技能介绍

用途:feature-implement 用于把“想法或功能描述”推进为已交付功能,适用于尚无计划文件的场景。技能强调实现服务于已保存的 Goal Contract(目标契约),而非聊天记忆。

主要能力:

  1. 目标契约读取:实现前解析并读取已保存的成功标准,完成后向目标文件追加迭代日志,记录结果、证据引用和剩余差距。
  2. 深度研究:并行启动多个研究员子代理,覆盖技术方案验证、边界情况与失败模式、安全影响、性能考量;研究结果写入 tmp/analysis/{task-name}.analysis.md,规划前完整重读。
  3. 计划:使用 planner 子代理生成完整计划目录(plan.md 与各阶段文件),包含每阶段成功标准和回滚策略,并要求用户批准。
  4. 实现:逐阶段实现,并在同一遍中为每阶段编写测试;每阶段后只做类型检查和编译,自审后继续;大型计划(10 个以上任务)按批执行并等待人工反馈。
  5. 强制静态代码审查:由 code-reviewer 子代理审查整个变更集,不运行测试;按轮次处理发现项,最多三轮,重复或无进展的问题升级询问用户。
  6. 强制验证一次:由 tester 子代理对受影响测试套件运行一次,再自行对改动的核心逻辑行和新规则运行变异检查;红测试或存活变异需在源头修复并重跑,修复后需重跑代码审查。
  7. 文档更新:使用 docs-manager 更新相关文档;必要时先以 $spec 的测试模式补齐测试用例,再做规范同步收尾。

使用方式:技能以命令/技能调用形式触发,可传入功能描述参数($ARGUMENTS)。默认走完整严谨流程;仅当任务确实简单(单文件且改动不超过 30 行、无设计选择、无跨服务影响或契约变更、无新依赖、沿用现有模式、已有测试覆盖或改动非功能性)时才可进入快速模式。快速模式仅跳过研究员阶段、强制代码审查和单独测试阶段,计划步骤、测试执行和文档更新分诊仍保留。涉及后端时可参考 CQRS、实体目录等参考文档;涉及前端参考组件模式、样式与设计系统令牌;涉及模型调用、提示词、智能体、工具/MCP、检索或评估时需应用 AI 工程门禁。

协议约束:步骤须按声明顺序执行,未经用户批准不得跳过、重排或合并;每步开始与结束更新待办跟踪;完成或跳过的步骤须附证据或明确跳过原因;除非用户批准偏离,否则保持协议顺序。

与 plan --mode=execute 的区别:feature-implement 负责流水线前端(研究加规划),从想法到研究、在此创建计划、再交付;当计划文件已存在、只需按阶段执行并提交时,应改用 $plan --mode=execute(负责阶段门禁、自动提交及并行/批准/测试等标志)。

限制与说明:资料未提供该技能的收费、价格、平台适用范围或安装命令;其依赖 Claude 或 Codex 宿主环境及相应子代理、技能机制,在 Codex 中需以 $skill-name 形式加载注册的 SKILL.md。工具名称需映射到宿主能力,实际不可用的必需能力应停在对应步骤并询问用户。