SuperAPI AI 工具集

re0-git

编程与开发

查看项目

更新于 10-24 16:20

技能介绍

re0-git 是一个面向 Git 提交信息整理的技能,用于把已经完成的提交信息重写成干净、可直接交接的形式,并保持作者自己的日志风格,使 git log 单独就能说明变更内容。

用途

反复 amend 和推进式提交容易让提交信息变得臃肿、过时或夹杂琐碎内容。re0-git 会把信息重写成干净版本,让新的会话仅凭 git log 就能继续工作,而无需阅读 diff。它是在作者已有写法基础上进行精炼,只移动提交信息,并按日期规则处理时间戳,代码树本身永不改变。

该技能由用户主动调用,应在已经决定提交之后运行。如果提交清理工具在智能体可触及范围内,可能会让它在不该提交时倾向于提交,因此设计为用户触发。

工作流程

  1. 确定目标范围:通常是 HEAD,有时是一段未推送的短范围。

  2. 读取变更(git show --stat、git diff)以及任何已记录的提交规则。然后采样附近非目标提交信息:先取 10 条,如果约定明显则提前停止,或仅扩展到约定清晰为止。

  3. 按以下顺序解决混合日志:已记录的项目规则、附近涉及同一区域的提交、该约定下同一作者的提交。不要平均不兼容的风格,也不要让某位作者的习惯覆盖仓库约定。

  4. 按提交经济性原则重写信息:只保留持久的交接事实,把辅助性编辑并入其所服务的变更,删除 diff 或标签已经证明的内容。琐碎内容不单独成条。

  5. 重新提交并签名,日期按下方规则处理。对于顶端提交(HEAD):git commit --amend -S --date=now,其中 --date=now 会把作者日期移到当前时间;仅用 --amend 只会重置提交者日期,作者日期仍会过时。对于更早的提交,保留其日期:重建它——GIT_AUTHOR_DATE/GIT_COMMITTER_DATE git commit-tree <tree> -p <parent> -S -m "<new message>"——然后把所有后代提交重放到重建后的提交上(非顶端重写是 rebase,不是移动引用),否则会使它们成为孤儿。

  6. 验证并报告。

规则

  • 绝不创建或建议提交——re0-git 只重写已存在提交的信息。使用它绝不是提交的理由。

  • 只改信息——代码树必须保持逐字节一致(git diff <old> <new> 为空);在 re0-git 过程中绝不编辑内容。

  • 提交经济性——该技能执行的提交信息标准:每个真实、持久的变更一条要点,辅助性编辑并入其中;diff 或版本已证明的内容不写;不加共同作者标签;匹配本地日志自身的形态(按上述采样)。如果采样未发现固定形态,则回退为:主题行、空行,然后每个变更一条以 - 开头的要点,单行不换行——绝不用散文段落,因为日志应列举而非解释。已记录的检查清单对任何此类变更都强制要求的步骤(例如注册新技能、在源编辑后同步翻译文档)是流程已运行的证明,而不是关于本次变更的事实——应作为其所服务要点末尾的从句并入,或在该要点已隐含时删除;只有当其完成方式本身不明显时,才单独成条。同样的标准也约束初稿;re0-git 只对已经偏离该标准的信息执行此标准。

  • 日期按位置处理;始终 GPG 签名。正在最终处理的提交——HEAD——作者和提交者日期都取当前时间,因为重新清理最新提交本身就是持续工作。每个更早的提交(HEAD~1 及更早)保留其原始作者和提交者日期;绝不给过去重新打时间戳。

  • 未经明确确认,绝不重写已推送或共享的历史——那会强制 force-push。

验证

  • git diff <old-tip> <new-tip> 为空——内容未变。

  • 每个被重写的提交都经过 GPG 签名(%G? = G),日期符合预期。

  • 隐藏 diff 后单独重读 git log——如果任何被删掉的行对于理解变更仍然必要,则恢复它。