Cookiecutter 项目脚手架生成器

解决什么问题

新建 Python 包或其他语言项目时，目录结构、构建配置、CI 脚本往往要反复手写。即使有历史项目可参考，复制粘贴也容易带进过时依赖或与当前规范不符的残留配置。Cookiecutter 的思路是把重复劳动固化成模板，一次生成代替手工搭建。

核心能力

• Jinja2 变量插值：模板中的 {{ project_name }}、{{ author }} 等占位符在生成时被实际值替换，一轮问答即可定制项目名、作者、许可证等元信息。
• 生成后钩子：脚手架落地后可自动执行预处理脚本，例如初始化 git 仓库、写入 .gitignore、调整文件权限，无需再手动走一遍收尾流程。
• 条件文件包含：借助模板内的 {% if %} 逻辑，部分文件或目录只在条件满足时才生成。需要数据库支持时才创建迁移脚本目录，纯 CLI 项目则跳过。
• 多源模板组合：不必依赖单个模板。团队私有的基础模板可以与社区模板叠加使用，在保留内部规范的同时复用上游最佳实践。
• 跨平台与多语言：Windows、macOS、Linux 均可运行；模板不限于 Python，HTML、Markdown、Rust、Go 等任何语言或标记格式都能套用。

使用流程

技能接收一组问题式输入（项目名、包名、作者等），按模板渲染文件树，执行钩子脚本，最终输出可直接进入开发的项目目录。命令行实用程序本身就是入口，不要求使用者具备 Python 知识。

适用边界与注意点

• 模板质量决定脚手架质量。模板陈旧会导致生成的项目从一开始就带有过时的依赖版本或已废弃的目录约定。
• 生成后钩子以本地脚本方式执行，来源不明的模板要先审查钩子内容再运行。
• 多源模板组合时，变量命名冲突需提前约定优先级，否则后加载的模板可能覆盖先加载模板的配置。