repo-tidy

Installation
SKILL.md

repo-tidy

把本地仓库恢复到「默认分支与远端一致、无可安全回收的遗留分支/worktree」的基线状态。默认分支优先读取 origin/HEAD,缺少该引用时才兼容 master/main。归位发生在下一个任务开始时(push 完 MR 未合,任务结束时无收尾时机)。

组件(脚本就地运行于 skill 目录,不复制副本):

  • scripts/repo_tidy.py —— 核心:tidy / --all / --new
  • scripts/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 续做规则,不额外开普通任务分支
  • 用户明确要求提交后的仓库整理

执行步骤

1. Dry-run 出清单

Installs
2
GitHub Stars
2
First Seen
Sep 1, 2026