# create — 创建模板

基于模板创建新的 Extension 项目。支持本地模板和远程 Git 仓库模板。

## 基本用法

```bash
# 创建命令型 Extension
spaceflow create command my-cmd

# 创建技能型 Extension
spaceflow create skills my-skill

# 查看可用模板
spaceflow create --list

# 指定输出目录
spaceflow create command my-cmd -d ./plugins/my-cmd

# 使用远程模板仓库
spaceflow create --from https://github.com/user/templates command my-cmd

# 使用远程模板仓库的指定分支/标签
spaceflow create --from git@github.com:org/tpl.git --ref v1.0 api my-api
```

## 模板类型

模板动态读取自项目的 `templates/` 目录。内置模板包括：

| 模板 | 说明 |
|------|------|
| `command` | 命令型 Extension，提供 CLI 命令 |
| `skills` | 技能型 Extension，提供编辑器 AI 技能文件 |

## 远程模板

使用 `--from` 指定远程 Git 仓库作为模板来源：

```bash
# GitHub 仓库
spaceflow create --from https://github.com/user/templates command my-cmd

# Gitea 仓库
spaceflow create --from https://git.example.com/org/templates command my-cmd

# SSH + 指定 ref
spaceflow create --from git@github.com:org/tpl.git --ref v1.0 api my-api
```

远程模板会被下载到本地缓存，后续使用时优先使用缓存。

## 生成的文件结构

以 `command` 模板为例：

```text
my-cmd/
├── src/
│   ├── my-cmd.command.ts      # 命令定义
│   ├── my-cmd.service.ts      # 业务逻辑
│   ├── my-cmd.module.ts       # NestJS 模块
│   └── index.ts               # Extension 入口
├── package.json
├── tsconfig.json
└── README.md
```

## 命令行选项

| 选项 | 简写 | 说明 |
|------|------|------|
| `--directory <dir>` | `-d` | 指定输出目录 |
| `--list` | `-l` | 列出可用模板 |
| `--from <repo>` | `-f` | 远程模板仓库 URL |
| `--ref <ref>` | `-r` | 远程仓库的分支/标签/commit |
| `--verbose` | `-v` | 详细日志 |

## 示例

```bash
# 查看所有可用模板
spaceflow create --list

# 查看远程仓库的可用模板
spaceflow create --from https://github.com/org/templates --list

# 创建并指定目录
spaceflow create command my-review -d ./commands/my-review
```