ajy/openspec/specs/README.md

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、代码审查）