SpecMind 是基于 OpenSpec 深度优化的内部 SDD(Spec-Driven Development)框架,能够从需求片段生成完整技术规范、API 契约和数据字典,并反向校验代码与规范的一致性。
1. 规范编写耗时:从零编写技术规格说明书效率低、容易遗漏
2. 接口契约不一致:前后端对接时接口定义频繁变更、文档滞后
3. 数据模型混乱:缺乏统一的数据字典,字段含义理解偏差
4. 代码与规范脱节:实现阶段偏离原始设计,缺乏自动化校验手段
5. 知识沉淀困难:项目规范散落在不同文档中,难以复用
1. 将本 Skill 放入 Claude Code 的 skills 目录
2. 提供需求片段或用户故事作为输入
3. 按阶段执行:生成规范 → 设计契约 → 构建字典 → 校验代码
4. 输出完整技术资产和一致性报告
无需额外依赖,直接放入 skills 目录即可使用。
推荐在项目根目录创建 specs/ 目录存放生成的规范文件:
``
project/
├── specs/
│ ├── tech-spec.md
│ ├── api-contract.yaml
│ └── data-dict.md
└── src/
`
`
根据以下需求生成技术规范:
用户需要在一个电商系统中实现"秒杀下单"功能,要求支持库存预扣、订单超时取消、防重复提交。
`
`
基于上述技术规范,设计前后端交互的 API 契约,包含秒杀接口和订单查询接口。
`
`
为秒杀功能涉及的数据库表生成数据字典,包括商品库存表、订单表、秒杀活动表。
`
`
请校验以下代码实现是否与规范一致:
[粘贴代码片段]
`
详见 SKILL.md` 了解完整的角色定义、工作流和输入输出格式。