OpenSpec

它做什么

• 以变更为单位的工作流：/opsx:explore 打磨想法，/opsx:propose 生成 openspec/changes/<名>/（proposal、specs、design、tasks），/opsx:apply 实现，/opsx:archive 把差异并回 specs
• spec 就是普通 Markdown 需求加 WHEN/THEN 场景——AI 写、你审，代码一行没写先对齐
• 经斜杠命令适配 30+ AI 工具（Cursor 里拼作 /opsx-propose，Amazon Q 是 @opsx-propose，Codex 是 $openspec-propose）
• Stores（beta）：把 spec 放进独立仓库，靠 git 在团队与仓库间共享——所有编程 agent 读同一份事实源

什么时候用

想要 spec 纪律、又受不了 Spec Kit 全套阶段门的团队——按项目自己的定位，存量（brownfield）仓库也在射程内。最合适：横跨多仓库或多团队的功能（一份 store 归属的 spec，他方只读引用），以及在聊天历史里屡屡跑偏的个人开发者。README 建议规划与实现都配高推理档模型（Codex 5.5 / Opus 4.7）。

如何上手

npm install -g @fission-ai/openspec@latest（或 brew install openspec；需 Node.js 20.19.0 以上），然后在项目里执行：

openspec init

日后升级：重复同一行 npm，再在每个项目里跑 openspec update 刷新 agent 指令。

注意事项

匿名遥测（只上报命令名与版本）默认开启；用 openspec config set telemetry.enabled false、OPENSPEC_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭——CI 里自动停用。扩展命令集（/opsx:new、/opsx:ff、/opsx:verify 等）需经 openspec config profile 主动启用。Stores 处于 beta。上下文卫生很重要：README 建议实现前先清上下文。