clawt 2.9.1 → 2.10.1

package/.claude/agent-memory/docs-sync-updater/MEMORY.md

@@ -4,13 +4,14 @@
 
 ### docs/spec.md
 - 完整的软件规格说明，包含 7 大章节
-- 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.13）
+- 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.14）
 - run 命令对应 `5.2 批量创建 Worktree + 执行 Claude Code 任务`，流程按步骤编号描述
 - merge 命令对应 `5.6 合并验证过的分支`，-b 可选，支持模糊匹配（与 resume/validate 共享匹配逻辑），流程按步骤编号描述
 - config 命令对应 `5.10 查看和管理全局配置`，包含查看配置和 config reset 子命令两部分（使用 `####` 子标题区分）
 - resume 命令对应 `5.11 在已有 Worktree 中恢复会话`，支持模糊匹配和交互式分支选择（-b 可选）
 - validate 命令对应 `5.4 在主 Worktree 验证其他分支`，-b 可选，支持模糊匹配（与 resume 共享匹配逻辑）
 - sync 命令对应 `5.12 将主分支代码同步到目标 Worktree`，-b 可选，支持模糊匹配（与 resume/validate/merge 共享匹配逻辑）
+- status 命令对应 `5.14 项目全局状态总览`，支持 `--json` 格式输出，展示主 worktree 状态、各 worktree 详细状态、未清理快照
 - 配置项说明在 `5.7 默认配置文件` 章节的表格中
 - 更新模式：新增步骤时追加编号，配置项影响范围变化时更新说明列
 
@@ -30,13 +31,13 @@
 - merge 成功消息根据 `autoPullPush` 配置动态显示推送状态
 - run 的中断清理在所有子进程退出后执行
 - run 交互式模式在创建 worktree 前检测分支是否已存在，已存在则提示使用 resume
-- remove 命令删除 worktree 时自动清理对应快照，`--all` 模式额外清理项目快照目录
+- remove 命令通过 `resolveTargetWorktrees` 支持模糊匹配+多选（-b 可选），删除 worktree 时自动清理对应快照，`--all` 模式额外清理项目快照目录
 - remove 批量操作时收集错误继续处理，最后汇总报告
 - 文档中文风格，技术术语保留英文（worktree, merge, branch, SIGINT 等）
 - cleanupWorktrees 是 merge 和 run 共用的公共清理函数（在 src/utils/worktree.ts）
 - `launchInteractiveClaude` 是 run（交互式模式）和 resume 共用的公共函数（在 src/utils/claude.ts）
 - killAllChildProcesses 是 run 专用的子进程终止函数（在 src/utils/shell.ts）
-- validate 快照管理函数在 `src/utils/validate-snapshot.ts`，被 validate、merge 和 remove 三个命令使用
+- validate 快照管理函数在 `src/utils/validate-snapshot.ts`，被 validate、merge、remove 和 status 四个命令使用
 - `confirmDestructiveAction` 在 `src/utils/formatter.ts`，被 reset、validate --clean 和 config reset 使用
 - sanitizeBranchName 清理后为空串时抛出 BRANCH_NAME_EMPTY 错误
 
@@ -61,19 +62,22 @@ run 命令有两种模式（自 claudeCodeCommand 特性后）：
 - 不传 `--tasks`：交互式界面模式（单 worktree + `launchInteractiveClaude` + spawnSync）
 - 传 `--tasks`：并行任务模式（多 worktree + `executeClaudeTask` + spawnProcess）
 
-## 命令清单（10 个）
+## 命令清单（11 个）
 
-`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`、`sync`、`reset`
+`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`、`sync`、`reset`、`status`
 
 Notes:
 - resume 和 run（交互式模式）共用 `launchInteractiveClaude()`，该函数从 run.ts 提取到 src/utils/claude.ts
 - `claudeCodeCommand` 配置项同时影响 run 交互式模式和 resume 命令
 - reset 命令与 validate --clean 的区别：reset 不删除快照文件，validate --clean 会删除快照
-- `resolveTargetWorktree()` 是 resume、validate、merge 和 sync 共用的分支匹配函数（在 src/utils/worktree-matcher.ts）
-- `WorktreeResolveMessages` 接口实现命令间消息解耦，每个命令传入各自的提示文案
-- resume 的消息常量在 `MESSAGES.RESUME_*`，validate 的消息常量在 `MESSAGES.VALIDATE_*`，merge 的消息常量在 `MESSAGES.MERGE_*`，sync 的消息常量在 `MESSAGES.SYNC_*`
-- resume、validate、merge 和 sync 的 `-b` 参数均为可选，匹配策略一致：精确→模糊（子串，大小写不敏感）→交互选择
-- validate 的交互式选择和 resume 使用同一个 `promptSelectBranch()`（Enquirer.Select）
+- `resolveTargetWorktree()` 是 resume、validate、merge 和 sync 共用的单选分支匹配函数（在 src/utils/worktree-matcher.ts）
+- `resolveTargetWorktrees()` 是多选分支匹配函数（在 src/utils/worktree-matcher.ts），目前被 remove 命令使用
+- `WorktreeResolveMessages` 接口用于单选命令的消息解耦，`WorktreeMultiResolveMessages` 接口用于多选命令的消息解耦
+- `promptSelectBranch()`（Enquirer.Select）用于单选交互，`promptMultiSelectBranches()`（Enquirer.MultiSelect）用于多选交互
+- resume 的消息常量在 `MESSAGES.RESUME_*`，validate 的消息常量在 `MESSAGES.VALIDATE_*`，merge 的消息常量在 `MESSAGES.MERGE_*`，sync 的消息常量在 `MESSAGES.SYNC_*`，status 的消息常量在 `MESSAGES.STATUS_*`，remove 的 fuzzy search 消息在 `MESSAGES.REMOVE_*`
+- resume、validate、merge 和 sync 的 `-b` 参数均为可选，匹配策略一致：精确→模糊（子串，大小写不敏感）→交互单选
+- remove 的 `-b` 参数可选，匹配策略：精确→模糊→交互多选；不传 `-b` 时列出所有分支供多选
+- validate 的交互式选择和 resume 使用同一个 `promptSelectBranch()`（Enquirer.Select）；remove 使用 `promptMultiSelectBranches()`（Enquirer.MultiSelect）
 
 ## validate 快照机制
 

package/.claude/agents/docs-sync-updater.md

@@ -65,6 +65,17 @@ memory: project
 4. **中文优先**：新增的文档内容使用中文，除非原文档使用英文且保持一致性更好。
 5. **代码示例同步**：如果文档中有代码示例受到变更影响，必须同步更新。
 
+## README.md 编写规则
+
+README.md 的定位是**面向新用户的快速上手指南**，必须严格遵守以下规则：
+
+1. **只写"怎么用"，不写"怎么实现"**：不涉及内部原理、实现细节、技术架构等内容。用户只需要知道命令怎么敲、参数怎么传。
+2. **保持简洁**：每个命令只展示最常用的用法和必要参数，避免罗列所有边界情况和细节行为（如分支匹配策略的内部逻辑、增量模式的 git 底层实现、squash 流程等）。
+3. **结构固定**：README.md 应保持以下结构顺序：安装 → 快速开始 → 命令一览 → 配置 → 全局选项 → 日志。不要添加"开发"、"测试"、"技术栈"等面向开发者的章节。
+4. **不包含开发相关内容**：测试命令、构建流程、技术选型、目录结构等开发者信息放在 `docs/spec.md` 中，不放在 README.md。
+5. **命令说明精简**：每个命令给出简短描述 + 核心用法示例即可，参数表只在确实需要时才添加，且只列必要参数。
+6. **详细的技术规格、设计原理、边界情况处理等内容应更新到 `docs/spec.md`**，而非 README.md。
+
 ## 质量检查
 
 在完成更新前，自我检查：

package/README.md

@@ -1,6 +1,6 @@
 # Clawt
 
-基于本地 Git 项目创建多个隔离的 worktree 环境，并行执行多个 Claude Code Agent 任务，所有 Agent 的代码修改互不干扰。
+基于 Git Worktree 并行执行多个 Claude Code Agent 任务，所有 Agent 的代码修改互不干扰。
 
 ## 安装
 
@@ -12,340 +12,135 @@ pnpm add -g clawt
 npm i -g clawt
 ```
 
-**环境要求：**
+**环境要求：** Node.js >= 18 · Git >= 2.15 · Claude Code CLI
 
-- Node.js >= 18
-- Git >= 2.15
-- Claude Code CLI（`clawt run` 和 `clawt resume` 需要）
-
-## 使用前提
-
-所有命令**必须在主 worktree 的仓库根目录**下执行（即包含 `.git` 目录的原始仓库）。在子 worktree 或子目录中执行会被拒绝。
-
-## 全局选项
-
-| 选项 | 说明 |
-| ---- | ---- |
-| `--debug` | 输出详细调试信息到终端，实时显示带颜色和时间戳的日志 |
-
-`--debug` 可与任意子命令组合使用：
-
-```bash
-clawt run -b feature-login --debug
-clawt validate -b scheme --debug
-```
-
-## 命令
-
-### `clawt create` — 批量创建 worktree
-
-```bash
-clawt create -b <branchName> [-n <count>]
-```
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 是 | 分支名 |
-| `-n` | 否 | 创建数量，默认 `1` |
-
-创建 1 个时，分支名即为 `<branchName>`；创建多个时，分支名会自动加后缀编号：`<branchName>-1`、`<branchName>-2`……
-
-```bash
-# 创建 1 个 worktree
-clawt create -b feature-login
-
-# 创建 3 个 worktree
-clawt create -b feature-scheme -n 3
-```
-
-### `clawt run` — 批量创建 worktree + 并行执行 Claude Code 任务
-
-```bash
-# 多任务并行
-clawt run -b <branchName> --tasks <task1> --tasks <task2> --tasks <task3>
-
-# 单 worktree + Claude Code 交互式界面
-clawt run -b <branchName>
-```
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 是 | 分支名 |
-| `--tasks` | 否 | 任务描述，可多次指定，任务数量即 worktree 数量。不传则在 worktree 中打开 Claude Code 交互式界面 |
-
-每个 `--tasks` 对应一个独立的 worktree，Claude Code 会在各自隔离的环境中并行执行任务。任务完成后会实时通知结果，全部完成后输出汇总信息。
-
-不传 `--tasks` 时会创建单个 worktree，并在其中直接启动 Claude Code 交互式界面（通过 `spawnSync` + `inherit stdio`），让用户与 Claude Code 直接交互。启动命令由配置项 `claudeCodeCommand` 指定（默认 `claude`）。如果指定的分支已存在，会提示使用 `clawt resume -b <branchName>` 恢复会话。
-
-任务执行过程中按 Ctrl+C 可中断所有任务。中断后会根据配置自动清理或询问是否清理本次创建的 worktree 和分支（`autoDeleteBranch: true` 时自动清理）。
+## 快速开始
 
 ```bash
-# 多任务并行
-clawt run -b feature-scheme \
+# 1. 在项目根目录（包含 .git 的目录）下执行
+# 2. 并行执行 3 个任务，每个任务在独立的 worktree 中运行
+clawt run -b feature-auth \
   --tasks "实现用户登录功能" \
   --tasks "实现用户注册功能" \
   --tasks "实现密码重置功能"
 
-# 单 worktree，打开 Claude Code 交互式界面
-clawt run -b feature-login
-```
+# 3. 查看所有 worktree 状态
+clawt status
 
-### `clawt resume` — 在已有 worktree 中恢复 Claude Code 会话
+# 4. 验证某个分支的变更（在主 worktree 中测试）
+clawt validate -b feature-auth-1
 
-```bash
-# 指定分支名（支持模糊匹配）
-clawt resume -b <branchName>
+# 5. 确认无误后合并到主分支
+clawt merge -b feature-auth-1 -m "feat: 实现用户登录功能"
 
-# 不指定分支名（列出所有分支供选择）
-clawt resume
+# 6. 清理不需要的 worktree
+clawt remove -b feature-auth
 ```
 
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 否 | 要恢复的分支名（支持模糊匹配，不传则列出所有分支供选择） |
+## 命令一览
 
-在之前通过 `clawt run` 或 `clawt create` 创建的 worktree 中重新打开 Claude Code 交互式界面，继续之前的工作。启动命令由配置项 `claudeCodeCommand` 指定（默认 `claude`）。
+> 所有命令必须在**主 worktree 的仓库根目录**下执行。`-b` 参数支持模糊匹配。
 
-**分支匹配策略：**
-- 传 `-b` 时，优先精确匹配分支名；未精确匹配则进行模糊匹配（子串匹配，大小写不敏感）；模糊匹配到多个时通过交互列表选择；无匹配时报错并列出所有可用分支
-- 不传 `-b` 时，列出当前项目所有可用分支供交互式选择（仅 1 个时自动使用）
+### `clawt run` — 创建 worktree 并执行任务
 
 ```bash
-# 精确匹配
-clawt resume -b feature-login
-
-# 模糊匹配（匹配包含 "login" 的分支）
-clawt resume -b login
+# 多任务并行（每个 --tasks 对应一个独立 worktree）
+clawt run -b <branch> --tasks "任务1" --tasks "任务2"
 
-# 交互式选择所有分支
-clawt resume
+# 单 worktree，打开 Claude Code 交互式界面
+clawt run -b <branch>
 ```
 
-### `clawt validate` — 在主 worktree 验证分支变更
+按 `Ctrl+C` 可中断所有任务。
 
-```bash
-# 指定分支名（支持模糊匹配）
-clawt validate -b <branchName> [--clean]
+### `clawt resume` — 恢复之前的 Claude Code 会话
 
-# 不指定分支名（列出所有分支供选择）
-clawt validate [--clean]
+```bash
+clawt resume -b <branch>   # 指定分支
+clawt resume                # 交互式选择
 ```
 
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 否 | 要验证的分支名（支持模糊匹配，不传则列出所有分支供选择） |
-| `--clean` | 否 | 清理 validate 状态（重置主 worktree 并删除快照） |
-
-将目标 worktree 的变更通过 `git diff`（三点 diff）迁移到主 worktree，方便在主 worktree 中直接测试，无需重新安装依赖。同时检测未提交修改和已提交 commit，确保所有变更都能被捕获。
-
-**分支匹配策略：**
-- 传 `-b` 时，优先精确匹配分支名；未精确匹配则进行模糊匹配（子串匹配，大小写不敏感）；模糊匹配到多个时通过交互列表选择；无匹配时报错并列出所有可用分支
-- 不传 `-b` 时，列出当前项目所有可用分支供交互式选择（仅 1 个时自动使用）
-
-支持增量模式：首次 validate 后会自动保存快照（通过 `git write-tree` 将变更存储为 git tree 对象，并记录当前 HEAD commit hash），再次 validate 同一分支时会将上次快照载入暂存区、最新变更保留在工作目录，用户可通过 `git diff` 查看两次 validate 之间的增量差异。当主分支 HEAD 发生变化（如合并了其他分支）时，会自动将旧变更 patch 重放到当前 HEAD 暂存区上，避免 diff 混入 HEAD 变化的内容；若 patch 存在冲突则自动降级为全量模式。使用 `--clean` 可清理 validate 状态（重置主 worktree 并删除快照文件）。
-
-> **提示：** 如果 validate 时 patch apply 失败（目标分支与主分支差异过大），可先执行 `clawt sync -b <branchName>` 同步主分支后重试。
+### `clawt create` — 仅创建 worktree（不执行任务）
 
 ```bash
-# 精确匹配分支名
-clawt validate -b feature-scheme-1
-
-# 模糊匹配（匹配包含 "scheme" 的分支）
-clawt validate -b scheme
-
-# 交互式选择所有分支
-clawt validate
-
-# 再次验证（增量模式，可通过 git diff 查看增量差异）
-clawt validate -b feature-scheme-1
-
-# 清理 validate 状态（同样支持模糊匹配）
-clawt validate -b feature-scheme-1 --clean
-clawt validate --clean
+clawt create -b <branch>           # 创建 1 个
+clawt create -b <branch> -n 3      # 批量创建 3 个
 ```
 
-### `clawt sync` — 将主分支代码同步到目标 worktree
+### `clawt validate` — 在主 worktree 中验证分支变更
 
 ```bash
-# 指定分支名（支持模糊匹配）
-clawt sync -b <branchName>
-
-# 不指定分支名（列出所有分支供选择）
-clawt sync
+clawt validate -b <branch>         # 将变更迁移到主 worktree 测试
+clawt validate -b <branch> --clean  # 清理 validate 状态
 ```
 
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 否 | 要同步的分支名（支持模糊匹配，不传则列出所有分支供选择） |
-
-将主分支最新代码合并到目标 worktree 的分支中。如果目标 worktree 有未提交的修改，会自动保存后再合并。存在冲突时会提示用户手动解决。合并成功后会自动清除该分支的 validate 快照（代码基础已变化，旧快照无效）。
+支持增量模式：再次 validate 同一分支时，可通过 `git diff` 查看两次之间的增量差异。
 
-**分支匹配策略：**
-- 传 `-b` 时，优先精确匹配分支名；未精确匹配则进行模糊匹配（子串匹配，大小写不敏感）；模糊匹配到多个时通过交互列表选择；无匹配时报错并列出所有可用分支
-- 不传 `-b` 时，列出当前项目所有可用分支供交互式选择（仅 1 个时自动使用）
+### `clawt sync` — 同步主分支代码到目标 worktree
 
 ```bash
-# 精确匹配分支名
-clawt sync -b feature-scheme-1
-
-# 模糊匹配（匹配包含 "scheme" 的分支）
-clawt sync -b scheme
-
-# 交互式选择所有分支
-clawt sync
+clawt sync -b <branch>
 ```
 
 ### `clawt merge` — 合并分支到主 worktree
 
 ```bash
-# 指定分支名（支持模糊匹配）
-clawt merge -b <branchName> [-m <commitMessage>]
-
-# 不指定分支名（列出所有分支供选择）
-clawt merge [-m <commitMessage>]
-```
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `-b` | 否 | 要合并的分支名（支持模糊匹配，不传则列出所有分支供选择） |
-| `-m` | 否 | 提交信息（目标 worktree 工作区有修改时必填） |
-
-将目标 worktree 的变更合并到主 worktree 的当前分支。如果配置了 `autoPullPush: true`，合并后会自动推送到远程仓库。如果目标 worktree 工作区有未提交的修改，需要通过 `-m` 提供提交信息；如果目标 worktree 已经提交过（工作区干净但有本地提交），可以省略 `-m` 直接合并。merge 成功后会询问是否清理对应的 worktree 和分支（如果配置了 `autoDeleteBranch: true` 则自动清理）。
-
-**分支匹配策略：**
-- 传 `-b` 时，优先精确匹配分支名；未精确匹配则进行模糊匹配（子串匹配，大小写不敏感）；模糊匹配到多个时通过交互列表选择；无匹配时报错并列出所有可用分支
-- 不传 `-b` 时，列出当前项目所有可用分支供交互式选择（仅 1 个时自动使用）
-
-如果检测到目标分支存在 `clawt sync` 产生的临时提交（auto-save commit），会自动提示是否将所有提交压缩（squash）为一个。用户选择压缩后，所有 commit 会被 reset 到暂存区：如果提供了 `-m` 则直接提交并继续合并流程；如果未提供 `-m` 则提示用户前往目标 worktree 自行提交后重新执行 merge。
-
-```bash
-# 精确匹配，目标 worktree 有未提交修改，需提供 -m
-clawt merge -b feature-scheme-1 -m "feat: 实现用户登录功能"
-
-# 模糊匹配（匹配包含 "scheme" 的分支）
-clawt merge -b scheme
-
-# 交互式选择所有分支
-clawt merge
-
-# 目标 worktree 已提交过，可省略 -m
-clawt merge -b feature-scheme-1
+clawt merge -b <branch> -m "feat: 提交信息"   # 有未提交修改时需要 -m
+clawt merge -b <branch>                        # 已提交过可省略 -m
 ```
 
 ### `clawt remove` — 移除 worktree
 
 ```bash
-clawt remove [options]
-```
-
-支持三种移除粒度：
-
-```bash
-# 移除当前项目下所有 worktree
-clawt remove --all
-
-# 移除指定分支名下的所有 worktree（匹配 feature-scheme 和 feature-scheme-*）
-clawt remove -b feature-scheme
-
-# 移除单个 worktree（直接写完整分支名）
-clawt remove -b feature-scheme-2
+clawt remove -b <branch>    # 移除指定分支的 worktree（支持模糊匹配）
+clawt remove                 # 交互式多选要移除的 worktree
+clawt remove --all           # 移除当前项目下所有 worktree
 ```
 
-移除时会询问是否同时删除对应的本地分支。移除 worktree 时会自动清理对应的 validate 快照；`--all` 模式还会清理整个项目的快照目录。批量移除时单个失败不会中断整个流程，最后汇总报告失败项。
-
-### `clawt list` — 列出当前项目所有 worktree
+### `clawt list` — 列出所有 worktree
 
 ```bash
-clawt list [--json]
+clawt list            # 文本格式
+clawt list --json     # JSON 格式
 ```
 
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `--json` | 否 | 以 JSON 格式输出（仅包含 path 和 branch） |
-
-列出当前项目在 `~/.clawt/worktrees/` 下的所有 worktree 及对应分支。文本模式下，如果某个 worktree 处于空闲状态（0 个提交、无变更、无未提交修改），其路径会以橙色高亮显示，方便快速识别可能需要清理或还未开始工作的 worktree。指定 `--json` 时以 JSON 格式输出，便于脚本解析。
+### `clawt status` — 项目状态总览
 
 ```bash
-# 文本格式输出（默认）
-clawt list
-
-# JSON 格式输出
-clawt list --json
+clawt status          # 文本格式
+clawt status --json   # JSON 格式
 ```
 
-### `clawt reset` — 重置主 worktree 工作区和暂存区
+### `clawt reset` — 重置主 worktree 到干净状态
 
 ```bash
 clawt reset
 ```
 
-重置主 worktree 的工作区和暂存区（`git reset --hard` + `git clean -f`），恢复到干净状态。如果配置了 `confirmDestructiveOps: true`（默认），执行前会提示确认。与 `clawt validate --clean` 不同，`reset` 不会删除 validate 快照文件，适用于只想清空变更而保留快照以便后续增量 validate 的场景。如果工作区和暂存区已是干净状态，会提示无需重置。
+### `clawt config` — 查看配置
 
 ```bash
-# 重置主 worktree 工作区和暂存区
-clawt reset
+clawt config          # 查看当前配置
+clawt config reset    # 恢复默认配置
 ```
 
-### `clawt config` — 查看和管理全局配置
+## 配置
 
-```bash
-# 查看全局配置
-clawt config
+配置文件位于 `~/.clawt/config.json`，安装后自动生成：
 
-# 将配置恢复为默认值
-clawt config reset
-```
-
-读取并展示全局配置文件 `~/.clawt/config.json` 中的所有配置项，包括每项的当前值和描述说明。编辑配置需直接修改配置文件。
-
-`config reset` 子命令可将配置文件恢复为默认值，执行前会弹出确认提示（受 `confirmDestructiveOps` 配置项控制）。
-
-## 配置文件
-
-安装后会自动在 `~/.clawt/config.json` 生成全局配置文件：
-
-```json
-{
-  "autoDeleteBranch": false,
-  "claudeCodeCommand": "claude",
-  "autoPullPush": false,
-  "confirmDestructiveOps": true
-}
-```
-
-| 配置项 | 类型 | 默认值 | 说明 |
-| ------ | ---- | ------ | ---- |
-| `autoDeleteBranch` | `boolean` | `false` | 移除 worktree 时自动删除对应本地分支；merge 成功后自动清理 worktree 和分支；run 中断后自动清理本次创建的 worktree 和分支 |
-| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
-| `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
-| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean、config reset）前是否提示确认 |
-
-## 分支名规则
+| 配置项 | 默认值 | 说明 |
+| ------ | ------ | ---- |
+| `autoDeleteBranch` | `false` | 自动删除已合并/已移除的分支 |
+| `claudeCodeCommand` | `"claude"` | Claude Code CLI 启动命令 |
+| `autoPullPush` | `false` | merge 后自动 pull/push |
+| `confirmDestructiveOps` | `true` | 破坏性操作前确认 |
 
-分支名中的特殊字符（`/`、`.`、空格、`~` 等）会被自动替换为 `-`，连续的 `-` 会被压缩，首尾 `-` 会被去除。发生转换时会在终端提示。
+## 全局选项
 
-```
-feature/a.b  →  feature-a-b
-```
+| 选项 | 说明 |
+| ---- | ---- |
+| `--debug` | 输出调试信息 |
 
 ## 日志
 
-日志保存在 `~/.clawt/logs/` 目录，按日期滚动，保留 30 天。使用 `--debug` 全局选项可在终端实时查看调试日志。
-
-## 开发
-
-### 测试
-
-项目使用 [Vitest](https://vitest.dev/) 作为测试框架，搭配 `@vitest/coverage-v8` 生成覆盖率报告。
-
-```bash
-# 执行全部测试
-npm test
-
-# 监听模式（文件变更后自动重新运行）
-npm run test:watch
-
-# 执行测试并生成覆盖率报告
-npm run test:coverage
-```
-
+日志保存在 `~/.clawt/logs/`，按日期滚动，保留 30 天。