update docs

Author: qdriven

AGENTS.md

@@ -7,7 +7,7 @@
 **Spark** 是一个 CLI 工具，用于管理多个 Git 仓库。它提供以下核心功能：
 
 1. **多仓库更新** - 批量更新多个 Git 仓库到最新版本
-2. **Mono-repo 创建** - 将多个仓库整合为一个带有子模块的 Mono 仓库
+2. **Mono-repo 管理** - 将多个仓库添加为子模块，统一管理
 3. **子模块同步** - 同步 Mono 仓库中的所有子模块
 4. **Git 用户配置** - 配置仓库的 Git 用户信息
 5. **任务管理** - 任务分发、同步和 GitHub 仓库创建
@@ -35,7 +35,8 @@ spark/
 │       ├── git.go         # Git 父命令
 │       ├── config.go      # Git 用户配置
 │       ├── update.go      # 仓库更新命令
-│       ├── create.go      # mono-repo 创建命令
+│       ├── mono.go        # mono 子命令组
+│       ├── mono_add.go    # mono add 命令
 │       ├── sync.go        # 子模块同步命令
 │       └── gitcode.go     # Gitcode 远程管理
 ├── internal/              # 内部业务逻辑
@@ -90,12 +91,12 @@ spark/
 Git 仓库管理命令的父命令，包含以下子命令：
 
 ```bash
-spark git update     # 更新多个仓库
-spark git create     # 创建 Mono 仓库
-spark git sync       # 同步子模块
-spark git gitcode    # 添加 Gitcode 远程
-spark git config     # 配置 Git 用户
-spark git url        # 获取仓库 URL
+spark git update       # 更新多个仓库
+spark git mono add     # 添加现有仓库为子模块
+spark git mono sync    # 同步子模块
+spark git gitcode      # 添加 Gitcode 远程
+spark git config       # 配置 Git 用户
+spark git url          # 获取仓库 URL
 spark git batch-clone  # 克隆用户/组织所有仓库
 ```
 
@@ -109,29 +110,25 @@ spark git update -p ~/workspace -p ~/projects
 
 详细文档: [docs/usage/update.md](docs/usage/update.md)
 
-#### `spark git create`
-创建一个 Mono 仓库，将所有找到的仓库作为子模块添加。
+#### `spark git mono add`
+将当前目录下的 Git 仓库添加为子模块，无需重新克隆。
 
 ```bash
-spark git create -p /path/to/repos -n my-mono-repo -o ./output
+spark git mono add                    # 添加当前目录下的仓库
+spark git mono add -p /path/to/repos  # 添加指定目录下的仓库
 ```
 
 | 选项 | 说明 |
 |------|------|
-| `-n, --name` | Mono 仓库名称 (默认: `mono-repo`) |
-| `-o, --output` | 输出路径 (默认: 当前目录) |
+| `-p, --path` | 包含 Git 仓库的目录 (默认: 当前目录) |
 
-详细文档: [docs/usage/create.md](docs/usage/create.md)
-
-#### `spark git sync`
+#### `spark git mono sync`
 同步 Mono 仓库中的所有子模块到最新版本。
 
 ```bash
-spark git sync /path/to/mono-repo
+spark git mono sync /path/to/mono-repo
 ```
 
-详细文档: [docs/usage/sync.md](docs/usage/sync.md)
-
 #### `spark git gitcode`
 为 GitHub 仓库添加 Gitcode 作为远程地址。
 

README.md

@@ -74,8 +74,8 @@ go test ./internal/git/... -v -run TestFunctionName
 | Command | Description |
 |---------|-------------|
 | `spark git update` | Update all repos to latest version |
-| `spark git create -n <name> -o <path>` | Create mono-repo with submodules |
-| `spark git sync <mono-path>` | Sync all submodules to latest |
+| `spark git mono add [-p <path>]` | Add existing repos as submodules |
+| `spark git mono sync <mono-path>` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |
 | `spark git config [--username --email]` | Configure git user for repo |
 | `spark git url [repo-path]` | Get remote URL of repository |

docs/Agents.md

@@ -7,7 +7,7 @@
 **Spark** 是一个 CLI 工具，用于管理多个 Git 仓库。它提供以下核心功能：
 
 1. **多仓库更新** - 批量更新多个 Git 仓库到最新版本
-2. **Mono-repo 创建** - 将多个仓库整合为一个带有子模块的 Mono 仓库
+2. **Mono-repo 管理** - 将多个仓库添加为子模块，统一管理
 3. **子模块同步** - 同步 Mono 仓库中的所有子模块
 4. **Git 用户配置** - 配置仓库的 Git 用户信息
 5. **AI Agent 配置管理** - 管理多种 AI Agent（Claude Code、Codex、Kimi、GLM）的配置文件
@@ -35,7 +35,8 @@ spark/
 │       ├── git.go         # Git 父命令
 │       ├── config.go      # Git 用户配置
 │       ├── update.go      # 仓库更新命令
-│       ├── create.go      # mono-repo 创建命令
+│       ├── mono.go        # mono 子命令组
+│       ├── mono_add.go    # mono add 命令
 │       ├── sync.go        # 子模块同步命令
 │       └── gitcode.go     # Gitcode 远程管理
 ├── internal/              # 内部业务逻辑
@@ -90,12 +91,12 @@ spark/
 Git 仓库管理命令的父命令，包含以下子命令：
 
 ```bash
-spark git update     # 更新多个仓库
-spark git create     # 创建 Mono 仓库
-spark git sync       # 同步子模块
-spark git gitcode    # 添加 Gitcode 远程
-spark git config     # 配置 Git 用户
-spark git url        # 获取仓库 URL
+spark git update       # 更新多个仓库
+spark git mono add     # 添加现有仓库为子模块
+spark git mono sync    # 同步子模块
+spark git gitcode      # 添加 Gitcode 远程
+spark git config       # 配置 Git 用户
+spark git url          # 获取仓库 URL
 spark git batch-clone  # 克隆用户/组织所有仓库
 ```
 
@@ -109,29 +110,25 @@ spark git update -p ~/workspace -p ~/projects
 
 详细文档: [docs/usage/update.md](docs/usage/update.md)
 
-#### `spark git create`
-创建一个 Mono 仓库，将所有找到的仓库作为子模块添加。
+#### `spark git mono add`
+将当前目录下的 Git 仓库添加为子模块，无需重新克隆。
 
 ```bash
-spark git create -p /path/to/repos -n my-mono-repo -o ./output
+spark git mono add                    # 添加当前目录下的仓库
+spark git mono add -p /path/to/repos  # 添加指定目录下的仓库
 ```
 
 | 选项 | 说明 |
 |------|------|
-| `-n, --name` | Mono 仓库名称 (默认: `mono-repo`) |
-| `-o, --output` | 输出路径 (默认: 当前目录) |
+| `-p, --path` | 包含 Git 仓库的目录 (默认: 当前目录) |
 
-详细文档: [docs/usage/create.md](docs/usage/create.md)
-
-#### `spark git sync`
+#### `spark git mono sync`
 同步 Mono 仓库中的所有子模块到最新版本。
 
 ```bash
-spark git sync /path/to/mono-repo
+spark git mono sync /path/to/mono-repo
 ```
 
-详细文档: [docs/usage/sync.md](docs/usage/sync.md)
-
 #### `spark git gitcode`
 为 GitHub 仓库添加 Gitcode 作为远程地址。
 

docs/README.md

@@ -74,8 +74,8 @@ go test ./internal/git/... -v -run TestFunctionName
 | Command | Description |
 |---------|-------------|
 | `spark git update` | Update all repos to latest version |
-| `spark git create -n <name> -o <path>` | Create mono-repo with submodules |
-| `spark git sync <mono-path>` | Sync all submodules to latest |
+| `spark git mono add [-p <path>]` | Add existing repos as submodules |
+| `spark git mono sync <mono-path>` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |
 | `spark git config [--username --email]` | Configure git user for repo |
 | `spark git url [repo-path]` | Get remote URL of repository |

docs/features/git.md

@@ -19,11 +19,11 @@ spark git update -p ~/workspace
 将多个独立仓库作为 Submodule 合并为一个 Mono-repo，方便统一管理和版本控制。
 
 ```bash
-# 创建 Mono-repo
-spark git create -n my-mono -o ./output
+# 添加现有仓库为子模块
+spark git mono add -p /path/to/repos
 
 # 同步所有 Submodule 到最新
-spark git sync ./my-mono
+spark git mono sync ./my-mono
 ```
 
 ### Gitcode 远程集成
@@ -54,7 +54,7 @@ spark git update-org-status variableway --update-dot-github
 | 参数 | 说明 |
 |------|------|
 | `-p, --path` | 指定扫描目录（支持多个），默认 `["."]` |
-| `-n, --name` | Mono-repo 名称，默认 `mono-repo` |
+| `-p, --path` | 包含 Git 仓库的目录，默认 `.` |
 | `-o, --output` | 输出路径 |
 | `--ssh` | 使用 SSH 克隆（batch-clone） |
 | `--include` / `--exclude` | 包含/排除匹配模式（batch-clone） |

docs/index.md

@@ -79,8 +79,8 @@ go test ./internal/git/... -v -run TestFunctionName
 | Command | Description |
 |---------|-------------|
 | `spark git update` | Update all repos to latest version |
-| `spark git create -n <name> -o <path>` | Create mono-repo with submodules |
-| `spark git sync <mono-path>` | Sync all submodules to latest |
+| `spark git mono add [-p <path>]` | Add existing repos as submodules |
+| `spark git mono sync <mono-path>` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |
 | `spark git config [--username --email]` | Configure git user for repo |
 | `spark git url [repo-path]` | Get remote URL of repository |

docs/quick-start/getting-started.md

@@ -29,7 +29,7 @@ github_owner: your-username
 
 ```bash
 spark git update -p ~/workspace               # 更新所有仓库
-spark git create -n my-mono -o ./output       # 创建 Mono-repo
+spark git mono add -p /path/to/repos          # 添加仓库为子模块
 spark git batch-clone variableway -o ./repos  # 克隆组织仓库
 ```
 

docs/spec/git.md

@@ -28,30 +28,28 @@ spark git update [-p <path>]
 
 ---
 
-## spark git create
+## spark git mono add
 
-创建 Mono-repo，将指定目录下的所有仓库作为 Git Submodule 添加。
+将目录下已有的 Git 仓库添加为子模块，无需重新克隆。
 
 ```
-spark git create -n <name> -o <path> [-p <path>]
+spark git mono add [-p <path>]
 ```
 
 | 标志 | 类型 | 默认值 | 必填 | 说明 |
 |------|------|--------|------|------|
-| `-n, --name` | string | `mono-repo` | 否 | Mono-repo 目录名 |
-| `-o, --output` | string | 同源路径 | 否 | 输出路径 |
-| `-p, --path` | stringSlice | `["."]` | 否 | 包含 Git 仓库的目录路径 |
+| `-p, --path` | string | `.` | 否 | 包含 Git 仓库的目录路径 |
 
 无参数。
 
 ---
 
-## spark git sync
+## spark git mono sync
 
 同步 Mono-repo 中所有 Submodule 到最新版本。
 
 ```
-spark git sync <mono-repo-path>
+spark git mono sync <mono-repo-path>
 ```
 
 | 参数 | 类型 | 必填 | 说明 |

docs/usage/git.md

@@ -6,8 +6,8 @@
 
 ```bash
 spark git update                              # 更新所有仓库
-spark git create -n <name> -o <path>          # 创建 Mono-repo
-spark git sync <mono-path>                    # 同步子模块
+spark git mono add [-p <path>]                # 添加现有仓库为子模块
+spark git mono sync <mono-path>               # 同步子模块
 spark git gitcode                             # 添加 Gitcode 远程
 spark git config [--username --email]         # 配置 Git 用户
 spark git url [repo-path]                     # 查看远程 URL
@@ -31,29 +31,27 @@ spark git update -p ~/ws -p ~/projects        # 多个目录
 
 ---
 
-## spark git create
+## spark git mono add
 
-将多个仓库整合为一个带有子模块的 Mono 仓库。
+将当前目录下已有的 Git 仓库添加为子模块，无需重新克隆。适用于研究场景：先将多个仓库克隆到同一目录，再统一转为 Mono 仓库。
 
 | 标志 | 简写 | 默认值 | 说明 |
 |------|------|--------|------|
-| `--name` | `-n` | `mono-repo` | Mono 仓库名称 |
-| `--output` | `-o` | 源路径 | 输出路径 |
+| `--path` | `-p` | `.` | 包含 Git 仓库的目录 |
 
 ```bash
-spark git create                              # 默认创建 mono-repo
-spark git create -n my-mono -o ./output       # 指定名称和输出路径
-spark git create -p ~/workspace -n projects   # 从指定目录创建
+spark git mono add                              # 添加当前目录下的仓库
+spark git mono add -p /path/to/repos            # 添加指定目录下的仓库
 ```
 
 ---
 
-## spark git sync
+## spark git mono sync
 
 同步 Mono 仓库中所有子模块到最新版本。
 
 ```bash
-spark git sync ./my-mono-repo                 # 同步指定 Mono 仓库
+spark git mono sync ./my-mono-repo                 # 同步指定 Mono 仓库
 ```
 
 ---