OpenSpec汉化版
See the code
[!NOTE] 本项目为中文汉化分支：openspec-cn（npm：
@studyzy/openspec-cn）。原版项目：OpenSpec 仓库：https://github.com/Fission-AI/OpenSpec npm：
@fission-ai/openspec
→ 灵活，而非僵化
→ 迭代，而非瀑布式
→ 简单，而非复杂
→ 面向存量项目（brownfield），而不只是新项目（greenfield）
→ 从个人项目到企业规模都可扩展
关注 X 上的 @0xTab 获取更新 · 加入 OpenSpec Discord 获取帮助与答疑。
你：/opsx:explore
AI： 你想探索什么？
你：我想做深色模式，但不确定怎么搞才干净。
AI： 让我看看你的样式方案...
最干净的路径：CSS 变量 + 一个小型主题上下文，
加上系统偏好检测。不需要新依赖。要划定范围吗？
你：好，开始吧。
你：/opsx:propose add-dark-mode
AI：已创建 openspec/changes/add-dark-mode/
✓ proposal.md — 为什么要做这个，什么在变
✓ specs/ — 需求和场景
✓ design.md — 技术方案
✓ tasks.md — 实现清单
准备好开始实现了！
你：/opsx:apply
AI：开始实现任务...
✓ 1.1 添加主题上下文 Provider
✓ 1.2 创建切换组件
✓ 2.1 添加 CSS 变量
✓ 2.2 接入 localStorage
所有任务已完成！
你：/opsx:archive
AI：已归档至 openspec/changes/archive/2025-01-23-add-dark-mode/
Specs 已更新。可以开始下一个功能了。
Plain Markdown — requirements with concrete scenarios, no special syntax to learn. Here's what goes in the specs/ folder created above:
## ADDED Requirements
### Requirement: Theme selection
The app SHALL let users switch between light and dark themes,
defaulting to the system preference.
#### Scenario: User toggles dark mode
- **WHEN** the user clicks the theme toggle
- **THEN** the app switches to dark mode and persists the choice
Your AI writes these; you review the plan before any code is written.
OpenSpec is built with OpenSpec — browse this repo's live specs and in-flight changes for real examples at scale.
单人开发时，OpenSpec 让你和你的 AI 在同一个仓库里保持诚实。在团队中，难点转移了：一个功能横跨 API 服务、Web 应用和一个共享库；需求由一个团队拥有，却被其他团队消费；规划在你写任何代码之前就已经开始。
Stores 就是答案 —— 把规划放到一个独立的仓库里。你熟悉的 openspec/ 形态（specs 和 changes）原样保留，通过 git push 像其他东西一样共享。整个团队和每个编码代理都能跨仓库读取的单一事实来源。
Stores 目前处于 beta 阶段。请从 Stores 指南 开始。
需要 Node.js 20.19.0 或更高版本。 Homebrew 会将其作为依赖一并安装。
全局安装 openspec-cn：
npm install -g @studyzy/openspec-cn@latest
也可以在 macOS 或 Linux 上安装官方的 Homebrew formula：
brew install openspec
然后进入你的项目目录并初始化：
cd your-project
openspec-cn init
想让你的 AI 来完成？ 把安装提示词粘贴给你的编程助手 —— 它会安装 CLI、运行
openspec init并验证结果。
现在与你的 AI 对话：
/opsx:explore，一个无风险的思考伙伴，它会阅读你的代码、权衡方案、在写任何代码之前帮你理清思路。（快速入门）/opsx:propose <你想要构建的内容>。这两者都在默认 profile 中。如果你想要扩展工作流（/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard），请通过 openspec-cn config profile 选择，然后运行 openspec-cn update 应用。
/opsx:propose 是规范名称；你的工具可能拼作 /opsx-propose（Cursor、GitHub Copilot）、@opsx-propose（Amazon Q）或 $openspec-propose（Codex）。openspec init 会为你选择的工具打印正确的形式 —— 见支持的工具。
[!NOTE] 不确定你的工具是否受支持？查看完整列表 —— 我们支持 30+ 种工具且持续增长。
同样支持 Homebrew、pnpm、yarn、bun 和 Nix。可查看安装选项。
完整文档见 openspec.dev/docs。
→ 快速入门：你的第一个变更，从开始到完成
→ 配置你的项目：openspec init 安装了什么
→ CLI：终端参考手册
→ 支持的工具：工具集成与安装路径
→ 自定义：profile、项目配置与 schema
→ Stores：在独立仓库中规划，团队共享（Beta）
→ 社区展示：基于 OpenSpec 构建的项目与资源
通过独立仓库分发的第三方 Schema 包 —— 它们提供了将 OpenSpec 与其他工具集成的特定工作流，类似于 github/spec-kit 的社区扩展目录 处理工具集成的方式。
→ 浏览目录，详见自定义文档。
AI 编程助手很强大，但当需求只存在于聊天记录里时，结果往往难以预测。OpenSpec 增加了一层轻量的规范（spec）机制，让你在写任何代码前先对齐要做什么。
对比 Spec Kit（GitHub）—— 很全面但偏厚重：阶段门槛严格、Markdown 很多、需要 Python 环境。OpenSpec 更轻量，也更适合自由迭代。
对比 Kiro（AWS）—— 功能强大，但会被锁定在他们的 IDE 中，并且模型选择受限（主要是 Claude）。OpenSpec 可与您已有的工具协作。
对比“什么都不用” —— 只靠聊天做 AI 编程容易产生模糊需求和不可预测的实现。OpenSpec 在不增加太多仪式感的前提下，带来更可预期的结果。
升级包版本
npm install -g @studyzy/openspec-cn@latest
若你是通过 Homebrew 安装的 OpenSpec：
brew upgrade openspec
刷新代理指令（agent instructions）
在每个项目里运行一次，用于重新生成 AI 指引，并确保最新斜杠命令可用：
openspec-cn update
模型选择：OpenSpec 更适合高推理模型。我们推荐在规划与实现阶段都使用 Codex 5.5 和 Opus 4.7。
上下文卫生：OpenSpec 受益于更干净的上下文窗口。在开始实现前清理上下文，并在整个会话中保持良好的上下文卫生。
小修小补 —— Bug 修复、错别字修正与小型改进可以直接提交 PR。
汉化问题 —— 因为汉化导致的 Bug 修复、错别字修正与小型改进建议可以直接提交 Issue。
较大改动 —— 对于新功能、重大重构或架构调整，请先提交一个 OpenSpec 变更提案，以便在实现前对齐意图与目标。
打开 PR 之前，请先开启一个 discussion（针对核心设计变更）或 issue，并在 PR 中链接该 issue 或 discussion。
撰写提案时，请牢记 OpenSpec 的理念：我们服务于各种不同的编码代理、模型与使用场景。改动应对所有人都工作良好。
欢迎 AI 生成代码 —— 只要经过测试与验证即可。包含 AI 生成代码的 PR 应注明使用的编码代理与模型（例如："Generated with Claude Code using claude-opus-4-5-20251101"）。
→ CONTRIBUTING.md：从提出第一个 issue 到 PR 合入的完整流程
pnpm installpnpm run buildpnpm testpnpm run dev 或 pnpm run dev:clitype(scope): subjectOpenSpec 会收集匿名使用统计。
我们只收集命令名与版本号，用于理解使用模式；不会收集参数、路径、内容或任何个人信息。CI 中会自动禁用。
Opt-out (any one is enough):
openspec config set telemetry.enabled false (global config; unset means on)export OPENSPEC_TELEMETRY=0 or export DO_NOT_TRACK=1 (env overrides config)核心维护者与顾问列表见 MAINTAINERS.md。
MIT
165 followers · starred Mar 2026
42 followers · starred Apr 2026
OpenSpec汉化版
See the code
[!NOTE] 本项目为中文汉化分支：openspec-cn（npm：
@studyzy/openspec-cn）。原版项目：OpenSpec 仓库：https://github.com/Fission-AI/OpenSpec npm：
@fission-ai/openspec
→ 灵活，而非僵化
→ 迭代，而非瀑布式
→ 简单，而非复杂
→ 面向存量项目（brownfield），而不只是新项目（greenfield）
→ 从个人项目到企业规模都可扩展
关注 X 上的 @0xTab 获取更新 · 加入 OpenSpec Discord 获取帮助与答疑。
你：/opsx:explore
AI： 你想探索什么？
你：我想做深色模式，但不确定怎么搞才干净。
AI： 让我看看你的样式方案...
最干净的路径：CSS 变量 + 一个小型主题上下文，
加上系统偏好检测。不需要新依赖。要划定范围吗？
你：好，开始吧。
你：/opsx:propose add-dark-mode
AI：已创建 openspec/changes/add-dark-mode/
✓ proposal.md — 为什么要做这个，什么在变
✓ specs/ — 需求和场景
✓ design.md — 技术方案
✓ tasks.md — 实现清单
准备好开始实现了！
你：/opsx:apply
AI：开始实现任务...
✓ 1.1 添加主题上下文 Provider
✓ 1.2 创建切换组件
✓ 2.1 添加 CSS 变量
✓ 2.2 接入 localStorage
所有任务已完成！
你：/opsx:archive
AI：已归档至 openspec/changes/archive/2025-01-23-add-dark-mode/
Specs 已更新。可以开始下一个功能了。
Plain Markdown — requirements with concrete scenarios, no special syntax to learn. Here's what goes in the specs/ folder created above:
## ADDED Requirements
### Requirement: Theme selection
The app SHALL let users switch between light and dark themes,
defaulting to the system preference.
#### Scenario: User toggles dark mode
- **WHEN** the user clicks the theme toggle
- **THEN** the app switches to dark mode and persists the choice
Your AI writes these; you review the plan before any code is written.
OpenSpec is built with OpenSpec — browse this repo's live specs and in-flight changes for real examples at scale.
单人开发时，OpenSpec 让你和你的 AI 在同一个仓库里保持诚实。在团队中，难点转移了：一个功能横跨 API 服务、Web 应用和一个共享库；需求由一个团队拥有，却被其他团队消费；规划在你写任何代码之前就已经开始。
Stores 就是答案 —— 把规划放到一个独立的仓库里。你熟悉的 openspec/ 形态（specs 和 changes）原样保留，通过 git push 像其他东西一样共享。整个团队和每个编码代理都能跨仓库读取的单一事实来源。
Stores 目前处于 beta 阶段。请从 Stores 指南 开始。
需要 Node.js 20.19.0 或更高版本。 Homebrew 会将其作为依赖一并安装。
全局安装 openspec-cn：
npm install -g @studyzy/openspec-cn@latest
也可以在 macOS 或 Linux 上安装官方的 Homebrew formula：
brew install openspec
然后进入你的项目目录并初始化：
cd your-project
openspec-cn init
想让你的 AI 来完成？ 把安装提示词粘贴给你的编程助手 —— 它会安装 CLI、运行
openspec init并验证结果。
现在与你的 AI 对话：
/opsx:explore，一个无风险的思考伙伴，它会阅读你的代码、权衡方案、在写任何代码之前帮你理清思路。（快速入门）/opsx:propose <你想要构建的内容>。这两者都在默认 profile 中。如果你想要扩展工作流（/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard），请通过 openspec-cn config profile 选择，然后运行 openspec-cn update 应用。
/opsx:propose 是规范名称；你的工具可能拼作 /opsx-propose（Cursor、GitHub Copilot）、@opsx-propose（Amazon Q）或 $openspec-propose（Codex）。openspec init 会为你选择的工具打印正确的形式 —— 见支持的工具。
[!NOTE] 不确定你的工具是否受支持？查看完整列表 —— 我们支持 30+ 种工具且持续增长。
同样支持 Homebrew、pnpm、yarn、bun 和 Nix。可查看安装选项。
完整文档见 openspec.dev/docs。
→ 快速入门：你的第一个变更，从开始到完成
→ 配置你的项目：openspec init 安装了什么
→ CLI：终端参考手册
→ 支持的工具：工具集成与安装路径
→ 自定义：profile、项目配置与 schema
→ Stores：在独立仓库中规划，团队共享（Beta）
→ 社区展示：基于 OpenSpec 构建的项目与资源
通过独立仓库分发的第三方 Schema 包 —— 它们提供了将 OpenSpec 与其他工具集成的特定工作流，类似于 github/spec-kit 的社区扩展目录 处理工具集成的方式。
→ 浏览目录，详见自定义文档。
AI 编程助手很强大，但当需求只存在于聊天记录里时，结果往往难以预测。OpenSpec 增加了一层轻量的规范（spec）机制，让你在写任何代码前先对齐要做什么。
对比 Spec Kit（GitHub）—— 很全面但偏厚重：阶段门槛严格、Markdown 很多、需要 Python 环境。OpenSpec 更轻量，也更适合自由迭代。
对比 Kiro（AWS）—— 功能强大，但会被锁定在他们的 IDE 中，并且模型选择受限（主要是 Claude）。OpenSpec 可与您已有的工具协作。
对比“什么都不用” —— 只靠聊天做 AI 编程容易产生模糊需求和不可预测的实现。OpenSpec 在不增加太多仪式感的前提下，带来更可预期的结果。
升级包版本
npm install -g @studyzy/openspec-cn@latest
若你是通过 Homebrew 安装的 OpenSpec：
brew upgrade openspec
刷新代理指令（agent instructions）
在每个项目里运行一次，用于重新生成 AI 指引，并确保最新斜杠命令可用：
openspec-cn update
模型选择：OpenSpec 更适合高推理模型。我们推荐在规划与实现阶段都使用 Codex 5.5 和 Opus 4.7。
上下文卫生：OpenSpec 受益于更干净的上下文窗口。在开始实现前清理上下文，并在整个会话中保持良好的上下文卫生。
小修小补 —— Bug 修复、错别字修正与小型改进可以直接提交 PR。
汉化问题 —— 因为汉化导致的 Bug 修复、错别字修正与小型改进建议可以直接提交 Issue。
较大改动 —— 对于新功能、重大重构或架构调整，请先提交一个 OpenSpec 变更提案，以便在实现前对齐意图与目标。
打开 PR 之前，请先开启一个 discussion（针对核心设计变更）或 issue，并在 PR 中链接该 issue 或 discussion。
撰写提案时，请牢记 OpenSpec 的理念：我们服务于各种不同的编码代理、模型与使用场景。改动应对所有人都工作良好。
欢迎 AI 生成代码 —— 只要经过测试与验证即可。包含 AI 生成代码的 PR 应注明使用的编码代理与模型（例如："Generated with Claude Code using claude-opus-4-5-20251101"）。
→ CONTRIBUTING.md：从提出第一个 issue 到 PR 合入的完整流程
pnpm installpnpm run buildpnpm testpnpm run dev 或 pnpm run dev:clitype(scope): subjectOpenSpec 会收集匿名使用统计。
我们只收集命令名与版本号，用于理解使用模式；不会收集参数、路径、内容或任何个人信息。CI 中会自动禁用。
Opt-out (any one is enough):
openspec config set telemetry.enabled false (global config; unset means on)export OPENSPEC_TELEMETRY=0 or export DO_NOT_TRACK=1 (env overrides config)核心维护者与顾问列表见 MAINTAINERS.md。
MIT
165 followers · starred Mar 2026
42 followers · starred Apr 2026