OpenSpec Superpowers — SDD 驱动开发模板

基于 OpenSpec + SuperPowers SDD（规范驱动开发） 的通用项目模板。提供完整的项目骨架、OpenSpec 工作流配置和 AI Coding 指令体系，开箱即用。

核心理念

规范先行 → 原子化 TDD → 子代理隔离执行 → 证据驱动验证

每一个变更都经过 propose → specs → design → tasks → plans → apply 的完整管线，确保行为可测试、过程可追溯、结果可验证。

项目结构

CLAUDE.md              # AI Coding 项目指令（核心入口）
AGENTS.md              # 内容指向 CLAUDE.md
README.md              # 本文件
Makefile               # 质量检查统一入口
src/                   # 生产源码
  __tests__/           #   单元测试
openspec/              # OpenSpec 工作流配置与产物
  config.yaml          #   工作流配置
  schemas/             #   Schema 定义 + 模板
  specs/               #   功能规格
  changes/             #   变更记录
scripts/               # 辅助脚本
docs/                  # 详细文档
  architecture.md      #   分层架构、依赖规则、领域模型
  development.md       #   环境要求、构建运行、测试
  design-docs/         #   设计文档
user-guide/            # 用户手册（AI 基于代码生成）
reference-projects/    # 参考项目（git submodule，只读）

快速开始

1. 配置技术栈：编辑 openspec/config.yaml，填入项目的语言、框架、测试命令
2. 安装依赖：根据项目技术栈安装依赖
3. 运行检查：make check 确认环境就绪
4. 第一个变更：在 AI 对话中输入 /opsx:propose 创建变更提案

OpenSpec SDD 工作流

步骤	命令	做什么
1. 提案	/opsx:propose	描述变更，AI 自动生成 proposal / specs / design / tasks / plans
2. 执行	/opsx:apply	AI 按原子化 TDD 任务逐个实现，子代理隔离执行
3. 归档	/opsx:archive	完成后归档变更，更新 specs

自定义

• 修改 Makefile 适配项目的构建/测试/格式化命令
• 补充 docs/architecture.md 和 docs/development.md
• 在 reference-projects/ 中添加参考项目（git submodule）
• 按需在 docs/design-docs/ 下添加设计文档