# 操作命令索引

> 标准化操作命令，支持命令格式和自然语言两种触发方式。

## 命令格式

```
@<category>/<command> [--options] [<arguments>]
```

## 命令分类

| 分类 | 前缀 | 用途 |
|------|------|------|
| `check` | `@check/` | 检查与验证 |
| `project` | `@project/` | 项目管理 |
| `sync` | `@sync/` | 同步操作 |
| `gen` | `@gen/` | 生成文档 |
| `task` | `@task/` | 任务管理 |
| `dev` | `@dev/` | 开发辅助 |

## 常用命令速查

| 命令 | 说明 | 自然语言触发 |
|------|------|--------------|
| `@check/spec <project>` | 规范检查 | "检查 xxx 是否符合规范" |
| `@project/create --name <name>` | 创建项目 | "创建新项目 xxx" |
| `@task/list --project <project>` | 任务列表 | "列出 xxx 的任务" |
| `@gen/context <project>` | 生成上下文 | "生成 xxx 的上下文" |

## 命令详情

### @check/ - 检查类

| 命令 | 文件 | 说明 |
|------|------|------|
| `@check/spec` | [check/spec.md](check/spec.md) | 检查项目是否符合元规范 |

### @project/ - 项目类

| 命令 | 文件 | 说明 |
|------|------|------|
| `@project/create` | [project/create.md](project/create.md) | 创建新项目 |

### @task/ - 任务类

| 命令 | 文件 | 说明 |
|------|------|------|
| `@task/list` | [task/list.md](task/list.md) | 列出项目任务 |

### @gen/ - 生成类

| 命令 | 文件 | 说明 |
|------|------|------|
| `@gen/context` | [gen/context.md](gen/context.md) | 生成项目上下文文档 |

## 使用示例

```bash
# 命令格式
@check/spec tg-live-game
@project/create --name my-api --type single --stack hono
@task/list --project tg-live-game-hono

# 自然语言（等效）
检查 tg-live-game 是否符合规范
创建新项目 my-api，使用 Hono
列出 tg-live-game-hono 的任务
```

## 扩展命令

如需添加新命令：

1. 在对应分类目录下创建 `<command>.md`
2. 使用标准 frontmatter 格式定义元数据
3. 更新此索引文件