@menukfernando/openspec
v0.2.3
Published
The universal AI context infrastructure. Let AI generate your project rules, we sync them everywhere.
Maintainers
Readme
✨ 为什么选择 OpenSpec?
如果您使用多个 AI 工具,您就会面临 上下文碎片化问题。
- Cursor 需要
.cursorrules - Claude Code 需要
CLAUDE.md - Aider 需要
.aiderrules - Copilot 需要
.github/copilot-instructions.md
当您的项目规范演进时,您必须手动更新 7 个以上不同的文件。漏掉一个,您的 AI 助手就会开始编写不一致的代码。
OpenSpec 是 AI 上下文的“转译器”。 您可以在整洁、模块化的 Markdown 文件中定义规则,OpenSpec 会为您的技术栈中的每个 AI 代理生成优化后的格式。
🚀 核心特性
- 🤖 AI 原生工作流: 专为由您的 AI 代理自主管理而设计。
- 🔄 通用同步: 支持 Cursor, Claude, Gemini, Copilot, Aider, Codex 和 Windsurf。
- 🧠 零初始化配置:
openspec analyze扫描您的代码库,并告诉 AI 该编写哪些规则。 - 🔌 Claude Code 优先: 针对最新、最强大的 AI 编程工具的原生插件。
- 🛠️ 监听模式: 在您保存模块时实时自动同步。
问题所在
每个 AI 工具都有自己的上下文文件(CLAUDE.md, .cursorrules, GEMINI.md 等)。当项目规范变化时,手动同步极其痛苦且容易出错。
OpenSpec 作为 AI 代理的上下文层来解决这个问题。
解决方案
.openspec/modules/ ← AI 在这里编写您的规则
├── shared.md
├── frontend.md
└── backend.md
│
▼ AI 运行 openspec sync
│
CLAUDE.md ← 已生成
.cursorrules ← 已生成
GEMINI.md ← 已生成
... (7+ 种输出) ← 已生成单一事实来源。七种输出。零手动工作。
⚡ 真正零手动工作 (推荐)
OpenSpec 专为 AI 代理自主管理而构建。您甚至不需要初始化项目——AI 会为您完成。
1. 添加到 Claude Code
在您的 Claude Code 会话中运行以下命令:
/plugin marketplace add fernandomenuk/openspec
/plugin install openspec@openspec2. 自动配置
运行配置命令:
/openspec:configure就这么简单。 Claude 将分析您的代码库,创建规则,并同步到您技术栈中的每个工具。
🔧 许可证
MIT — 详见 LICENSE。
