→ 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 板
快速启动
需要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
维护者和咨询者
见 安保人员 帮助指导项目的核心维护者和顾问名单.
许可证
麻省理工学院