modify git subcommands and add new docs

Author: qdriven

AGENTS.md

@@ -7,7 +7,7 @@
 **Spark** 是一个 CLI 工具，用于管理多个 Git 仓库。它提供以下核心功能：
 
 1. **多仓库更新** - 批量更新多个 Git 仓库到最新版本
-2. **Mono-repo 管理** - 将多个仓库添加为子模块，统一管理
+2. **Submodule 管理** - 将本地仓库或远程 URL 添加为子模块
 3. **子模块同步** - 同步 Mono 仓库中的所有子模块
 4. **Git 用户配置** - 配置仓库的 Git 用户信息
 5. **任务管理** - 任务分发、同步和 GitHub 仓库创建
@@ -35,15 +35,14 @@ spark/
 │       ├── git.go         # Git 父命令
 │       ├── config.go      # Git 用户配置
 │       ├── update.go      # 仓库更新命令
-│       ├── mono.go        # mono 子命令组
-│       ├── mono_add.go    # mono add 命令
+
 │       ├── sync.go        # 子模块同步命令
 │       └── gitcode.go     # Gitcode 远程管理
 ├── internal/              # 内部业务逻辑
 │   ├── agent/             # AI Agent 管理器
 │   ├── config/            # 配置管理
 │   ├── git/               # Git 操作封装
-│   ├── mono/              # Mono-repo 操作
+
 │   ├── task/              # 任务管理器
 │   └── tui/               # 终端 UI 组件
 ├── docs/                  # 文档
@@ -92,8 +91,8 @@ Git 仓库管理命令的父命令，包含以下子命令：
 
 ```bash
 spark git update       # 更新多个仓库
-spark git mono add     # 添加现有仓库为子模块
-spark git mono sync    # 同步子模块
+spark git submodule add     # 添加现有仓库为子模块
+spark git sync    # 同步子模块
 spark git gitcode      # 添加 Gitcode 远程
 spark git config       # 配置 Git 用户
 spark git url          # 获取仓库 URL
@@ -112,32 +111,31 @@ spark git update -p ~/workspace -p ~/projects
 
 详细文档: [docs/usage/update.md](docs/usage/update.md)
 
-#### `spark git mono add`
+#### `spark git submodule`
 将本地 Git 仓库添加为子模块，或克隆远程仓库并添加为子模块。
 
 **本地模式**：
 ```bash
-spark git mono add                    # 添加当前目录下的仓库
-spark git mono add -p /path/to/repos  # 添加指定目录下的仓库
+spark git submodule add                    # 添加当前目录下的仓库
+spark git submodule add -p /path/to/repos  # 添加指定目录下的仓库
 ```
 
 **远程模式**：
 ```bash
-spark git mono add https://github.com/user/repo           # 添加远程仓库
-spark git mono add https://github.com/user/repo --name my-submodule  # 指定路径名
-spark git mono add git@github.com:user/repo.git           # 使用 SSH URL
+spark git submodule add https://github.com/user/repo           # 添加远程仓库
+spark git submodule add https://github.com/user/repo --name my-submodule  # 指定路径名
+spark git submodule add git@github.com:user/repo.git           # 使用 SSH URL
 ```
 
 | 选项 | 说明 |
 |------|------|
-| `-p, --path` | Mono-repo 目录 (默认: 当前目录) |
 | `-n, --name` | 子模块路径名称 (默认: 仓库名) |
 
-#### `spark git mono sync`
-同步 Mono 仓库中的所有子模块到最新版本。
+#### `spark git sync`
+同步当前仓库中所有子模块到最新版本。
 
 ```bash
-spark git mono sync /path/to/mono-repo
+spark git sync ./my-repo
 ```
 
 #### `spark git gitcode`

CLAUDE.md

@@ -34,9 +34,8 @@ Spark is a Go CLI tool (`module spark`, binary `spark`) for managing multiple Gi
 - **`internal/`** — Business logic, separated by domain:
   - `agent/` — AI agent config management module (currently command entry disabled)
   - `config/` — Configuration loading and management
-  - `git/` — Core Git operations (find repos, update, remote management, URL conversion)
+  - `git/` — Core Git operations (find repos, update, remote management, submodule, URL conversion)
   - `github/` — GitHub API interactions (list org repos, parse org URLs)
-  - `mono/` — Mono-repo creation and submodule management
   - `script/` — Script discovery (from config and `scripts/` dir) and execution
   - `task/` — Task init/dispatch/sync, issue CRUD, and implementation via `kimi` CLI
   - `tui/` — Shared terminal UI components (spinner, dialogs, selector)
@@ -46,8 +45,7 @@ Spark is a Go CLI tool (`module spark`, binary `spark`) for managing multiple Gi
 
 ```
 spark
-├── git [init|update|mono|gitcode|config|url|batch-clone|issues|update-org-status]
-│   └── mono [add|sync]
+├── git [init|update|submodule|sync|gitcode|config|url|batch-clone|issues|update-org-status]
 ├── task [list|init|dispatch|sync|create|delete|impl]
 ├── script [list|run]
 └── magic [flush-dns|pip|go|node]     # Mirror source switching + DNS

README.md

@@ -33,7 +33,7 @@ main.go → cmd.Execute()
 │   ├── config/             Config loading & migration
 │   ├── git/                Core git operations
 │   ├── github/             GitHub API interactions
-│   ├── mono/               Mono-repo & submodule management
+
 │   ├── script/             Script discovery & execution
 │   ├── task/               Task dispatch/sync/issue CRUD
 │   └── tui/                Shared terminal UI components
@@ -74,8 +74,8 @@ go test ./internal/git/... -v -run TestFunctionName
 | Command | Description |
 |---------|-------------|
 | `spark git update` | Update all repos to latest version |
-| `spark git mono add [-p <path>]` | Add existing repos as submodules |
-| `spark git mono sync <mono-path>` | Sync all submodules to latest |
+| `spark git submodule add [-p <path>]` | Add existing repos as submodules |
+| `spark git sync [repo]` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |
 | `spark git init [--owner <owner>] [--skip-gh]` | Initialize git repo, create GitHub remote |
 | `spark git config [--username --email]` | Configure git user for repo |

cmd/git/git.go

@@ -12,7 +12,8 @@ var GitCmd = &cobra.Command{
 This includes:
 - update: Update multiple git repositories
 - init: Initialize a git repo and create a GitHub remote
-- mono: Mono repo management (add/sync submodules)
+- submodule: Add local repos or URLs as git submodules
+- sync: Sync all submodules to the latest versions
 - gitcode: Add Gitcode as remote
 - config: Configure git user for repository
 - url: Get repository remote URL

cmd/git/init.go

@@ -21,13 +21,16 @@ var initCmd = &cobra.Command{
 	Use:   "init",
 	Short: "Initialize a git repository and create a GitHub remote",
 	Long: `Initialize the current directory as a git repository:
-1. Run 'git init'
+1. Run 'git init' (skipped if already a git repo with GitHub remote)
 2. Configure git user (name/email)
 3. Add child GitHub repos as git submodules
 4. Generate a .gitignore with common patterns
 5. Create an initial commit
 6. Create a GitHub remote repository via 'gh repo create --push'
 
+If the current directory is already a git repository with a GitHub remote,
+steps 1, 4, 5, and 6 are skipped — only submodules are added and committed.
+
 The repo name defaults to the current directory name.
 Owner defaults to the 'github-owner' config value in ~/.spark.yaml.`,
 	RunE: func(cmd *cobra.Command, args []string) error {
@@ -37,9 +40,6 @@ Owner defaults to the 'github-owner' config value in ~/.spark.yaml.`,
 		if owner == "" {
 			owner = viper.GetString("github-owner")
 		}
-		if owner == "" {
-			return fmt.Errorf("GitHub owner is required. Set --owner flag or 'github-owner' in ~/.spark.yaml")
-		}
 
 		repoName := initRepo
 		if repoName == "" {
@@ -50,15 +50,24 @@ Owner defaults to the 'github-owner' config value in ~/.spark.yaml.`,
 			}
 		}
 
-		fmt.Printf("Initializing git repository: %s/%s\n", owner, repoName)
-		fmt.Println()
+		alreadyGitRepo := git.IsGitRepository(repoPath)
+		hasGitHub, _ := git.IsGitHubRepo(repoPath)
 
-		fmt.Println("Step 1/6: Running git init...")
-		if err := git.InitRepo(repoPath); err != nil {
-			return fmt.Errorf("git init failed: %w", err)
+		if alreadyGitRepo && hasGitHub {
+			fmt.Printf("Existing GitHub repository detected: %s\n\n", repoPath)
+			fmt.Println("Step 1/3: Configuring git user...")
+		} else {
+			if owner == "" {
+				return fmt.Errorf("GitHub owner is required. Set --owner flag or 'github-owner' in ~/.spark.yaml")
+			}
+			fmt.Printf("Initializing git repository: %s/%s\n\n", owner, repoName)
+			fmt.Println("Step 1/6: Running git init...")
+			if err := git.InitRepo(repoPath); err != nil {
+				return fmt.Errorf("git init failed: %w", err)
+			}
+			fmt.Println("Step 2/6: Configuring git user...")
 		}
 
-		fmt.Println("Step 2/6: Configuring git user...")
 		username := viper.GetString("git.username")
 		email := viper.GetString("git.email")
 		if username != "" && email != "" {
@@ -72,6 +81,20 @@ Owner defaults to the 'github-owner' config value in ~/.spark.yaml.`,
 			fmt.Println("  No git user configured in ~/.spark.yaml. Skipping.")
 		}
 
+		if alreadyGitRepo && hasGitHub {
+			fmt.Println("Step 2/3: Scanning for child GitHub repos to add as submodules...")
+			if err := git.AddChildReposAsSubmodules(repoPath); err != nil {
+				fmt.Printf("Warning: %v\n", err)
+			}
+			fmt.Println("Step 3/3: Committing submodule changes...")
+			if err := git.InitialCommit(repoPath, "chore: add existing repos as submodules"); err != nil {
+				fmt.Printf("Warning: commit failed: %v\n", err)
+			}
+			fmt.Println()
+			fmt.Println("Done! Submodules added to existing repository.")
+			return nil
+		}
+
 		fmt.Println("Step 3/6: Scanning for child GitHub repos to add as submodules...")
 		if err := git.AddChildReposAsSubmodules(repoPath); err != nil {
 			fmt.Printf("Warning: %v\n", err)