# @exodus/openspec 中文文档

规范地址：https://npmcn.com/package/%40exodus/openspec/

版本：1\.3\.0
npm 元数据更新时间：2026-10-06T21:01:48.600Z
中文译文更新时间：2026-11-14T05:01:39.978Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40exodus/openspec
原文对照：https://npmcn.com/package/%40exodus/openspec/?lang=original
项目主页：https://github.com/Fission-AI/OpenSpec
源码仓库：https://github.com/Fission-AI/OpenSpec

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：927 kB，280 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19\.0
- 运行依赖：9 个
- 首次发布：2026-03-31T20:19:37.920Z
- 最新版本发布：2026-04-10T01:45:14.966Z
- 近 30 天下载量：2321（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

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

## 安装

```sh
npm install @exodus/openspec
```

也可以使用：`pnpm add @exodus/openspec`、`yarn add @exodus/openspec`、`bun add @exodus/openspec`

## README

[![OpenSpec logo](https://npmcn.com/package/%40exodus/openspec/assets/openspec_bg.png)](https://github.com/Fission-AI/OpenSpec)

[![CI](https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml/badge.svg)](https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@fission-ai/openspec?style=flat-square)](https://www.npmjs.com/package/@fission-ai/openspec) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://npmcn.com/package/%40exodus/openspec/LICENSE) [![Discord](https://img.shields.io/discord/1411657095639601154?style=flat-square&logo=discord&logoColor=white&label=Discord&suffix=%20online)](https://discord.gg/YctCnvvshC)

**最受爱戴的光谱框架.**

[![Stars](https://img.shields.io/github/stars/Fission-AI/OpenSpec?style=flat-square&label=Stars)](https://github.com/Fission-AI/OpenSpec/stargazers) [![Downloads](https://img.shields.io/npm/dm/@fission-ai/openspec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@fission-ai/openspec) [![Contributors](https://img.shields.io/github/contributors/Fission-AI/OpenSpec?style=flat-square&label=Contributors)](https://github.com/Fission-AI/OpenSpec/graphs/contributors)  

我们的哲学:

```text
→ 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"` 要开始。 → [在这里多学点](https://npmcn.com/package/%40exodus/openspec/docs/opsx.md)

跟随 [@ 0xTab 在 X 上显示](https://x.com/0xTab) \* 加入时 [OpenSpec 磁盘](https://discord.gg/YctCnvvshC) 帮助和提问.

### 团队

在团队中使用 OpenSpec ? [邮件](mailto:teams@openspec.dev) 进入我们的Slack频道.

## 在行动中看到它

```text
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](https://npmcn.com/package/%40exodus/openspec/assets/openspec_dashboard.png)

## 快速启动

**需要20.19.0或更高节点.**

全局安装 OpenSpec :

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

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

```bash
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`。 。 。 .

> \[注\] 不确定您的工具是否被支持 ? [查看完整列表](https://npmcn.com/package/%40exodus/openspec/docs/supported-tools.md) -我们支持20+工具并不断增长.
> 
> 还有活活活活活活活活活活活活活活. [参见安装选项](https://npmcn.com/package/%40exodus/openspec/docs/installation.md)。 。 。 .

## 文档

→ **[开始](https://npmcn.com/package/%40exodus/openspec/docs/getting-started.md)**: 第一步  
→ **[工作流量](https://npmcn.com/package/%40exodus/openspec/docs/workflows.md)**: 组合和图案  
→ **[图标](https://npmcn.com/package/%40exodus/openspec/docs/commands.md)**: 斜线命令和技能( t)  
→ **[国 际](https://npmcn.com/package/%40exodus/openspec/docs/cli.md)**: 终端参考  
→ **[支持的工具](https://npmcn.com/package/%40exodus/openspec/docs/supported-tools.md)**: 工具集成并安装路径  
→ **[概念](https://npmcn.com/package/%40exodus/openspec/docs/concepts.md)**: 如何适应  
→ **[多语言](https://npmcn.com/package/%40exodus/openspec/docs/multi-language.md)**: 多语种支助  
→ **[自定义](https://npmcn.com/package/%40exodus/openspec/docs/customization.md)**: 把它变成你的

## 为什么是 OpenSpec ?

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

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

### 我们如何比较

**文选. [斯凯特](https://github.com/github/spec-kit)** (GitHub)——光泽但重量级. 硬相相门,多为马克倒,平通所设置. OpenSpec 轻而易举,并允许您自由脚步 .

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

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

## 更新 OpenSpec

**升级软件包**

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

**刷新代理指令**

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

```bash
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`

**维护者和咨询者**

见 [安保人员](https://npmcn.com/package/%40exodus/openspec/MAINTAINERS.md) 帮助指导项目的核心维护者和顾问名单.

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。