用途:将当前分支强制覆盖远程目标分支。实现方式是删除远程目标分支后重新推送,从而避免使用 git push --force。
主要能力:覆盖前自动把旧的目标分支状态推为 backup/YYYYMMDDHHMM-<target> 备份分支;为备份分支向默认分支创建 PR;随后关闭该 PR 并删除备份分支,关闭的 PR 保留 GitHub 的“Restore branch”按钮以便恢复。若目标分支尚不存在(首次推送),跳过备份步骤。
使用方式:正常模式运行捆绑脚本:bash $HOME/.claude/skills/sync-force-to/scripts/sync-force-to.sh $ARGUMENTS,并把脚本输出原样报告给用户,除非报错否则不加额外评论。设置模式($ARGUMENTS 为 --setup)时不运行脚本,而是配置当前项目的 GitHub Actions 工作流,在 backup/* 分支上跳过 CI:查找 .github/workflows/*.yml 与 *.yaml;检查 push、pull_request 等触发器;若已有 branches 过滤则加入 '!backup/',无分支过滤则加 branches-ignore: ['backup/'],已有 branches-ignore 则追加 'backup/**'。不要修改 workflow_dispatch、schedule 等非分支触发器,只改 push 和 pull_request / pull_request_target;尽量保留原 YAML 格式与注释,提交前向用户展示改动 diff。
限制:这是破坏性操作,会覆盖远程分支,不得自动调用,必须始终先获得用户确认。资料未提供其他平台、权限或失败回滚细节。