刷到OpenSpec这个工具，感觉很有意思，在这分享下尝鲜经历。

安装

先安装，由于是第一次使用且日常开发环境以中文为主，选择了OpenSpec的中文汉化分支：openspec-cn（npm包：@studyzy/openspec-cn）。先选择阻力最小的方式跑通再逐步上手。

安装命令如下：

npm install -g @studyzy/openspec-cn@latest

什么是OpenSpec

OpenSpec是一个SDD工作流工具。安装并初始化后，该工具以skill方式存在于coding工具内。用户可以通过调用skill的方式，让agent显式创建tasks.md等文件，按照规划->实现->归档的方式编写代码。

SDD即Spec-Driven Development（规范/规格驱动开发）。该方法要求先把"要做什么、验收标准、技术方案、任务拆分"写成可追踪的spec（规范），再让AI按spec去实现。spec作为人和AI的source of truth。Martin Fowler的文章将其概括为："先写spec再让AI写代码（documentation first），spec是人和AI的共同真相来源"。

OpenSpec将这套SDD方法实现为轻量级工程化流程。流程包含变更文件夹结构、proposal/specs/design/tasks文档体系、以及apply/archive闭环操作。

功能价值

该工具将日常开发过程中常用的规范文档编写方法封装为技能模块。与superpowers相比，OpenSpec操作更简单并且显式展示tasks.md等内容。该设计解决了当前agent编写思路仅存在于自身会话中，其他工具或人员无法访问的问题，从而支持协同开发。

应用实例

选择了一个个人项目进行测试。该项目是一个双栈RPN计算器，对外发布地址如下：
ruali-dev/calcx: Small but complete expression evaluator (Tokenizer → Shunting-yard → RPN)

使用本地另一个分支进行初始化：

cd calcx-vibe
openspec-cn init

初始化过程显示终端界面，用户选择自己使用的开发工具，系统生成对应的模板和skills。

开始第一个变更，工作流程如下所示：

You: /opsx:propose 给当前的计算器项目增加一个计算sin,cos,tan的功能
AI:  Created openspec/changes/add-trig-functions/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 ...
     ✓ 1.2 ...
     ✓ 2.1 ...
     ✓ 2.2 ...
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/.../
     Specs updated. Ready for the next feature.

测试验证

完成实施后检查实现，系统生成了弧度制三角函数功能。执行两组测试用例验证，测试结果通过。

小结

OpenSpec对个人的意义在于，将平时组织规范的仓库上下文工作（编写AGENT.MD和设计提示词的操作）封装为Skills。该工具提供更清晰、更规范的spec编写技巧。

但是怎么说呢，这个上下文占用有点大，如果你的coding工具底模比较强（个人使用codex，该模型在安全规范方面表现突出),我觉得其实codex自己配上少量提示词就可以达成很规范的效果。

OpenSpec显式列出仓库的上下文信息和tasks，这一特性在以下场景中具有价值：协同开发、codex网络中断、其他能力较弱的coding agent使用。该工具需要记忆的命令数量较少，总之还是非常不错的。