SuperAPI AI 工具集

adopt-nuxtstart-changes

编程与开发

查看项目

更新于 10-18 13:23

技能介绍

历史版本与核实范围

引用固定历史提交12b9c3117a3cd0c16cbfab81545364df0aed6100中的完整主指南。发布者于2026-09-06 09:57:46 UTC将它移到nuxtstart/nuxtstart仓库;本页保留迁移前版本。2026-10-18 UTC核对精确文件、Git blob及完整正文,中文为全文翻译;代码示例和原始元数据按原样保留。文档中的安装、授权、设备、清理或发布命令均为历史资料,本站未执行;当前安装与运行效果未实测。原条目仓库、名称、标识、网址、安装命令及安装量保持原值。

发布者历史原文

官方迁移记录

完整主指南

采纳 NuxtStart 变更

维护一个采用映射:每个上游变更路径都属于一个有限领域,并记录一项集成决策。

1. 建立基线

  1. 阅读仓库说明,并检查当前分支、工作树、历史和远程仓库。
  2. 使用 git remote get-url nuxtstart 确认小写的 nuxtstart 远程仓库存在。如果不存在,提议添加它并询问用户许可(仓库:nuxtstart/nuxtstart)。
  3. 从干净的工作树开始集成。当存在本地更改时,显示确切路径并请用户提交、储藏或授权安全的准备步骤。
  4. 记录拉取前的 HEAD,然后使用 git fetch nuxtstart --prune 进行获取。
  5. 从 nuxtstart/main 采用,并使用 git rev-parse nuxtstart/main 记录其 SHA。NuxtStart 将源代码发布到 main,发布过程会剥离仅存在于其 development 和 staging 分支上的路径——因此,生成的项目只能从 main 分支采纳变更。
  6. 使用 git merge-base HEAD nuxtstart/main 查找合并基础。如果不存在,报告无法建立采用基线并请求一个。

当子 HEAD、nuxtstart/main SHA、合并基础和干净工作树状态均已知时,此步骤完成。

2. 构建采用映射

从紧凑清单开始,而不是打开每个历史提交:

git rev-list --count <merge-base>..nuxtstart/main
git diff --shortstat <merge-base> nuxtstart/main
git diff --dirstat=files,0 <merge-base> nuxtstart/main
git log --oneline --max-count=50 <merge-base>..nuxtstart/main

将完整的上游 git diff --name-status <merge-base> nuxtstart/main 输出保存为临时清单。按目录分组,以有限切片读取。仅针对需要分歧分析的领域,从 <merge-base> 到 HEAD 生成等效的子端清单。

将每个上游变更路径分组为一个有凝聚力的领域,例如 Nuxt 层、包、配置表面或文档集。对于每个领域,检查最终上游源代码、当前子源代码,以及仅与这些路径相关的历史。将其集成分类为:

  • 已存在 — 子端已实现最终上游意图。
  • 接受上游 — 上游状态应保持不变地进入。
  • 保留子端 — 有意子端定制应获胜。
  • 调和 — 双方均包含合并结果必须保留的意图。

随子代理扩展

当有超过 25 个上游提交、超过 50 个变更文件或至少三个独立领域时,委托审计。将包含超过 20 个变更路径的任何领域拆分为更小的有凝聚力的子领域。给每个子代理:

  • 子 HEAD、合并基础和 nuxtstart/main SHA;
  • 一个有限领域及其确切变更路径;
  • 一个只读任务,检查最终源代码和路径特定历史;
  • 上述四个集成分类;
  • 必须报告上游意图、子端意图、可能冲突和相关检查。

并行运行独立领域审计,当超过可用槽位时分波次运行。将 Git 集成和采用映射所有权保留给主代理。根据清单调和每个子代理报告,以便没有路径被遗漏或重复计数。

当每个上游变更路径在采用映射中恰好出现一次,且每个领域都有证据支持的集成决策时,此步骤完成。

3. 拉取上游状态

将审计分支作为一次可检查的合并拉取:

git pull --no-rebase --no-ff --no-commit nuxtstart main

--no-rebase 合并模板历史,--no-ff 即使快进可能也记录同步,--no-commit 保留干净的合并结果待检查。

将 FETCH_HEAD 与审计的上游 SHA 比较。当上游在审计期间推进时,在继续之前映射增量路径。将采用映射决策应用于待处理的合并,为每个调和领域保留双方意图。

切勿使用 git add -A 或 git add . 暂存。按名称逐个暂存每个已解决路径。修改/删除或重命名/删除冲突会将子端已删除路径的上游副本留在工作树中,因此批量暂存会静默重新引入它,而一个被丢弃的领域会一次同步地蔓延回来。有意识地解决每个此类冲突——git rm <path> 保留子端删除,git add <path> 接受上游文件。

如果拉取产生冲突,调用 /resolving-merge-conflicts(如果缺失,通过 npx skills@latest add mattpocock/skills --skill resolving-merge-conflicts 添加)并将采用映射作为意图陈述提供给它。冲突解决完成后恢复此技能。

当拉取已集成、每个采用映射决策均得到体现且没有未合并路径时,此步骤完成。

4. 验证并报告

  1. 对照记录的拉取前 HEAD 检查完整合并。
  2. 发现并运行仓库所需的格式化、lint、类型检查、测试和构建检查,与采用的领域成比例。同步所需的每个修复都属于待处理的合并,而不是后续提交——一旦同步的一部分落在合并提交之外,合并提交就不再是完整的审查点。
  3. 如果合并仍待处理,使用命名所采用上游 SHA 的常规主题提交它,例如 chore: sync with nuxtstart <sha>。正文是此同步的持久记录——对话结束后下面的报告就消失了,而提交不会——因此它必须携带审查的上游范围以及 已采用 / 已保留 / 已调和 的细分,给出每个决策背后的理由。
  4. 确认工作树没有未解决的合并状态。
  5. 报告:
    • 从 git diff --stat <pre-pull HEAD> HEAD 对子端的净效果,开头陈述为“N 个上游提交 → N 个文件变更”;
    • 审查的 nuxtstart/main SHA 和范围;
    • 采用映射和任何子代理分配;
    • 已接受的上游变更;
    • 保留的子端定制;
    • 已调和领域和冲突;
    • 验证结果。

仅当每个上游变更路径均被考虑、审计的上游 SHA 已合并、验证通过且 Git 报告无未解决冲突时,运行才完成。

原始元数据

name: adopt-nuxtstart-changes
description: Audit, pull, and reconcile NuxtStart upstream changes into a generated repository
disable-model-invocation: true