用途:追踪上游仓库(如 ant-design React 版、ant-design/x React 版)从某个起始 commit 起的变更,筛选需同步到下游移植仓库(如 antdv-next Vue3 版)的 PR,输出带优先级的同步表格和逐 PR checklist 模板。支持多 worker 并行,主进程调度汇总,每个 worker 独立分析一个上游仓库或子包。
主要能力:读取 .sync-upstream.json 状态文件续传;按 Local(本地仓库 git CLI)、Auto-clone(克隆到 tmp 后清理)、Remote(GitHub API)三种模式获取 commit;按 conventional commit(fix/feat 等)与 PR 合并提交过滤;关联 PR 编号、标题、URL、Labels、改动文件;路径映射(上游文件→下游 monorepo 子包);评估优先级(P0 紧急到 P3 低,以及 Skip)与同步难度(Low/Medium/High);汇总生成同步表格;为非 Skip 的 PR 自动创建 sync/{upstream-name}-{pr-number} 分支并写入 checklist;更新 last_synced_commit 与时间。
使用方式:首次使用需询问上游仓库地址、起始 commit SHA、上游仓库名称,并创建 .sync-upstream.json;同时执行 echo ".sync-upstream.local.json" >> .gitignore 与 echo ".sync-checklist-*.md" >> .gitignore。后续直接说“继续同步”即可续传,无需再次提供 commit SHA。克隆与本地路径可用 .sync-upstream.local.json 覆盖。
适用场景:Web 前端组件库的上游到下游框架移植同步、monorepo 多子包并行追踪、需要优先级排序与 checklist 管理同步任务。
限制:GitHub API 未认证限流为 60次/小时,认证后为 5000次/小时,建议提供 token;部分直接 push 的 commit 可能无关联 PR,需人工判断;PR 数量超过 50 建议分批或按时间段拆分;优先级规则可按项目需求调整;克隆与清理、状态文件格式等细节需参考技能仓库中的 references 文档。费用、价格与平台兼容性等资料暂未提供。