规范驱动开发框架

OpenSpec是一个规范驱动的开发框架，用于协调人类开发者与 AI 编程助手之间的协作。

让输出结果更可预测，也更符合共识，而非通过自然语言生成的模糊代码

OpenSpec 的核心特点

1. 规范驱动开发

• 通过结构化的规范文档管理需求
• 确保开发过程的可预测性和可审查性
• 减少 AI 生成代码的不确定性

2. 变更即代码（Change-as-Code）

• 将软件变更抽象为可版本化、可验证的规范资产
• 确保设计与实现的一致性

3. 轻量级

• 无需 API 密钥
• 安装和使用简单

OpenSpec 的工作流程

1. 初始化项目：openspec init 创建规范文档结构
2. 创建变更提案：在 openspec/changes/ 下创建变更文档
3. 审查与对齐：团队和 AI 共同审核变更提案
4. 实施变更：按照任务列表逐步实现
5. 归档变更：使用 openspec archive 归档到 openspec/specs/

适用场景

• 与 AI 编程助手（如 Cursor、Claude Code）协作开发
• 需要规范化和可验证的开发流程
• 在现有项目基础上进行迭代开发
• 需要持续集成和自动化验证

项目结构示例

项目根目录/
├── openspec/
│   ├── specs/        # 已归档的规范
│   └── changes/      # 新的变更提案
│       ├── proposal.md
│       ├── tasks.md
│       └── specs/

实战

# 1. 检查 Node.js 版本（需要 >= 20.19.0）
node --version

# 2. 全局安装 OpenSpec CLI
npm install -g @fission-ai/openspec@latest

# 3. 进入项目目录并初始化
cd /Users/pcm/Documents/WorkSpace/taro-test
openspec init

---

playwright mcp

私域知识库确实不适合代码索引，需要使用专门针对代码设计的知识库系统，这样才能真正理解组件库的结构和用法，生成高质量的代码！