基于 OpenSpec CLI 的规范驱动开发工具。适用于构建功能、迁移、重构或任何结构化开发工作。管理从提案、规格、设计、任务到实现的完整工作流。支持自定义模式(如 TDD、快速开发等)。在涉及功能规划、规格编写、变更管理或提及 /opsx 命令时触发。

安装

概览

OpenSpec 是一款基于 OpenSpec CLI 的规范驱动开发工具,专为结构化、可追踪的 AI 辅助开发流程而设计。它通过将开发工作划分为一系列可追溯的工件(artifacts),如提案、规格、设计和任务,来引导从构思到实现的完整开发周期。该工具适用于构建新功能、系统迁移、代码重构等各类需要系统化管理的开发任务。OpenSpec 的核心理念是将敏捷开发中的规划阶段显式化、文档化,从而提升团队协作效率与项目透明度。无论是个人开发者还是团队,都能借助 OpenSpec 建立清晰的开发节奏,确保每个变更都有据可依、有迹可循。其工作流程遵循 new → plan → apply → verify → archive 的闭环模式,帮助开发者保持专注并减少上下文切换带来的认知负担。

核心功能特点

  1. 支持多阶段规范化开发流程:从提案、规格编写、技术设计到实现任务的全链路管理
  2. 内置多种开发模式(如 TDD 驱动、快速开发等),并支持自定义 schema 扩展工作流
  3. 提供指令生成功能,自动为每个工件生成 enriched prompt,提升 AI 协作效率
  4. 集成验证机制,自动检查变更的完整性与一致性,确保交付质量
  5. 支持增量规格管理(Delta Specs),避免重复文档更新,简化合并流程
  6. 命令行接口丰富,支持 JSON 输出,便于集成到 CI/CD 或自动化脚本中

适用场景

OpenSpec 特别适用于那些需要高度结构化和可追溯性的软件开发场景。例如,在大型功能模块开发中,团队可以通过 proposal.md 明确业务意图,再通过 specs/ 目录下的 Given/When/Then 格式用例定义行为边界,最后用 design.md 描述技术实现路径,形成完整的知识沉淀。对于系统重构或遗留代码迁移项目,OpenSpec 的 Delta Specs 机制允许在不破坏原有文档的前提下,精准描述变更范围,降低风险。此外,当项目涉及频繁的需求变更或多人协作时,利用 tasks.md 中的可勾选清单进行任务分配和进度跟踪,能有效提升执行效率。无论是采用测试驱动开发(TDD)还是快速迭代模式,用户均可通过自定义 schema 灵活适配自身团队的工作习惯。总之,任何希望将 AI 辅助开发从‘黑箱’操作转变为透明、可控过程的组织,都能从中获益。