openspec

📋 规范驱动的全周期开发管理

🥥58总安装量 15评分人数 12
100% 的用户推荐

基于 OpenSpec CLI 的规范驱动开发工具,结构化管理工作流(proposal→specs→design→tasks),提升团队协作与代码质量。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 纯文档型资产,无代码执行风险,无可执行脚本文件嵌入
  • ✅ 无数据收集行为、隐私信息传输或敏感凭证硬编码
  • ⚠️ 来源为 T3 级别个人开发者账号(jcorrego),社区维护规模有限
  • ⚠️ 依赖外部 npm 包 `@fission-ai/openspec`,需自行验证包来源与完整性
  • ⚠️ 文档中的 CLI 命令仅为操作示例,实际执行需用户手动确认并在受控环境中进行

使用说明

OpenSpec 是一款基于 CLI 的规范驱动开发管理工具,旨在将 AI 辅助开发转化为可追踪的结构化变更流程。其核心用法围绕五个阶段展开:通过 openspec new change 创建变更提案,依次生成 proposal.md(意图定义)、specs/(需求场景)、design.md(技术方案)和 tasks.md(任务清单),最终经 openspec validate 验证后归档。该工具支持与 Claude 深度集成,可自动生成 .claude/skills/ 目录下的代理配置,实现 AI Agent 式的开发辅助。

显著优点在于其严格的流程管控和可追溯性。通过 RFC 2119 标准关键词(SHALL/MUST/SHOULD)和 Given/When/Then 场景描述,确保需求表达的精确性;Delta Specs 机制避免直接修改主规格书,保证变更历史完整;支持 TDD、Rapid 等自定义 Schema,适应不同开发方法论。此外,纯 Markdown 格式的工件(Artifacts)具有极佳的可读性和版本控制友好性,便于团队协作与代码审查。

然而,该工具也存在一定局限性。首先,它强制要求安装 @fission-ai/openspec npm 包,增加了环境依赖;其次,对于小型项目或快速原型开发,完整的五阶段流程可能显得过于繁重,存在过度工程化风险;再者,当前 Skill 来源为 T3 级个人开发者,长期维护稳定性存疑;最后,工具主要面向英语开发环境,对中文团队可能存在一定使用门槛。

适合目标群体主要包括:中大型软件开发团队、需要严格需求变更管理的金融/企业级项目、采用 TDD 或 BDD 实践的开发组织,以及追求代码审查规范和文档完备性的技术团队。对于个人开发者或敏捷初创团队,建议评估流程开销是否匹配项目规模。

使用风险方面,除依赖项安全性外,还需注意:CLI 工具需全局安装权限,可能存在供应链攻击面;openspec init 会修改项目结构,建议先在版本控制环境下试用;自定义 Schema 功能虽强大,但错误的配置可能导致流程僵化。建议用户始终通过 --json 参数进行程序化交互,避免手动编辑引发的格式错误。

openspec 内容

文件夹图标references文件夹
手动下载zip · 3.9 kB
schemas.mdtext/markdown
请选择文件