# 6A-spec

**Repository Path**: yanghuijava/6-a-spec

## Basic Information

- **Project Name**: 6A-spec
- **Description**: 基于 spec 驱动开发的提示词工具集，支持 Cursor 和 Claude。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 6Aspec

轻量级 spec 驱动开发框架，支持 Cursor 和 Claude Code。

## 快速开始

### 交互式初始化（推荐）

```bash
npx 6aspec init
```

会显示欢迎界面，按回车后进入工具选择：

- **↑↓** 移动光标
- **Enter** 选中/取消
- **Tab** 确认

### 非交互式初始化

```bash
# 只安装 Cursor 配置
npx 6aspec init --tool cursor

# 只安装 Claude Code 配置
npx 6aspec init --tool claude

# 同时安装两种工具
npx 6aspec init --tool cursor,claude
```

### 增量初始化

重复执行 `6aspec init` 时：
- 已安装的工具显示为已选中
- 可以继续勾选未安装的工具
- 已安装工具会自动 merge 更新

### 更新配置

```bash
# 使用最新版本更新（推荐）
npx 6aspec@latest update

# 全局安装后更新
6aspec update
```

`update` 命令：
- 读取 `.6aspec/init.json` 中已选的工具列表
- 使用 **merge 模式** 更新所有配置
- 保留用户自定义文件，只更新包中提供的文件

### 全局安装（可选）

```bash
# 安装最新正式版本
npm install -g 6aspec

# 安装指定版本
npm install -g 6aspec@2.0.0
npm install -g 6aspec@2.0.1-dev.5

# 安装预发布版本
npm install -g 6aspec@beta
npm install -g 6aspec@dev

# 然后直接使用
6aspec init
6aspec update

# 升级到最新版本
npm install -g 6aspec@latest

# 降级到指定版本（直接安装旧版本号即可覆盖）
npm install -g 6aspec@2.0.0
```

## 功能特性

- ✅ 交互式工具选择（Cursor / Claude Code）
- ✅ 增量初始化（重复 init 保留已选、可补选）
- ✅ merge 模式更新（保留用户自定义文件）
- ✅ 非交互模式（支持 CI/脚本）
- ✅ 统一配置管理（`.6aspec/init.json`）

## 目录结构

安装后会在项目根目录创建：

```
.6aspec/              公共配置目录（Cursor 和 Claude Code 共用）
  ├── init.json       初始化配置（已选工具、版本等）
  ├── rules/          公共规则文件
  └── script/         公共工具脚本
.cursor/              Cursor 专用配置目录
  └── commands/       Cursor 命令提示词
.claude/              Claude Code 专用配置目录
  └── commands/       Claude 命令提示词
```

## Slash Commands

### Brownfield（棕地 - 已有项目）

| 命令 | 说明 |
|------|------|
| `/6aspec:brown:new` | 创建一个变更 |
| `/6aspec:brown:continue` | 生成下一个工件 |
| `/6aspec:brown:implement` | 实施任务 |
| `/6aspec:brown:list` | 查看变更列表 |
| `/6aspec:brown:status` | 查看变更状态 |
| `/6aspec:brown:verify` | 验证实现 |

### Greenfield（绿地 - 新项目）

| 命令 | 说明 |
|------|------|
| `/6aspec:green:new` | 创建一个模块 |
| `/6aspec:green:continue` | 生成下一个工件 |
| `/6aspec:green:implement` | 执行任务 |
| `/6aspec:green:init` | 初始化项目 |
| `/6aspec:green:status` | 查看状态 |
| `/6aspec:green:model` | 数据建模 |

## 开发

### 本地测试

```bash
node bin/6aspec --help
node bin/6aspec init --tool cursor
```

### 发布

```bash
npm run publish:dev        # 发布开发版本
npm run publish:beta       # 发布 Beta 版本
npm run publish:rc         # 发布 RC 版本
npm run publish:latest     # 发布正式版本
```

## License

MIT