SuperAPI AI 工具集

rewrite-history

测试与质量

查看项目

更新于 10-15 21:12

技能介绍

用途:把当前分支混乱的开发历史整理成评审者可逐条阅读的逻辑化提交故事。原分支会被重写,同时保留备份以便回滚。

主要能力:创建备份分支 {branch}-backup-{timestamp}(需手动删除);分析当前分支与 main 的完整 diff;从 main 建临时分支重新实现;按“基础→功能→打磨”规划提交结构;用约定式提交信息逐条重建,中间提交使用 --no-verify;校验 git diff 必须为空,否则中止;将原分支指向干净历史,最终提交正常触发钩子;可选以 --force-with-lease 推送。

使用方式:参数 $ARGUMENTS 为可选标志,--auto 跳过交互确认。默认交互模式下会先展示提交计划,允许调整或取消。回滚命令:git reset --hard {branch}-backup-{timestamp}。

限制:在 main/master 分支、存在未提交改动、或分支与 main 无差异时会报错中止。字节一致校验不可跳过,任何差异都会立即中止并报告差异、保留备份。只分析完整 diff,忽略原提交历史;每个提交只处理一件事,保证可独立回退;提交信息格式为 type(scope): description;不得添加 Co-Authored-By 或生成工具署名;推送必须用 --force-with-lease,禁止 --force。

适用场景:提交历史零散、需要整理成便于评审的叙事型提交时。具体安装方式与平台支持暂未提供。