fe55c532b8a28b3b3bc8cea6d8f2033537173502
- 新增 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
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 编程工具中实践 SDD(Specification-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 格式跟踪执行进度
工作流程
- design - 创建 design.md,记录变更的背景、需求、决策和执行计划
- tasks - 从 design.md 派生可执行的任务清单
- apply - 按依赖顺序执行任务并标记完成
使用方法
在 OpenSpec 项目中使用 fast-drive workflow:
# 初始化 OpenSpec 项目(如果尚未初始化)
openspec init
# 使用 fast-drive workflow 创建新变更
/opsx:propose "your-change-description" --schema fast-drive
开发说明
添加新的自定义 Schema
- 在项目根目录创建新的 schema 目录(如
my-schema/) - 创建
schema.yaml定义 workflow 结构 - 在
templates/目录下添加 artifact 模板 - 参考
fast-drive/的结构和 OpenSpec 的 schema 规范
更新 OpenSpec 子模块
# 更新到最新版本
git submodule update --remote OpenSpec
# 或者进入子模块目录切换到特定版本
cd OpenSpec
git checkout <version-tag>
cd ..
相关链接
License
MIT
Description
Languages
Markdown
100%