Agent Skills
返回列表
Crutf 模板刷新助手

Crutf 模板刷新助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/refresh-cookiecutter-based-repositories-from-upstream-template。

技能介绍

要解决的问题

用 Cookiecutter 生成的项目,在模板发布新版本后会面临两难:要么手动重建整个仓库,重答一遍所有问题、重写本地改动;要么继续停留在旧模板,错过上游的修复和新特性。这个项目生成的仓库里通常还保存着 cookiecutter.json 对应的 answers 文件和若干后续手工调整,重建成本并不低。

技能如何工作

这个技能围绕 Cruft 展开,核心目标是把模板更新安全地合并进现有仓库:

  • 追踪模板来源:识别仓库当前指向的上游模板地址,作为后续拉取变更的基准。
  • 预览差异:先查看模板变更的 diff,确认这次更新动了什么,再决定是否应用。
  • 应用更新:将上游模板的新变化应用到生成的仓库中。
  • 保留本地答案:尽力保持仓库中已保存的 answers 与本地定制,避免被模板变更覆盖。

整个过程不需要把项目推倒重来,agent 可以按「追踪 → 预览 → 应用 → 保留」的路径逐步执行。

适用边界与注意点

  • 前置条件:环境里要有 Python 与 Cruft,且目标仓库确实是从 Cookiecutter 模板生成的,否则没有可追踪的模板来源。
  • 模板改动与本地定制冲突时,仍可能需要人工介入,工具只能「尽可能」保留而非保证零冲突。
  • 技能行为以 Cruft 上游文档为准,详见 https://cruft.github.io/cruft/。

截图预览

使用场景

  • 维护基于 Cookiecutter 的代码仓库,需要从上游模板拉取最新改动。
  • 上游模板发布新版本,想预览变更差异并应用到本地仓库。
  • 更新模板时担心覆盖项目已保存的 Cookiecutter 答案文件。
  • 需要保留本地定制代码,同时同步模板的安全修复与新特性。

适合人员

  • 维护 Cookiecutter 生成仓库的后端工程师,需要安全同步上游模板更新。
  • 管理团队项目模板的技术负责人,希望降低模板升级带来的冲突成本。
  • 开发内部脚手架的 DevOps 工程师,需要保留各项目本地答案与定制。
  • 从模板生成多个仓库的开发者,担心重复初始化导致本地修改丢失。