SuperAPI AI 工具集

github-to-origin

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:这是一份智能体执行手册,用于把仓库从 GitHub 迁移到 Cursor Origin 代码托管,并重新指向 Vercel,使生产环境继续正常部署。核心难点不在代码搬迁,而在 Vercel:仓库已在 Origin,生产却仍从 GitHub 构建,推送看似成功但线上静默停止更新。

主要能力与关键判断:区分“同步”与“迁移”——把 GitHub 连到 Cursor 只生成镜像,推送仍以 GitHub 为准,镜像状态显示 Mirror status: inbound;在 Origin 仓库安装 Vercel 应用也不等于从它部署,拥有生产域名的既有 Vercel 项目仍以 GitHub 为 Git 源,直到被重新指向。

使用方式:开始前收集 Origin 组织与仓库名、生产域名、是否保留 GitHub 作为备份远端(默认保留)。需要人工介入的只有两处:origin auth login 打开浏览器需用户完成;Cursor 侧解绑(步骤 6)是网页 UI 的输入确认对话框,无 CLI。其余步骤由智能体执行。流程包括:预检 origin --version、vercel --version、git status --porcelain;快照分支数、提交数、HEAD、根提交、标签数;认证并验证 origin auth status;查找或创建 Origin 仓库;以临时远端名推送全部分支与标签;校验一致性后重命名远端;在 Cursor 网页端解绑 GitHub;通过生产域名定位真实 Vercel 项目并重新连接 Git;用 vercel ls 与 vercel inspect 证明新部署上线;对关键路由做健康检查。

限制与注意:Origin 需要付费 Cursor 计划且处于早期测试阶段;不要提交未提交的工作;origin auth login 不可加超时或终止,否则令牌失效;不要让 Vercel CLI 自动链接,避免选错项目;不要用抓取 HTML 的方式验证部署;迁移后 GitHub Actions 停止运行,需通过 Depot 或 Buildkite 重新接入;回滚方式是改回远端名并让 Vercel 重连 GitHub,本手册不删除 GitHub 上任何内容。