@exodus/openspec

中文文档
1.3.0发布于 2026/04/10MITTypeScriptES Module近 30 天下载 2321

分类驱动发展的AI-内在系统

中文使用文档
文档目录12 节
  1. 团队
  2. 在行动中看到它
  3. 快速启动
  4. 文档
  5. 为什么是 OpenSpec ?
  6. 我们如何比较
  7. 更新 OpenSpec
  8. 用法说明
  9. 捐款
  10. 发展
  11. 其它
  12. 许可证

OpenSpec logo

CI npm version License: MIT Discord

最受爱戴的光谱框架.

Stars Downloads Contributors

我们的哲学:
→ fluid not rigid
→ iterative not waterfall
→ easy not complex
→ built for brownfield not just greenfield
→ scalable from personal projects to enterprises

[TIP] 现在有了新的工作流程! 我们重建了OpenSpec 新的工艺指导工作流程.

运行 /opsx:propose "your idea" 要开始。 → 在这里多学点

跟随 @ 0xTab 在 X 上显示 * 加入时 OpenSpec 磁盘 帮助和提问.

团队

在团队中使用 OpenSpec ? 邮件 进入我们的Slack频道.

在行动中看到它

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ 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 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.
打开Spec 板

OpenSpec dashboard preview

快速启动

需要20.19.0或更高节点.

全局安装 OpenSpec :

npm install -g @fission-ai/openspec@latest

然后导航到您的工程目录并初始化 :

cd your-project
openspec init

现在告诉你的AI: /opsx:propose <what-you-want-to-build>

如果你想要扩大工作流程(/opsx:new, (中文(简体) ), /opsx:continue, (中文(简体) ), /opsx:ff, (中文(简体) ), /opsx:verify, (中文(简体) ), /opsx:sync, (中文(简体) ), /opsx:bulk-archive, (中文(简体) ), /opsx:onboard中,选择 openspec config profile 并适用于: openspec update。 。 。 .

[注] 不确定您的工具是否被支持 ? 查看完整列表 -我们支持20+工具并不断增长.

还有活活活活活活活活活活活活活活. 参见安装选项。 。 。 .

文档

→ 开始: 第一步
→ 工作流量: 组合和图案
→ 图标: 斜线命令和技能( t)
→ 国 际: 终端参考
→ 支持的工具: 工具集成并安装路径
→ 概念: 如何适应
→ 多语言: 多语种支助
→ 自定义: 把它变成你的

为什么是 OpenSpec ?

AI编码助理很强大,但当要求仅活在聊天史上时却无法预测. OpenSpec 添加了轻量级的光谱层,所以在写入任何代码之前,您可以商定要构建什么 .

  • 在建造之前达成协议 ——在代码被写入之前,人类和AI在规格上一致
  • 保持组织 ——每次更改都获得自己的文件夹,其中包含提案,规格,设计和任务
  • 工作顺畅 ——随时更新任何文物,无硬相相门
  • 使用工具 通过斜线命令与20+AI助手合作

我们如何比较

文选. 斯凯特 (GitHub)——光泽但重量级. 硬相相门,多为马克倒,平通所设置. OpenSpec 轻而易举,并允许您自由脚步 .

文选. 基罗 (AWS)——强大的但你被锁定在他们的IDE中,并且仅限于克洛德模型. OpenSpec 使用您已经使用的工具 .

没有 ——AI编码无规格意味着模糊的提示和不可预测的结果. OpenSpec 带来了没有仪式的可预测性.

更新 OpenSpec

升级软件包

npm install -g @fission-ai/openspec@latest

刷新代理指令

在每个工程中运行此功能, 以重生 AI 引导并确保最新的 slash 命令活动 :

openspec update

用法说明

模型选择: OpenSpec最能用高理性模型. 我们建议规划和实施 " Opus 4.5 " 和 " GPT 5.2 " .

环境卫生: OpenSpec 从干净的上下文窗口中受益. 在开始实施前请明确你的背景,并在整个会议期间保持良好的环境卫生.

捐款

小修补 ——错误修正,打字修正,和小改进可以直接作为PR提交.

较大变化 ——对于新特征,重大重构,或建筑变化,请先提交OpenSpec更改提案,以便在实施开始前就意图和目标达成一致.

在撰写提案时,要牢记OpenSpec哲学:我们服务于跨越不同编码代理,模型,以及使用案例的各种各样的用户. 变革应该对每个人都有效.

欢迎AI生成代码 ——只要经过检验和核实. 包含AI生成代码的PR应当提及所使用的编码剂和模型(例如"Generated with Claude Code使用claude-opus-4-5-20251101).

发展

  • 安装依赖性 : pnpm install
  • 构建 : pnpm run build
  • 测试 : pnpm test
  • 本地开发 CLI : pnpm run dev 或者说 pnpm run dev:cli
  • 常规承诺(一行): type(scope): subject

其它

遥测

OpenSpec 收集匿名使用数据 .

我们只收集命令名称和版本来理解使用模式. 没有参数、路径、内容或PII。 CI 自动禁用 .

选择退出 : export OPENSPEC_TELEMETRY=0 或者说 export DO_NOT_TRACK=1

维护者和咨询者

见 安保人员 帮助指导项目的核心维护者和顾问名单.

许可证

麻省理工学院

版本与发布记录

@exodus/openspec 共发布 15 个版本,首次发布于 2026/04/01;过去 12 个月发布了 15 个版本。

版本发布日期距今
1.3.0latest2026/04/107 个月前
1.3.0-alpha.6alpha2026/04/107 个月前
1.3.0-alpha.52026/04/107 个月前
1.3.0-alpha.42026/04/107 个月前
1.3.0-alpha.32026/04/107 个月前
1.3.0-alpha.22026/04/107 个月前

关于 @exodus/openspec 的常见问题

@exodus/openspec 是什么?

分类驱动发展的AI-内在系统

如何安装 @exodus/openspec?

在项目目录运行 npm install @exodus/openspec,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 openspec,可以用 npx openspec 直接运行。

@exodus/openspec 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@exodus/openspec 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@exodus/openspec 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@exodus/openspec 可以商用吗?

@exodus/openspec 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/openspec 的下载量有多少?

根据 npm 官方下载统计,@exodus/openspec 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,321 次,日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/openspec 还在维护吗?

最新版本 1.3.0 发布于 2026/04/10(7 个月前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/04/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。