规格创建与定义技能Skill spec-creation

本技能用于指导创建详细的技术规格说明,包括定义清晰的接受标准、参考现有模式、提供可测试的成功验证方法,适用于软件开发、产品管理和需求分析场景。关键词:规格创建、接受标准、模式参考、技术文档、需求分析、产品管理、SEO。

需求分析 0 次安装 0 次浏览 更新于 3/15/2026

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
{验证命令}

演示脚本

  1. 导航到{页面}
  2. 点击{按钮}
  3. 观察{预期行为}

逻辑提交

  1. feat(scope): 实现数据模型 [{{TICKET_PREFIX}}-{number}]
  2. feat(scope): 添加API端点 [{{TICKET_PREFIX}}-{number}]
  3. feat(scope): 创建UI组件 [{{TICKET_PREFIX}}-{number}]

## 接受标准模式
```markdown
# 用户操作
- [ ] 用户可以{操作} → {结果}

# 数据
- [ ] 数据在{操作}后持久化
- [ ] 用户只能看到自己的{数据类型}

# 错误
- [ ] 无效输入显示{错误消息}

质量检查清单

  • [ ] 所有接受标准都是可测试的
  • [ ] 模式参考指向现有模式
  • [ ] 成功验证命令可运行
  • [ ] 引用了线性工单

参考

  • 规格模板: docs/archive/specs/spec_template.md
  • 模式库: docs/patterns/README.md