SuperAPI AI 工具集

sdd-implement

编程与开发

查看项目

更新于 10-16 01:57

技能介绍

用途

sdd-implement 是 SDD(规格驱动开发)工作流的第 4 步,用于在已有实现计划的前提下,由 AI 扮演资深软件工程师,精确执行 plan.md 中定义的功能实现,并在完成后验证所有验收标准是否满足。它应在 /sdd-plan 产出 plan.md 之后使用。

前置条件

使用前需确认以下文件存在:

  • plan.md —— 实现计划
  • feature.md —— 功能规格(含验收标准)
  • docs/project.md —— 项目上下文

主要流程

  1. 完整阅读:在写任何代码之前,先读取 plan.md、feature.md 和 docs/project.md。

  2. 按顺序执行步骤:依次处理 plan.md 中的每个步骤,每步需说明正在开始哪一步,创建或修改指定文件,严格遵循 docs/project.md 中的架构模式,不得跳过或重排步骤(除非说明原因)。步骤完成并验证后,在 plan.md 中把该步骤行的 - [ ] 改为 - [x](若计划未使用复选框,则前置 ✅ 标记)。

  3. 代码质量规则:遵循代码库已有约定(先阅读现有的类似文件),为所用技术栈编写干净、地道的代码,为公共 API 添加文档,未经向用户提示不得引入新依赖。

  4. 每层完成后运行验证:每完成一个步骤,从 docs/project.md 中运行对应的构建/测试命令——schema 变更后检查迁移能否干净应用;每个新源文件后编译(使用项目编译命令);测试编写后运行(使用项目测试命令)。出现失败必须先修复再继续下一步。

  5. 最终验收标准检查:所有步骤完成后,遍历 feature.md 中的每一条验收标准,找到并运行覆盖它的测试,逐条报告通过/失败。不要在 feature.md 中更新验收标准状态。

  6. 汇总报告:在项目根目录创建 impl-summary.md,内容包括:实现完成说明、创建的文件、修改的文件、验收标准(逐条以复选框加测试名标注通过情况)、备注(与计划的偏差及原因)。每条保持单行简洁条目。写完文件后告诉用户 “impl-summary.md created.”,并提示用户在归档前运行 /sdd-review。

适用场景

适用于已通过 SDD 流程完成规划、需要按既定计划逐步实现功能的开发场景,尤其适合希望实现过程可追溯、验收标准可验证的团队。

限制

该技能依赖 plan.md、feature.md、docs/project.md 三个前置文件;资料未提供其他平台、收费或版本信息。