SuperAPI AI 工具集

sdd-refine

编程与开发

查看项目

更新于 10-16 01:57

技能介绍

用途

sdd-refine 是 SDD(Spec-Driven Development,规格驱动开发)流程中的第 2 步技能,标记为可选且可重复。它的作用是读取已存在的功能规格文件 feature.md,根据用户输入对需求进行更新或增强。

主要能力

  • 在对话中收集 refinement_request(细化请求),即用户想要修改或新增的内容,例如“增加限流——每分钟最多 5 次登录尝试”。
  • 读取 feature.md 当前状态,同时读取 docs/project.md 项目上下文与约束,以及 plan.md(若存在)以判断哪些实现计划可能失效。
  • 分析细化请求影响哪些章节,判断变更属于扩大范围、缩小范围还是澄清既有范围,并识别连带影响(例如某条需求变更可能导致其他验收标准失效)。
  • 在请求含糊或不完整时提出澄清问题,数量控制在 3 个以内,并等待用户回答。
  • 在编辑前展示变更摘要,分为新增(Additions)、修改(Modifications)、删除(Removals)和不变(No Change)四类,请用户确认后再执行。

使用方式

  1. 输入校验(必须首先执行):检查对话中是否包含 refinement_request,以及项目根目录是否存在 feature.md。若 feature.md 不存在,则停止并提示用户先运行 /sdd-feature。若 refinement_request 缺失,则询问用户想要更改或新增什么,以及这是范围变更、澄清还是新边界情况,并等待用户提供后才继续。
  2. 读取当前状态:读取 feature.md、docs/project.md,以及存在时的 plan.md。
  3. 理解细化请求:对照现有 feature.md 分析受影响章节、范围变动与连带影响。
  4. 必要时提出澄清问题(不超过 3 个)。
  5. 编辑前展示变更摘要并获得确认。
  6. 原地应用细化:更新 feature.md,尽量保留原有章节结构与编号,保留验收标准上已勾选的复选框,保留 ## Open Questions 章节(解决本次细化已回答的问题,并在产生新问题时补充),需求 ID 按顺序递增且不复用已删除的 ID。
  7. 影响评估:若 plan.md 存在,分析哪些步骤需要重做,并建议在实现前再次运行 /sdd-plan 重新生成计划;若不存在,则确认规格已更新并提示用户运行 /sdd-plan。
  8. 变更记录:在 feature.md 底部追加修订历史,若已有 Revision History 表格则新增一行,不重建表格。

适用场景

  • 需求逐步完善:功能规格初稿完成后,按用户反馈持续增补或调整需求。
  • 范围调整:扩大、缩小或澄清既有功能范围。
  • 补充边界情况:加入新的验收标准或异常场景。
  • 在生成实现计划前后对规格进行修订并评估其影响。

限制

  • 依赖已存在的 feature.md;若缺失必须先运行 /sdd-feature。
  • 需要用户提供 refinement_request,否则不会继续执行。
  • 编辑前必须获得用户确认。
  • 官方资料未提供关于收费、价格、平台支持范围等具体信息,暂未提供。