git:20260908.c2a51c6 to git:20260920.66f62bf

+ Git repository tidy-up and parallel-task base: switch back to the latest master/main, delete merged or upstream-gone branches, remove stale worktrees. Ships four hooks: SessionStart injects repo status plus a [tasks] worktree menu; session-cwd records each session's working directory so the user's editor shortcut opens what the AI is actually working on; PreToolUse(EnterWorktree) fetches first so new task branches start from the latest default branch. In Claude Code, start tasks with EnterWorktree — `--new <task>` is the fallback for environments without it. Use before a new repository-changing task or when the user explicitly requests cleanup. Read-only audits, questions, continued tasks, and [repo-status] alone do not trigger mutations. Also use when the user says 归位, 整理仓库, 清理分支, 清理 worktree, 开新任务, repo tidy, tidy repo, clean branches.

+ - `scripts/git-repo-status.sh` —— SessionStart hook：注入 `[repo-status]`（分支/ahead-behind/脏净）+ `[tasks]` 菜单（各 worktree 的分支与状态：已合并可回收 / 已推送 MR 待合 / 未推送 / 工作区脏），供判断续任务还是开新任务

+ - `scripts/session-cwd.sh` —— 把本 session 的 cwd 写到 `~/.claude/session-cwd/<iTerm 会话 id>`。用户的编辑器快捷键按前台标签页 id 读它，于是打开的永远是 AI 当前所在目录——**子进程改不了父 shell 的 cwd，所以不能靠 shell 的当前目录**。静默输出（挂在 SessionStart/UserPromptSubmit 上，stdout 会被注入上下文）

+ - `scripts/worktree-fetch.sh` —— PreToolUse(EnterWorktree) 先 `fetch --prune`，保证新任务分支从最新的 origin/<默认分支> 切出

+ - `scripts/install.sh` —— 一键注册上面几个 hook 到 `~/.claude/settings.json`；幂等、改前备份、只增不删

+ - `scripts/editor-here.sh` —— 绑到编辑器快捷键：按前台标签页 id 读位置文件，打开 AI 当前所在目录；读不到再回退到终端路径

+ - `tests/` —— `test_repo_tidy.sh`、`test_session_cwd.sh`、`test_install.sh`（另有 `scripts/test_git_repo_status.sh`），改脚本后必须跑

+ ## 安装

+

+ 私人配置（`settings.json` / `CLAUDE.md`）不进版本库，所以用脚本改——幂等、改前备份、只增不删，不碰用户已有的其它 hook：

+

+ ```bash

+ bash "$SKILL_DIR/scripts/install.sh" # 安装（可反复跑）

+ bash "$SKILL_DIR/scripts/install.sh" --check # 只报告状态，不改

+ bash "$SKILL_DIR/scripts/install.sh" --uninstall # 只移除本 skill 注册的

+ ```

+

+ 装的是这几条（`CLAUDE_HOME` 可覆盖 `~/.claude`，测试用）：

+

+ | 事件 | matcher | 脚本 |

+ |---|---|---|

+ | SessionStart | `*` | `git-repo-status.sh`、`session-cwd.sh` |

+ | UserPromptSubmit | `*` | `session-cwd.sh` |

+ | PostToolUse | `EnterWorktree\|ExitWorktree` | `session-cwd.sh` |

+ | PreToolUse | `EnterWorktree` | `worktree-fetch.sh` |

+

+ hook 热生效，装完不用重启 session。

+

+ **编辑器快捷键（可选，但这是「随时看到 AI 在改什么」的关键）**：把 `scripts/editor-here.sh` 绑到快捷键（iTerm2：Preferences → Profiles → Advanced → Semantic History 或触发器协进程；也可用 Hammerspoon/Karabiner 调用）。直接绑 `code .` 是不行的——claude 运行期间终端的当前目录冻结在启动目录，子进程改不了父 shell 的 cwd，AI 切进 worktree 后 `code .` 打开的还是旧目录。默认开 VS Code，`EDITOR_HERE_APP` 可换别的。

+

+ ### 3. 开新任务

+ **Claude Code 里走 `EnterWorktree`，不要用 `--new`。**读 SessionStart 注入的 `[tasks]` 菜单判断：

+

+ - 续某个任务 → `EnterWorktree(path=<该 worktree 路径>)`

+ - 新任务 → `EnterWorktree(name=<task>)`

+ - 两个 session 共用一个 worktree（一个写、一个 review）→ 同样用 `path`

+ - 进门前**向用户一句话确认**；用户说留在主检出就留。session 中途换新任务：`ExitWorktree(keep)` 再 `EnterWorktree(name=...)`，同样先确认

+

+ 配套 hook 保证两件事：进门前已 fetch（新分支基于最新远端默认分支），进门后位置文件已更新（用户快捷键看到的就是这里）。主检出因此恒定停在默认分支，只作阅读窗口——**不在主检出上开工**，否则第一个任务就会把它占走，后续任务被迫绕到 worktree，而没人再把它还回来。

+

+ 没有 `EnterWorktree` 的环境（如其他 CLI）才用回退命令：

+

+ - 主检出空闲（在默认分支且无 tracked 改动）→ 原地 `switch -c task/<task> origin/<默认分支>`，**这会占用主检出**

+ - 主检出被占用 → 创建 sibling worktree `<仓库>--<task>`（基于最新 origin/<默认分支>）并输出 `cd` 路径