open-index/open-npm huggingface dataset:
npm package: @gamehoo/vibe-spec
Description: 跨项目通用 AI 编程规范管理工具
Latest version: 1.1.0

# vibe-spec

跨项目通用 AI 编程规范管理工具。

把提交规范、文档规范、工作流程集中维护在一个地方，一条命令同步到所有项目。

## 安装

```bash
npm install -g vibe-spec
```

## 快速开始

```bash
cd your-project
vibe-spec init
```

默认全选所有规范，直接回车即可。项目中会生成：

- `.docs/规范/` — 规范文件
- `.vibespecrc.json` — 项目配置
- `CLAUDE.md` 中插入规范引用区域

## 命令

### `vibe-spec init`

在当前项目初始化，交互式选择要使用的规范和工作流。

### `vibe-spec sync`

将当前项目的规范同步到最新版本。

### `vibe-spec sync --all`

一次性同步所有已注册的项目。适合修改规范后批量推送。

### `vibe-spec list`

查看可用的规范、工作流和已注册的项目列表。

## 内置规范

| 名称 | 类型 | 说明 |
|------|------|------|
| 提交规范 | 规范 | 基于 Conventional Commits，类型英文 + 描述中文 |
| 文档规范 | 规范 | CLAUDE.md / .docs/ 分类与写作规则 |
| 文档检查 | 工作流 | 索引完整性、格式、时效性检查 |

## 开发

```bash
git clone <repo>
cd vibe-spec
npm install
npm link          # 全局 vibe-spec 指向本地仓库
```

`npm link` 后修改 `specs/` 下的文件立刻生效，`vibe-spec sync --all` 直接读取本地文件。