playbook/antigravity-awesome-skills/docs_zh-CN/maintainers/ci-drift-fix.md

CI 漂移修复指南

问题：失败的作业是由于在更新脚本运行后在 README.md、skills_index.json 或目录文件中检测到未提交的更改引起的。

错误：

❌ 检测到由 registry/readme/catalog 脚本产生的未提交更改。

原因： 像 tools/scripts/generate_index.py、tools/scripts/update_readme.py 和 tools/scripts/build-catalog.js 这样的脚本会修改 README.md、skills_index.json、data/catalog.json、data/bundles.json、data/aliases.json 和 CATALOG.md。工作流期望这些文件在脚本运行后没有更改。任何差异意味着提交的仓库与生成脚本产生的内容不同步。

如何修复（每次都要这样做）：

1. 在本地运行完整的验证链：

   npm run chain
   npm run catalog
   

2. 检查更改：

   git status
   git diff
   

3. 提交并推送任何更新：

   git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
   git commit -m "chore: sync generated registry files"
   git push
   

总结： 始终提交并推送 registry、README 同步和 catalog 脚本产生的所有更改。这通过确保仓库和生成的工件与规范的 tools/scripts/* 管道保持同步，保持 CI 通过。