update latest codes

Author: qdriven

docs/Agents.md

@@ -141,6 +141,22 @@ spark git gitcode -p ~/workspace --url https://custom.gitcode.url
 
 详细文档: [docs/usage/gitcode.md](docs/usage/gitcode.md)
 
+#### `spark git init`
+初始化当前目录为 Git 仓库并创建 GitHub 远程仓库。
+
+```bash
+spark git init --owner variableway              # 初始化并创建远程仓库
+spark git init --owner variableway --private    # 创建私有仓库
+spark git init --skip-gh --owner variableway    # 仅本地初始化，跳过 GitHub
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--owner` | GitHub 所有者 (默认: 从配置文件读取) |
+| `-r, --repo` | 仓库名称 (默认: 当前目录名) |
+| `--private` | 创建私有仓库 |
+| `--skip-gh` | 跳过创建 GitHub 远程仓库 |
+
 #### `spark git config`
 配置当前仓库的 Git 用户信息。
 

docs/features/git.md

@@ -38,6 +38,16 @@ spark git mono sync ./my-mono
 spark git gitcode -p ~/workspace
 ```
 
+### 仓库初始化
+
+一键初始化 Git 仓库并创建 GitHub 远程：`git init` → 配置用户 → 扫描子目录添加 submodule → 生成 `.gitignore` → 初始提交 → `gh repo create --push`。
+
+```bash
+spark git init --owner variableway              # 初始化并创建远程仓库
+spark git init --owner variableway --private    # 创建私有仓库
+spark git init --skip-gh --owner variableway    # 仅本地初始化
+```
+
 ### 批量克隆
 
 克隆 GitHub 组织或用户下所有仓库，或更新 README 中的仓库状态列表。
@@ -80,6 +90,9 @@ spark git issues -f tasks/issues/task-bug-fix.md --dry-run
 | `-n, --name` | 子模块路径名称（远程模式），默认仓库名 |
 | `-o, --output` | 输出路径 |
 | `--ssh` | 使用 SSH 克隆（batch-clone） |
+| `--owner` | GitHub 所有者（init），默认从配置文件读取 |
+| `--private` | 创建私有仓库（init） |
+| `--skip-gh` | 跳过 GitHub 远程创建（init） |
 | `--include` / `--exclude` | 包含/排除匹配模式（batch-clone） |
 | `-r, --repo` | 目标仓库（未指定时自动从当前仓库解析） |
 | `-d, --dir` | 文档目录（目录模式） |

docs/quick-start/getting-started.md

@@ -29,6 +29,7 @@ github_owner: your-username
 
 ```bash
 spark git update -p ~/workspace               # 更新所有仓库
+spark git init --owner variableway            # 初始化仓库并创建 GitHub 远程
 spark git mono add -p /path/to/repos          # 添加仓库为子模块
 spark git batch-clone variableway -o ./repos  # 克隆组织仓库
 ```

docs/spec/git.md

@@ -28,6 +28,27 @@ spark git update [-p <path>]
 
 ---
 
+## spark git init
+
+初始化当前目录为 Git 仓库并创建 GitHub 远程。
+
+```
+spark git init [--owner <owner>] [--repo <name>] [--private] [--skip-gh]
+```
+
+| 标志 | 类型 | 默认值 | 必填 | 说明 |
+|------|------|--------|------|------|
+| `--owner` | string | 配置文件 `github-owner` | 是* | GitHub 所有者 |
+| `-r, --repo` | string | 当前目录名 | 否 | 仓库名称 |
+| `--private` | bool | `false` | 否 | 创建私有仓库 |
+| `--skip-gh` | bool | `false` | 否 | 跳过 `gh repo create` |
+
+\* `--owner` 可从 `~/.spark.yaml` 中的 `github-owner` 配置读取。
+
+**流程**: `git init` → `git config` → submodule 扫描 → `.gitignore` → `git commit` → `gh repo create --push`
+
+---
+
 ## spark git mono add
 
 添加 Git 仓库为子模块。支持两种模式：

docs/usage/git.md

@@ -137,8 +137,9 @@ spark git url /path/to/repo                   # 指定仓库
 1. `git init` — 初始化本地仓库
 2. `git config user.name/email` — 从 `~/.spark.yaml` 读取并配置
 3. 扫描子目录中的 GitHub 仓库，自动添加为 `git submodule`
-4. `gh repo create` — 创建 GitHub 远程仓库并推送
-5. 生成 `.gitignore` — 包含常见忽略规则
+4. 生成 `.gitignore` — 包含常见忽略规则
+5. `git commit` — 创建初始提交（`gh repo create --push` 需要）
+6. `gh repo create` — 创建 GitHub 远程仓库并推送
 
 ```bash
 spark git init --owner variableway              # 初始化并创建远程仓库