vendored-assets 是一个用于维护随代码仓库一同签入的第三方或外部生成资产的技能。资料将其定位为:把上游产物当作供应链输入,先修改生成器或已记录的导入来源,再重新生成;生成出来的内容是对照审查的“证据”,而不是可以直接编辑的表面。
用途 适用于导入或更新已签入仓库的第三方或外部生成的 JavaScript、CSS、注册表(registries)、schema、快照(snapshots)或 Scalar 等资产。
主要能力与工作流程
- 追踪归属:识别产物、生成器或精确导入流程、上游来源与版本、许可证、使用方、测试以及最终发布包或 bundle。按资产名和上游项目名搜索,找出当前打包脚本、生成产物、使用方与历史。只有在每个输入和使用方都有交代后才继续。
- 固定来源:把会变动的 URL、tag、分支和未注明版本解析为不可变的发布版或产物,在生成器或维护头中记录项目、版本、路径或 URL 以及摘要。仅当记录了另一份强制性的不可变来源时才省略摘要。只有在未来运行不会悄悄选取不同字节时才算通过。
- 通过许可证关口:核验发布元数据、许可证文件、随附声明以及分发包中保留的许可证链条;每个分发产物都有可验证的许可证留痕后才继续。
- 再生成:优先改进生成器或导入引用。对无生成器的资产,还原出精确操作流程;仅对反复出现的更新添加确定性脚本,并在产物旁记录一次性流程。干净重跑必须不产生差异。
- 审计完整差异:交代行为、URL 与运行时获取、source map、声明、编码、格式变化以及新增或删除。对浏览器资产,还需阅读 browser-assets.md。所有变更可归因、可疑内容已解决或上报后才继续。
- 通过测试与体积关口:记录变更前后的字节大小,运行聚焦的使用方测试;当发布的 JavaScript、CSS 或注册表输出有实质变化时,比较 bundle 大小或组成。应与更新前版本比较,而不是只测当前大小。聚焦检查通过且每个非平凡体积变化都有解释后才继续。
- 收尾发布影响:对使用方可见行为、浏览器支持、传输数据或显著的发布体积变化,在根变更集(root changeset)中做路由;由 barrel、AI 文档或迁移工具拥有的生成段落仍归根指令中列明的负责人处理。
完成标准 每个输入和使用方都有交代;来源与许可证不可变且已保留;再生成具有确定性;每项输出变更与非平凡体积变化都有解释;聚焦检查通过或已报告为不可运行;发布影响已记录。
适用场景 适合需要维护签入仓库的第三方代码、生成的 CSS/JS、schema、快照等资产,并关注供应链可追溯性、许可证合规、可复现构建与体积变化的开发工作流。
限制 资料未提供具体安装命令、命令行参数、支持的文件系统或构建工具细节,暂未提供。