repo-tidy
Installation
SKILL.md
repo-tidy
把本地仓库恢复到「默认分支与远端一致、无可安全回收的遗留分支/worktree」的基线状态。默认分支优先读取 origin/HEAD,缺少该引用时才兼容 master/main。归位发生在下一个任务开始时(push 完 MR 未合,任务结束时无收尾时机)。
组件(脚本就地运行于 skill 目录,不复制副本):
scripts/repo_tidy.py—— 核心:tidy /--all/--newscripts/git-repo-status.sh—— SessionStart hook,开局注入一行[repo-status](分支/ahead-behind/脏净)。注册到~/.claude/settings.json的hooks.SessionStart:{"matcher": "*", "hooks": [{"type": "command", "command": "<skill绝对路径>/scripts/git-repo-status.sh", "timeout": 10}]}tests/test_repo_tidy.sh <scratch目录>—— 对抗测试(含双默认分支与非标准默认分支的对抗场景),改脚本后必须跑
何时用
- 用户说「归位」「整理仓库」「清理分支/worktree」
- 需要修改仓库的新任务开工前;只读审计、问答、续任务不归位,
[repo-status]本身不触发动作 - 显式调用 do-something 时遵循该 skill 的 do/main 续做规则,不额外开普通任务分支
- 用户明确要求提交后的仓库整理