lanyuanxiaoyao fe55c532b8 feat: 添加 code-drive 自定义 schema 与参考资料重组
- 新增 code-drive schema(5 阶段:requirements -> design -> plan -> tasks -> apply)
- 每阶段含 instruction、self-review、用户确认门和工具集成指引
- apply 支持阻塞回退机制(blocker.md + blocker-revise.md skill)
- apply 支持 subagent 并行执行独立任务
- TodoWrite 职责区分:撰写阶段跟踪文档撰写流程,apply 跟踪执行进度
- 将 OpenSpec 子模块移至 references/,新增 superpowers 和 spec-kit 参考
- 添加项目规范 AGENT.md
2026-06-07 13:35:26 +08:00

OpenSpec Schema

当前项目用于开发 OpenSpec 工具的自定义 schema 流程。

项目结构

openspec-schema/
├── OpenSpec/          # OpenSpec 工具源码Git 子模块)
├── fast-drive/        # 自定义 workflow schema
│   ├── schema.yaml    # workflow 定义文件
│   └── templates/     # artifact 模板
│       ├── design.md  # 设计文档模板
│       └── tasks.md   # 任务清单模板
├── .gitignore
└── .gitattributes

关于 OpenSpec

OpenSpec 是一款用于在 AI 编程工具中实践 SDDSpecification-Driven Development开发流程的工具。工具源码位于 OpenSpec 目录下(以 Git 子模块形式引用)。

fast-drive Schema

fast-drive 是一个简化版的 OpenSpec workflow采用 design → tasks → apply 的精简流程:

特点

  • 跳过 proposal 和 specs 阶段:直接从 design.md 开始
  • 中文支持design.md 和 tasks.md 使用中文章节标题和正文
  • 自包含设计design.md 包含所有必要信息,即使跨会话也能继续执行
  • 结构化任务管理tasks.md 使用 checkbox 格式跟踪执行进度

工作流程

  1. design - 创建 design.md记录变更的背景、需求、决策和执行计划
  2. tasks - 从 design.md 派生可执行的任务清单
  3. apply - 按依赖顺序执行任务并标记完成

使用方法

在 OpenSpec 项目中使用 fast-drive workflow

# 初始化 OpenSpec 项目(如果尚未初始化)
openspec init

# 使用 fast-drive workflow 创建新变更
/opsx:propose "your-change-description" --schema fast-drive

开发说明

添加新的自定义 Schema

  1. 在项目根目录创建新的 schema 目录(如 my-schema/
  2. 创建 schema.yaml 定义 workflow 结构
  3. templates/ 目录下添加 artifact 模板
  4. 参考 fast-drive/ 的结构和 OpenSpec 的 schema 规范

更新 OpenSpec 子模块

# 更新到最新版本
git submodule update --remote OpenSpec

# 或者进入子模块目录切换到特定版本
cd OpenSpec
git checkout <version-tag>
cd ..

相关链接

License

MIT

Description
No description provided
Readme 91 KiB
Languages
Markdown 100%