# onething-spec

**Repository Path**: winnerxue/onething-spec

## Basic Information

- **Project Name**: onething-spec
- **Description**: onething-speconething-speconething-spec
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenSpec

OpenSpec 是一个**规格驱动开发（SDD）框架**，在 AI 工具和代码之间加一层结构化规格，保证“先对齐目标，再写代码”，让结果可控、可审计、可追踪。

目前项目参考[OpenSpec](https://github.com/Fission-AI/OpenSpec)项目进行二开，并引入了网心自己的SSD规范落地

## 安装

需要 Node.js 20.19.0 或更高版本。

```bash
# 使用自建 npm 私库 (如果有本地npm镜像加速功能，请联系xuezhang添加)
npm config set registry http://npmrc.onethingaidev.com

# 安装 OpenSpec
npm install -g @onething-ai/openspec@latest
```

## 快速使用

```bash
# 1. 在项目根目录初始化
openspec init

# 2. 开始一个需求（在 AI 工具内）
/opsx:propose <change-name>
/opsx:apply
/opsx:archive
```


以上流程会自动生成 proposal/specs/design/tasks 工件，并在归档时把变更合并回系统规格。


## 更多
> 关于OpenSpec和SSD的学习，可以参考目前docs/onething目录下的3个理论+实操的markdown文件

[01-OpenSpec的架构设计](./docs/onething/01-openspec-architecture.md)

[02-SDD规范引入原理](./docs/onething/02-sdd-mechanism.md)

[03-SDD在OpenSpec中实操](./docs/onething/03-hands-on-guide.md)