openspec

# OpenSpec 规范驱动开发助手

OpenSpec 是规范驱动的 AI 编程框架。核心理念：**在编写代码前，与 AI 就需求达成一致**。

## 核心原则

- **流动而非僵化** - 随时处理任何工件，无阶段门控
- **迭代而非瀑布** - 边构建边完善理解
- **简单而非复杂** - 最小化设置和仪式
- **棕地优先** - Delta 方式修改现有系统

## 触发场景

### 明确触发

- 用户提及 "openspec"、"opsx"
- 用户使用 `/opsx:*` 斜杠命令
- 用户提及 "规范驱动开发"、"spec-driven"
- 用户询问如何管理需求或规范文档

### 上下文触发

- 用户开始新功能开发前（建议使用 OpenSpec）
- 用户抱怨 AI 理解偏差或频繁返工
- 用户询问如何让 AI 更准确理解需求
- 用户需要生成技术文档或设计文档

### 项目阶段触发

- 项目初始化阶段（建议配置 OpenSpec）
- 准备重大重构时（建议先写规范）
- 团队协作场景（需要统一的需求描述）
- 复杂功能开发前（需要明确需求边界）

### 适用场景

**推荐使用**：

- 改进现有项目（棕地开发）
- 需要高质量实现的关键功能
- 团队协作开发
- 需要长期维护的项目

**不推荐使用**：

- 快速原型验证（0→1 探索）
- 一次性小脚本
- 需求极度不明确的创新探索

## 目录结构

```plain
openspec/
├── config.yaml           # 项目配置（可选）
├── specs/                # 当前系统行为（事实来源）
│   ├── auth.md
│   └── api.md
├── changes/              # 活跃变更
│   └── add-feature/
│       ├── .openspec.yaml
│       ├── proposal.md
│       ├── specs/
│       ├── design.md
│       └── tasks.md
├── archive/              # 已归档变更
│   └── 2025-01-23-add-feature/
└── schemas/              # 自定义工作流（可选）
    └── my-workflow/
        ├── schema.yaml
        └── templates/
```

## 斜杠命令

| 命令                 | 功能                              |
| -------------------- | --------------------------------- |
| `/opsx:explore`      | 探索想法、调查问题、明确需求      |
| `/opsx:new`          | 启动新变更                        |
| `/opsx:continue`     | 创建下一个就绪工件                |
| `/opsx:ff`           | 快进 - 一次创建所有规划工件       |
| `/opsx:apply`        | 实施任务，按需更新工件            |
| `/opsx:verify`       | 验证实现的完整性、正确性、一致性  |
| `/opsx:sync`         | 同步 delta specs 到主规范（可选） |
| `/opsx:archive`      | 归档完成的变更                    |
| `/opsx:bulk-archive` | 批量归档多个变更                  |
| `/opsx:onboard`      | 交互式教程                        |

## CLI 命令

```bash
openspec init                              # 初始化项目
openspec update                            # 更新指令文件
openspec list                              # 列出活跃变更
openspec show <name>                       # 查看变更详情
openspec validate <nam