name: 规范管理 description: 规范驱动开发的核心权威。当处理需求、规格、验收准则或任何规范驱动的工作流时使用。 allowed-tools: 读取, 全局, 搜索, 技能

规范管理

规范驱动开发工作流的中心枢纽。本技能提供导航到不同规范格式和工作流的专业技能。

何时使用本技能

关键词: 规格, 需求, 验收准则, 规范驱动开发, SDD, EARS, Gherkin, Kiro, Spec Kit, BDD, 用户故事, 功能规格, 规范规范

在以下情况使用本技能:

启动新的规范驱动工作流
在规范格式之间转换
了解可用的规范提供者
导航到专业编写技能
处理规范规范模型

快速决策树

您想做什么？

启动 Spec Kit 5 阶段工作流 → 使用 /spec:speckit:run 或查看 speckit-workflow 技能
生成规格 → 使用 /spec:specify 命令
编写 EARS 需求 → 查看 ears-authoring 技能
编写 Gherkin 场景 → 查看 gherkin-authoring 技能
与 AWS Kiro 同步 → 查看 kiro-integration 技能
检查需求质量 → 查看 requirements-quality 技能
理解规范格式 → 查看 canonical-spec-format 技能
在格式之间转换 → 使用 /spec:convert 命令

规范提供者

规范规范模型 (ADR-115) 支持多个提供者:

提供者	格式	最适合
ears	EARS 语法	精确、无歧义的需求
gherkin	.feature 文件	使用 Reqnroll 的 BDD 测试
kiro	AWS Kiro	与指导文件的 IDE 集成
speckit	GitHub Spec Kit	AI 代理提示, 5 阶段工作流
adr	MADR 格式	架构决策
userstory	敏捷格式	产品待办事项
canonical	YAML/JSON	直接规范格式

Spec Kit 5 阶段工作流

GitHub Spec Kit 工作流指导功能开发:

阶段	工件	目的
0	`.constitution.md`	项目原则和约束
1	`feature.md`	从需求生成的规格
2	`design.md`	实现方法
3	`tasks.md`	任务分解
4	代码	指导实现

完整工作流: 使用 /spec:speckit:run 或调用 speckit-workflow 技能。

规范规范模型

所有提供者都转换到/从规范模型:

id: "SPEC-001"
title: "功能标题"
type: feature | bug | chore | spike | tech-debt

context:
  problem: "问题描述"
  motivation: "业务价值"

requirements:
  - id: "REQ-001"
    text: "EARS 格式需求"
    priority: must | should | could | wont
    ears_type: ubiquitous | state-driven | event-driven | unwanted | complex | optional
    acceptance_criteria:
      - id: "AC-001"
        given: "前置条件"
        when: "动作"
        then: "预期结果"

traceability:
  adr_refs: ["ADR-115"]
  requirement_refs: ["FR-001"]

metadata:
  status: draft
  created: "YYYY-MM-DD"
  provider: canonical
  bounded_context: "WorkManagement"

完整模式: 查看 canonical-spec-format 技能或 schemas/canonical-spec.schema.json

可用命令

通用工作流命令

命令	目的
`/spec:specify`	阶段 1: 从需求生成规格
`/spec:plan`	阶段 2: 生成实现计划
`/spec:tasks`	阶段 3: 生成任务分解
`/spec:implement`	阶段 4: 指导实现
`/spec:validate`	针对模式验证规格
`/spec:refine`	AI 辅助规格优化
`/spec:audit`	审核规格质量
`/spec:convert`	在格式之间转换

提供者深度命令

命令	目的
`/spec:ears:author`	交互式 EARS 模式编写
`/spec:ears:convert`	转换到/从 EARS 格式
`/spec:gherkin:author`	交互式 Gherkin 场景编写
`/spec:gherkin:convert`	转换到/从 .feature 文件
`/spec:kiro:sync`	与 AWS Kiro 规格同步
`/spec:speckit:run`	执行完整 Spec Kit 5 阶段工作流
`/spec:adr:create`	从规格上下文创建 ADR
`/spec:userstory:author`	编写带验收准则的用户故事
`/spec:constitution`	创建或更新项目章程
`/spec:status`	显示规格状态仪表板

委托模式

本技能委托给专业技能以获取详细指导:

主题	委托给
EARS 模式	`ears-authoring` 技能
Gherkin/BDD	`gherkin-authoring` 技能
AWS Kiro	`kiro-integration` 技能
Spec Kit 工作流	`speckit-workflow` 技能
质量准则	`requirements-quality` 技能
规范格式	`canonical-spec-format` 技能
官方 Claude Code 文档	`docs-management` 技能

仓库基础设施

本插件与项目基础设施集成:

资源	目的
`schemas/canonical-spec.schema.json`	规范规格 JSON 模式
`prompts/specify.prompt.md`	阶段 1 的生成模板
`templates/EARS-REQUIREMENT-TEMPLATE.md`	EARS 模式参考
`docs/adr/ADR-115-*`	规范提供者抽象

参考

详细文档:

最后更新: 2025-12-24

版本历史

v1.0.0 (2025-12-26): 初始发布

规范管理Skill spec-management