vibe-spec

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

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

安装

npm install -g vibe-spec

快速开始

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/ 分类与写作规则 | | 文档检查 | 工作流 | 索引完整性、格式、时效性检查 |

开发

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

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