SuperAPI AI 工具集

github-cleanup

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:对 GitHub 账号做渐进式审计与清理,任何破坏性操作前都需用户批准。前置条件是 gh auth status 必须通过,并先确认当前账号(用 gh api user 获取登录名并与 gh auth status 交叉核对,变量建议用 GH_USER,避免被 macOS 的 $USERNAME 遮蔽)。

主要能力与阶段:Phase 0 检查前置条件、统计仓库数;Phase 1 审计失败工作流(含 CodeQL default setup 需用 code-scanning/default-setup 接口,而非工作流文件)与 action 版本;Phase 2 审计过期 fork,用 compare 查看 ahead_by/behind_by,ahead 为 0 即无自定义改动;Phase 3 审计孤立 secrets,与工作流中的引用交叉比对;Phase 4/4b/4c 审计安全配置、Dependabot 告警排查、通用依赖卫生(区分直接依赖、传递依赖与运行时引擎如 openpyxl、lxml、kaleido,优先删除无用依赖而非升级);Phase 5 是必做的"还漏了什么"清单(本地克隆、GitHub Apps、deploy keys、webhooks、协作者);Phase 6 汇总发现并经 AskUserQuestion 批准后执行。

使用方式:支持完整审计(默认)、快速检查(quick check my GitHub)与定向审计(如 check for stale forks)。常用命令包括 gh repo list、gh api repos/.../compare/...、gh api .../actions/secrets、gh repo delete GH_USER/REPO --yes 等。删除仓库需 delete_repo 权限(gh auth refresh -h github.com -s delete_repo),修改安全设置需 security_events。

局限与注意事项:不适用于新建仓库或工作流、管理 issue/PR、CI/CD 搭建或改仓库内容;secrets 绝不自动删除,必须人工确认;删除仓库前先检查本地克隆避免残留远程;免费版私有仓库的 CodeQL 可能存在"僵尸"状态,无法通过 API/CLI 修复,需手动到 Settings → Code security 处理。Dependabot 扫描为异步,推送后需等待数分钟。