SuperAPI AI 工具集

re0-squash

部署与运维

查看项目

更新于 11-09 16:50

技能介绍

用途

re0-squash 用于把一个 GitHub 仓库的提交历史合并为单个签名提交,并在保持文件树字节级一致的前提下,删除原远端仓库、按记录恢复的设置重建远端,最后推送这一个提交。它的目标不是重启项目:不重建任何内容,也不在远端保留旧分支归档。强制执行推送并不能清理 GitHub 上的历史,被重写的提交仍可能通过克隆、派生、缓存视图按哈希访问,或被引用它们的拉取请求触及;删除仓库才会让这些对象离开该仓库。因此该工具选择“压缩 + 删除 + 重建 + 推送单提交”的路径,只改变提交记录,不改动内容。

主要能力

  • audit:读取账面上的本地状态、删除远端会带走的所有远端条目、republish 将恢复的设置,并列出阻塞项与备注。无法读取的远端列表本身即视为阻塞项。公开派生仓库在删除后仍保留旧提交,超出该技能作用范围。
  • squash:在干净检出上把旧历史写入经过校验的 bundle(默认位于用户主目录,可用 --bundle 指定路径),并用同一文件树的单个签名提交替换当前分支,提交日期为当前时间。输出包含旧 tip(old)、新提交(new)、提交数(commits)、签名状态(signature)和 bundle 信息。
  • republish:再次审计,删除并重建 GitHub 仓库,恢复记录的设置,把单个提交作为默认分支推送。输出包含推送后的 head(pushed)、matchesLocal、设置漂移(settingsDrift)、未恢复项(notRestored)和 ok。

使用方式

前置条件:已配置 git 提交签名,gh 已认证并具备 delete_repo 权限,当前为默认分支的干净检出。--repo 可覆盖从 origin 读取的 owner/name。三个子命令均在仓库根目录运行(脚本以绝对路径调用):

node scripts/squash.mjs audit [--repo <owner/name>]
node scripts/squash.mjs squash --message-file <file> [--bundle <path>]
node scripts/squash.mjs republish --confirm <owner/name> [--accept-loss] [--repo <owner/name>]

每个子命令输出一个 JSON 对象。退出码:0 表示完成;1 表示拒绝或失败(脏工作树、分离 HEAD、--confirm 不匹配、存在未接受的阻塞项、提交数多于一个、git 或 gh 调用失败、推送后 head 不一致、恢复设置发生漂移等);2 表示用法错误;3 表示审计发现阻塞项。

流程上,先运行 audit,逐条向人类说明阻塞项,由其逐项接受或拒绝,任何一项被拒绝即终止且不压缩。压缩消息需先读取仓库文档化的提交规范与日志,编写一行主题加若干条能力要点,并让人类确认后再保存到文件。squash 之后只有在 commits 为 1 且 signature 为 G 时才能继续。republish 会删除仓库且不可撤销,只有在人类在本次对话中明确点名该仓库的 owner/name 后才可执行;删除前需通过 Skill 工具的 readback 让人类确认仓库与损失清单。最后观察首次 CI 运行,并向人类说明 bundle 路径、未恢复项(secrets、variables、webhooks、rulesets、deploy keys、collaborators 需手工重建)以及其他克隆需执行 git fetch 与 git reset --hard origin/<branch> 才能再次推送。

适用场景

需要从 GitHub 仓库历史中彻底清除敏感数据、同时保留当前代码内容;希望把冗长的历史收敛为单一签名提交并重建远端。

限制

  • 删除远端仓库不可撤销,必须由人类明确触发并确认。
  • 只重新发布一个分支,其他本地分支与标签保留旧提交且不会被推送。
  • 公开派生仓库仍持有旧提交,超出该技能能力范围。
  • secrets、variables、webhooks、rulesets、deploy keys、collaborators 不会被恢复。
  • 签名由脚本调用方负责验证,脚本本身不检查签名;无签名或多提交结果不得重新发布。
  • 任何步骤失败即终止;推送 head 不一致或设置漂移按失败报告,绝不视为完成。