项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 73841
技术标签
使用教程
环境要求
- Node.js 20.19.0 或更高版本
- 可用的 AI 编程助手(Claude Code、Cursor、GitHub Copilot、Amazon Q、Codex 等 30+ 工具)
- 能访问 npm 源以全局安装包
- (可选)pnpm、yarn、bun 或 nix 作为替代安装方式
- 一个待接入 OpenSpec 的项目目录
安装与启动步骤
-
1安装 OpenSpec CLI
用 npm 全局安装官方包 @fission-ai/openspec,安装后会在终端提供 openspec 命令。
npm install -g @fission-ai/openspec@latest -
2进入项目目录
切换到你要引入规格驱动开发的已有项目根目录,OpenSpec 支持在存量项目上使用。
cd your-project -
3初始化 OpenSpec
在项目内执行初始化,会生成规格目录结构并输出你所选 AI 工具对应的调用命令形式。
openspec init -
4选择工作流配置
默认 profile 已含 explore 与 propose;如需 new/continue/ff/verify 等扩展工作流,先选 profile 再应用。
openspec config profile openspec update -
5用 AI 提出需求
在 AI 助手里输入斜杠命令提出要构建的内容;还没想清楚可先用 /opsx:explore 探索方案。
/opsx:propose "your idea" -
6如需让 AI 代装
可将 README 中的 setup prompt 粘贴给编码助手,由它安装 CLI、运行 init 并验证结果。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
profile | 否 | 切换默认或扩展工作流,选完后需执行 openspec update 生效。 | expanded |
如何确认成功
openspec init 执行无报错并在项目内生成规格结构,且 openspec init 输出中能看到对应 AI 工具的推荐调用命令。
常见问题
Q:不确定我的 AI 工具是否支持?
A:README 称支持 30+ 工具,可在仓库 docs/supported-tools.md 查看完整列表。
Q:为什么斜杠命令名字不一样?
A:/opsx:propose 是规范名,Cursor 与 GitHub Copilot 为 /opsx-propose,Amazon Q 为 @opsx-propose,Codex 为 $openspec-propose;openspec init 会打印你所选工具的正确形式。
Q:Node 版本不够怎么办?
A:README 明确要求 Node.js 20.19.0 或更高,请先升级 Node 再安装。
Q:能用 npm 以外的包管理器吗?
A:可以,README 说明同样支持 pnpm、yarn、bun 和 nix,具体见 docs/installation.md。
Q:推荐用什么模型?
A:官方建议使用高推理模型,规划与实现阶段推荐 Codex 5.5 和 Opus 4.7。
注意事项
- 开始实现前清空上下文窗口,保持良好上下文卫生,OpenSpec 在干净上下文中效果更好。
- 同时提供 CLI 与工作流集成,适配主流 AI 编码助手,支持个人项目到企业级规模。
- 除了 greenfield,也面向 brownfield 存量项目设计。
- 官网 https://openspec.dev 与仓库 docs 目录有更完整的安装与工作流说明。
核心亮点
- 把需求固化成结构化规格文件,AI 每次生成前先对齐,显著减少跑偏和返工
- 规格与任务拆解联动,让 AI 分步实现、过程可审查,而非一次性黑盒输出
- TypeScript 实现并提供 CLI,易接入现有仓库和主流 AI 编码助手工作流
不足之处
- 需要团队额外维护规格文档,前期投入增加,小项目可能觉得流程偏重
- 生态与集成仍在演进,不同 AI 助手的适配深度和最佳实践待观察
适用场景
- 用 Claude Code/Cursor 开发新功能前,先写规格再让 AI 实现
- 团队协作中让多个 AI 助手按同一份规格产出代码
- 把 AI 生成的代码纳入可审查的工程流程,降低失控风险
替代项目
GitHub Spec Kit、BMAD-METHOD
上一篇:jupyter-ai
下一篇:agent-skills
同类项目推荐
Prompt-sensei
开源
本地提示词教练,优化提问,提升 AI 编程效率
Local-first prompt coach for Claude Code and Codex that improves prompts, observes p···
ai-helpers
开源
给 AI 助手装上工具包,少写提示多干活
Developer productivity tools for Claude Code & other AI assistants
crit
开源
给AI代理装个反馈闭环,让每次修改都更懂你
Review AI coding agents' plans, diffs and running apps in the browser. Local-first, ···
multilspy
开源
用 Python 轻松对接各种语言服务器,快速构建代码智能工具
multilspy is a lsp client library in Python intended to be used to build application···
aider
开源
在终端里用 AI 结对编程,直接改代码并自动提交。
aider is AI pair programming in your terminal
llm-ls
开源
给任意编辑器接上大模型,代码补全即插即用
LSP server leveraging LLMs for code completion (and more?)
kota
开源
用 Rust 打造的轻量 AI 编码代理,插件化扩展你的开发流程。
A lightweight, highly extensible ai code agent, built in Rust.
misc_coding_agent_tips_and_scrip···
开源
把 AI 编程代理调顺手的踩坑笔记与脚本合集
Practical guides and scripts for AI coding agents, terminal customization, and remot···
oh-my-pi
开源
树莓派装上它,一句话就能指挥小电脑干活
⌥ Coding agent with the IDE wired in. Built by Stencil Labs.
