用途:清理 GitHub 组织内积累的陈旧分支,尤其是机器人、代理、迁移或依赖类分支及已合并 PR 留下的开发分支,强调以证据为准,而非直接批量 git push --delete。支持中途中断后续跑,不重复已完成删除。
主要能力:脚本 scripts/org_branch_cleanup.py 分三阶段——只读审计、显式 apply、完整 verify。默认候选为同仓库、已合并至少 14 天的 PR 头分支;已关闭未合并分支、无关联陈旧分支仅报告。默认排除 default、fork、archived、protected 及类发布 ref,并排除匹配 GHSA、state、archive 模式的仓库。审计产物不可变,含 snapshot.jsonl、delete-candidates.jsonl、closed-unmerged-review.jsonl、stale-unassociated.tsv、审计/应用 JSON 摘要等;apply 生成可续跑账本 deleted.tsv 与 skipped.tsv,verify 输出 verification.tsv。删除前重新读取实时 SHA、保护状态与开放 PR,预检跳过原因包括 moved、protected、open-pr、missing。
使用方式:先确认认证与限流余量:gh auth status;gh api rate_limit --jq '.resources | {core,graphql}'。再执行审计:python3 scripts/org_branch_cleanup.py audit --org example-org --output /tmp/example-org-branch-audit;可用 --include-repo-regex 限定单仓库。检查产物后执行 apply,需提供 --candidates 与 --confirm-org,并要求干净的 audit-summary.json;随后 verify 需指定 --ledger 与 --output。
适用场景:组织级分支积压清理、合并后残留分支治理、需要可追溯账本而非宽泛删除的场景。
限制:需要已认证且具备仓库管理权限的 gh CLI、组织登录名与输出目录。不得删除 default、protected、release、pages、stable 或活动 PR 分支,不能仅凭分支年龄或命名推断安全;候选必须是头名与当前分支顶端匹配的同仓库 PR。默认禁用已关闭未合并删除,除非显式传 --allow-closed-unmerged;不建议使用 --allow-unverified-candidates 或 --allow-partial-audit。generated 或安全仓库含数千 ref 时应先定义保留策略。收费、平台等更多信息暂未提供。