SuperAPI AI 工具集

custom-rebase

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:该技能面向 Fusion Framework 单体仓库,指导把功能分支变基(rebase)到最新 main 分支,并处理变基过程中常见的冲突,尤其是 pnpm 工作区中的 pnpm-lock.yaml 冲突。

主要能力:提供标准变基流程,包括获取远端更新、执行 git rebase origin/main、处理 pnpm-lock.yaml 冲突、处理“Version Packages”提交冲突、解决源码文件冲突、完成变基并强制推送。对 pnpm-lock.yaml 冲突,建议不要手工解决,而是用 pnpm install 重新生成锁文件后 git add pnpm-lock.yaml 并 git rebase --continue。对“Version Packages (next)”提交冲突,建议 package.json 与 CHANGELOG.md 使用 --ours(保留 main 的 HEAD 版本),因为 main 分支拥有权威版本与变更日志,功能分支的预发布版本会在变基后重新生成 changeset 时更新。

使用方式:先 cd 到工作树或分支,git branch 确认分支,git fetch origin 与 git fetch origin main:refs/remotes/origin/main 获取最新内容,然后 git rebase origin/main。遇到锁文件冲突时执行 pnpm install、git add pnpm-lock.yaml、git rebase --continue。若处于预发布模式且存在 .changeset/pre.json,可从仓库根目录运行 node .agents/skills/custom-rebase/scripts/align-pre-initial-versions.cjs 对齐 initialVersions。推送前可运行 node .agents/skills/custom-rebase/scripts/generate-rebase-report.cjs --no-fetch 生成原始数据报告,再由 AI 代理自动生成人类可读摘要,包含破坏性依赖变更、新增依赖、版本基线更新、风险评估与推送前检查清单。最后用 git push --force-with-lease origin YOUR_BRANCH_NAME 推送。

适用场景:功能分支需要同步 main、pnpm 单体仓库锁文件冲突、预发布版本与 main 常规版本冲突、需要审查变基差异与依赖变化时。

限制:资料未提供该技能的安装方式、收费、平台支持范围或效果保证;命令与脚本路径需按仓库实际结构使用,执行前应确认工作区干净并核对远端差异。