规范驱动开发

技能简介

这个技能使用OpenSpec CLI进行规范驱动开发。将AI辅助开发结构化，通过提案、规范、设计、任务等可追踪的变更工件指导实现。支持自定义工作流模式，管理从规划到实现的完整开发周期。

业务背景

规范驱动开发帮助团队把AI辅助开发从'随意聊天'变成'有章可循'。通过提案、规范、设计、任务四层结构化文档，让需求变更全程可追溯，减少沟通偏差和返工风险。业务人员能清晰看到每个功能从想法到落地的完整脉络，技术实现与业务目标始终对齐。

落地案例：某产品团队要开发新功能时，先创建变更提案明确业务价值，再用Given/When/Then格式写清用户场景，随后生成技术设计和任务清单。开发人员按图索骥，测试人员对照验收，产品经理随时用openspec show查看进度。功能上线后归档合并，形成可复用的知识资产。

能做什么

• 创建和管理结构化变更流程
• 生成提案、规范、设计、任务文档
• 使用Given/When/Then格式编写需求
• 验证变更完整性和一致性
• 归档变更并合并到主规范
• 支持自定义开发工作流模式

使用说明

安装OpenSpec CLI：

npm install -g @fission-ai/openspec@latest

安装技能：

clawhub install openspec

项目初始化：

cd /path/to/project
openspec init --tools claude

核心工作流（new → plan → apply → verify → archive）：

1. 创建变更

# 使用默认模式
openspec new change my-feature

# 使用特定模式
openspec new change my-feature --schema tdd-driven

2. 规划（创建工件）

# 获取下一步指令
openspec instructions --change my-feature --json

# 检查进度
openspec status --change my-feature --json

工件顺序：proposal.md（提案）→ specs/（规范）→ design.md（设计）→ tasks.md（任务）

3. 实现 – 按tasks.md逐项完成并标记

4. 验证

openspec validate --change my-feature --json

5. 归档

openspec archive my-feature --yes

常用命令：

• openspec list --json – 列出变更
• openspec show my-feature --json – 查看详情
• openspec schemas --json – 列出可用模式

规范格式：使用RFC 2119关键词（SHALL/MUST/SHOULD/MAY）和Given/When/Then场景。

输入与输出

见下方输入与输出表格。

风险提示

• 需要Node.js和npm环境
• 变更工件需手动维护同步
• 归档后变更会合并到主规范，不可随意修改
• 自定义模式需要理解schema结构
• 大型项目可能产生大量变更文件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jcorrego/openspec/SKILL.md
来源类型：github