SuperAPI AI 工具集

spec-driven-development

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:在写任何实现代码之前,先产出一份完整规格说明,作为 Define 阶段的规范技能。适用于启动新项目或模块、构建跨多个文件的功能、对现有行为做重大变更,以及干系人需要在开工前评审并批准范围时。

规格结构包含六部分:1)目标:功能做什么、为什么、目标用户与需求、可衡量的成功标准;2)接口契约:API 端点、CLI 命令或函数签名,输入输出形态与示例,错误情况与状态码;3)项目结构:新建文件、需修改的现有文件、相关目录布局;4)代码风格:语言与框架约定、命名模式、导入组织、错误处理模式;5)测试策略:测试框架与运行器、覆盖率目标(最低 80%)、单元/集成/端到端测试类别、关键路径覆盖要求;6)边界:始终遵守的规则、需干系人输入的决策、不可违反的硬约束。

流程:第一步收集需求,理解用户问题、识别约束与依赖、用提问澄清模糊需求;第二步编写规格,保存为 specs/{feature}/spec.md,覆盖上述六节,保持具体可执行;第三步评审与验证,确认验收标准可测试、边界清晰可执行、范围与变更相称;第四步获取批准,向干系人展示规格并在进入规划前处理反馈。

验证清单:六节齐全、验收标准可测试、边界含始终做/先询问/绝不做规则、规格保存在 specs/{feature}/spec.md。

限制与说明:资料未提供具体工具链、安装命令、收费或平台信息;默认输出要求为只返回结果、阻塞项与必要证据,省略前言、过程叙述、重复上下文、置信度分数与后续提议,除非必需产物或模式需要,否则最多五条要点。