历史版本与核实范围
引用固定历史提交12b9c3117a3cd0c16cbfab81545364df0aed6100中的完整主指南。发布者于2026-09-06 09:57:46 UTC将它移到nuxtstart/nuxtstart仓库;本页保留迁移前版本。2026-10-18 UTC核对精确文件、Git blob及完整正文,中文为全文翻译;代码示例和原始元数据按原样保留。文档中的安装、授权、设备、清理或发布命令均为历史资料,本站未执行;当前安装与运行效果未实测。原条目仓库、名称、标识、网址、安装命令及安装量保持原值。
完整主指南
采纳 NuxtStart 变更
维护一个采用映射:每个上游变更路径都属于一个有限领域,并记录一项集成决策。
1. 建立基线
- 阅读仓库说明,并检查当前分支、工作树、历史和远程仓库。
- 使用
git remote get-url nuxtstart确认小写的nuxtstart远程仓库存在。如果不存在,提议添加它并询问用户许可(仓库:nuxtstart/nuxtstart)。 - 从干净的工作树开始集成。当存在本地更改时,显示确切路径并请用户提交、储藏或授权安全的准备步骤。
- 记录拉取前的
HEAD,然后使用git fetch nuxtstart --prune进行获取。 - 从
nuxtstart/main采用,并使用git rev-parse nuxtstart/main记录其 SHA。NuxtStart 将源代码发布到main,发布过程会剥离仅存在于其development和staging分支上的路径——因此,生成的项目只能从main分支采纳变更。 - 使用
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/mainSHA; - 一个有限领域及其确切变更路径;
- 一个只读任务,检查最终源代码和路径特定历史;
- 上述四个集成分类;
- 必须报告上游意图、子端意图、可能冲突和相关检查。
并行运行独立领域审计,当超过可用槽位时分波次运行。将 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. 验证并报告
- 对照记录的拉取前
HEAD检查完整合并。 - 发现并运行仓库所需的格式化、lint、类型检查、测试和构建检查,与采用的领域成比例。同步所需的每个修复都属于待处理的合并,而不是后续提交——一旦同步的一部分落在合并提交之外,合并提交就不再是完整的审查点。
- 如果合并仍待处理,使用命名所采用上游 SHA 的常规主题提交它,例如
chore: sync with nuxtstart <sha>。正文是此同步的持久记录——对话结束后下面的报告就消失了,而提交不会——因此它必须携带审查的上游范围以及 已采用 / 已保留 / 已调和 的细分,给出每个决策背后的理由。 - 确认工作树没有未解决的合并状态。
- 报告:
- 从
git diff --stat <pre-pull HEAD> HEAD对子端的净效果,开头陈述为“N 个上游提交 → N 个文件变更”; - 审查的
nuxtstart/mainSHA 和范围; - 采用映射和任何子代理分配;
- 已接受的上游变更;
- 保留的子端定制;
- 已调和领域和冲突;
- 验证结果。
- 从
仅当每个上游变更路径均被考虑、审计的上游 SHA 已合并、验证通过且 Git 报告无未解决冲突时,运行才完成。
原始元数据
name: adopt-nuxtstart-changes
description: Audit, pull, and reconcile NuxtStart upstream changes into a generated repository
disable-model-invocation: true