# OpenSpec 规范目录

本目录包含项目的所有系统规范，是**当前真相来源**（Source of Truth）。

## 目录结构

```
openspec/
├── specs/              # 当前规范（像 Git 的 main 分支）
│   ├── README.md       # 本文件
│   ├── architecture/   # 架构规范
│   ├── api/            # API 规范
│   ├── ui/             # UI/UX 规范
│   └── data/           # 数据模型规范
│
└── changes/            # 变更提案（像 Git 的功能分支）
    └── [change-name]/
        ├── proposal.md   # 为什么要改
        ├── design.md     # 怎么改
        ├── tasks.md      # 实施检查清单
        └── specs/        # 规范的增量补丁
```

## 当前能力清单

| 能力 | 规范文件 | 状态 |
|------|---------|------|
| 项目初始化 | architecture/project-structure.md | 🟡 规划中 |
| 用户认证 | api/auth.md | ⚪ 未开始 |
| 艾灸椅控制 | api/moxibustion-control.md | ⚪ 未开始 |
| 数据持久化 | data/models.md | ⚪ 未开始 |

## 工作流程

1. **探索**: `/opsx:explore` — 思路不清晰，先聊聊
2. **提案**: `/opsx:propose <change-name>` — 思路清晰，直接生成规划
3. **实施**: `/opsx:apply <change-name>` — 按 tasks.md 逐项执行
4. **归档**: `/opsx:archive <change-name>` — 代码写完，合并规范

## 与 AGENTS.md 的关系

- **OpenSpec** = 定义"做什么"（需求、规范）
- **AGENTS.md** = 定义"怎么做"（技术约定、代码风格）
- **Superpowers** = 确保"按流程做"（强制执行 TDD、代码审查）