Cookiecutter 项目引导器

要解决的问题

项目初始化时最耗时的往往不是业务代码，而是仓库骨架反复手写：目录结构、pyproject.toml、LICENSE、CI 配置、.gitignore，每个新项目都从上一个项目抄一遍，抄着抄着就不一致了。简单的模板复制能缓解一部分问题，但当模板需要适配不同输入——包名、作者、版本策略、是否启用某个子模块——静态复制很快就不够用，最后变成「复制完再手动改十几个文件」的重复劳动。

核心能力

这个技能把 Cookiecutter 的模板机制封装成一次可复用的引导流程：

• Jinja2 变量替换：模板中的占位符在生成时由用户输入或配置文件注入，适合承载真正存在差异的字段，比如项目名、模块名、许可证类型。
• 后生成钩子：模板可以附带 post_gen_project.py，在文件落盘之后执行重命名、追加配置、删除可选目录等操作，把「生成完还要再修一遍」这类步骤收进模板，而不是留在人的记忆里。
• 远程模板注册表：模板无需本地克隆，直接给 Git 地址即可拉取，团队的统一骨架可以集中在一处维护。
• 自定义扩展插件：通过 Python 扩展接入项目特有的逻辑，与现有工具链衔接，而不是另起一套脚本。

一次典型的引导过程是：指定模板来源 → 填入上下文变量 → 生成目录树 → 执行钩子 → 得到可以直接提交的仓库。

适用边界与注意点

• 生成质量取决于模板作者的约定。它不局限于 Python，多语言、纯文档类模板同样可用，但前提是模板本身经过推敲。
• 钩子脚本运行在生成目录内，属于模板作者的代码。拉取第三方模板之前应当审阅其内容，不要默认它只做无害的文件操作。
• 它解决的是脚手架这一层问题，不包含依赖安装、虚拟环境创建或发布流程，这些仍需在生成之后再处理。