SuperAPI AI 工具集

branch-cleanup

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:报告陈旧的远程分支并提出安全删除建议,以及提议启用 delete-branch-on-merge。不负责本地 git worktree 管理,也不负责一次性的仓库合并默认值与分支保护设置(后者使用 /gh-bootstrap)。

主要能力:先检查 delete_branch_on_merge(gh api repos/$REPO --jq '.delete_branch_on_merge');若为 false 则提议开启并说明效果,写入操作需明确授权(gh api -X PATCH repos/{owner}/{repo} -F delete_branch_on_merge=true)。随后运行脚本 python3 "$BRANCH_CLEANUP_HELPER" --days 90 --github "$REPO" 报告每个远程分支的最后提交日期与作者、相对默认分支的 ahead/behind、是否已合并、是否有打开的 PR、是否受规则保护,输出按时间排序并带 keep/archive/delete 建议。也执行 git fetch --prune 与 git branch --merged <default> 仅报告本地已合并分支。

使用方式:从 SKILL.md 所在目录解析脚本路径 scripts/stale_branches.py;删除命令为 git push origin --delete <branch>,默认分支、受保护分支和有打开 PR 的分支始终归为 keep。可复制 assets/stale-branch-report.yml 到 .github/workflows/stale-branch-report.yml 生成定期报告,仅写作业摘要不删除分支。

限制:删除永远不自动执行,需按批次明确授权;本地分支删除同样需要授权。其他仓库健康检查见 /oss-hygiene。官方文本暂未提供。