luw2007 fast-rebase
固化 squash-merge 后的快速 rebase：识别 upstream 已合并的本地 commit 并 drop，只重放未合并的，最后校验代码逐字节零丢失。
引擎是确定性脚本 scripts/fast-rebase.sh（本机：~/.claude/skills/fast-rebase/scripts/fast-rebase.sh）。在目标 git 仓库目录内运行。
三重信号判定「同一份代码」
- MERGED-EXACT —
git cherrypatch-id 完全一致（cherry-pick / rebase 合并）。 - MERGED-SQUASH — commit subject 出现在某 upstream commit 的 body 列表行 + 时间（authored 早于该 merge 的 commit time）+ state（它改的文件 ⊆ 该 squash commit 改的文件）三者齐备。
- REVIEW — 仅 message 命中，时间或 state 不符 → 保留，需人工确认。
- UNMERGED — upstream 无 → 保留重放。
工作流
分析（只读，不改任何东西）。 先 fetch 再判定，把判定表+drop plan 原样呈现：
bash ~/.claude/skills/fast-rebase/scripts/fast-rebase.sh --fetch --base <base>--base默认 origin 的默认分支；缺少origin/HEAD时优先origin/main，再回退origin/master。分析任意分支不 checkout 用--head <ref>。决策。
- 输出
0 already-merged→ 普通git rebase <base>即可，结束。 - 出现
REVIEW行 → 暂停，逐条向用户解释 message 命中但时间/state 不符的原因，确认后再继续。 - 用户未要求实际执行 → 停在分析，提示其确认后再加
--apply。
- 输出
执行（仅在用户确认/明确要求时）。 脚本自动建 backup 分支、drop 已合并 commit、校验树一致：
bash ~/.claude/skills/fast-rebase/scripts/fast-rebase.sh --base <base> --apply解决冲突。 脚本在冲突处暂停。读冲突文件、理解两侧改动后手术刀式解决（常见形态与正解见 Local Lessons Learned），
git add后git rebase --continue，直到完成。冲突暂停后脚本已退出、自动校验不会跑——全部 continue 完成后必须手动跑一次--verify才能拿到逐字节铁证：bash ~/.claude/skills/fast-rebase/scripts/fast-rebase.sh --verify验收。 以脚本输出
VERIFIED: ... byte-identical to <backup>为铁证——证明 rebase 后代码与备份逐字节一致、零丢失。若提示 tree differs，必须git diff <backup> HEAD核对差异来源（仅当 upstream 改过被保留文件时才允许非空）。
运行时自修复（L1）
git 行为与 squash MR body 格式会演化。执行中若某步与实际 git 输出不符（flag 变更、squash body 不再用 * subject 列表致 message 匹配失效、git cherry 格式变动），就地修正 scripts/fast-rebase.sh 或判定逻辑并说明原因，勿硬套过时步骤；并回灌到 Local Lessons Learned。
硬约束
- 禁止自动 push。 完成后只告知备份分支名（
backup/pre-fast-rebase-*），由用户自行删除。 - 保护未跟踪 WIP。
--apply前工作树须干净（脚本会拒绝 dirty tree）；勿用reset --hard等会波及未提交文件的操作。 - 不重写无关历史。 若要 drop 的 commit 被大量活跃 commit 压在历史中间，宁可放弃 drop 优化、用普通 rebase，也不为抹一个 commit 去 rebase 穿过他人在飞的工作。
Local Lessons Learned
Private runtime lessons are stored outside Git so multiple local agents can share them without uploading them to GitHub.
- Read before execution:
${XDG_STATE_HOME:-~/.local/state}/openclaw-skills/fast-rebase/lessons-learned.md - If the file exists, treat it as part of this skill's local context.
- After real usage, update that file only when a new lesson changes future behavior.
- Keep at most 10 deduped lessons; evict stale or low-value entries first.
- When writing, acquire an atomic lock with
mkdir "${XDG_STATE_HOME:-$HOME/.local/state}/openclaw-skills/fast-rebase/lessons-learned.lock"; remove it after the write. - Do not commit the local lessons file or copy private lessons back into this
SKILL.md.