name: spec-creation description: 使用模式参考、接受标准和演示脚本创建规格说明。适用于创建实施规格、定义接受标准或分解用户故事时。
规格创建技能
目的
指导规格创建,包括清晰的接受标准、模式参考和可测试的成功验证。
适用场景
- 创建实施规格
- 分解用户故事
- 定义接受标准
- 将业务需求转换为技术规格
规格模板(必填)
# SPEC-{{TICKET_PREFIX}}-{number}: {功能名称}
## 摘要
{一段描述功能的文字}
## 用户故事
作为一个[用户类型],我想要[目标]以便[受益]。
## 接受标准
- [ ] {可测试的标准1}
- [ ] {可测试的标准2}
- [ ] {可测试的标准3}
## 模式参考
- **UI**: `docs/patterns/ui/{pattern}.md`
- **API**: `docs/patterns/api/{pattern}.md`
- **数据库**: `docs/patterns/database/{pattern}.md`
## 成功验证命令
```bash
{验证命令}
演示脚本
- 导航到{页面}
- 点击{按钮}
- 观察{预期行为}
逻辑提交
feat(scope): 实现数据模型 [{{TICKET_PREFIX}}-{number}]feat(scope): 添加API端点 [{{TICKET_PREFIX}}-{number}]feat(scope): 创建UI组件 [{{TICKET_PREFIX}}-{number}]
## 接受标准模式
```markdown
# 用户操作
- [ ] 用户可以{操作} → {结果}
# 数据
- [ ] 数据在{操作}后持久化
- [ ] 用户只能看到自己的{数据类型}
# 错误
- [ ] 无效输入显示{错误消息}
质量检查清单
- [ ] 所有接受标准都是可测试的
- [ ] 模式参考指向现有模式
- [ ] 成功验证命令可运行
- [ ] 引用了线性工单
参考
- 规格模板:
docs/archive/specs/spec_template.md - 模式库:
docs/patterns/README.md