Projen 单定义仓库配置再生成

问题背景

当仓库同时管理 package.json、.gitignore、CI 配置和依赖锁文件时，人工维护多套配置文件容易出现内容漂移：例如某次修改了 CI 的 Node 版本，却忘记同步 package.json 中的 engines 字段；调整了构建命令后，本地脚本与 CI 步骤又不一致。这类配置漂移会导致“本地能跑，CI 失败”的经典问题，排查时需要跨多个文件反复比对。

核心能力

这个技能让 Agent 基于唯一的项目定义（project definition）自动生成并刷新仓库样板配置，避免逐个文件手工编辑。其核心思路是把配置文件视为由 projen 合成（synthesize）的产物，而非静态文本。当项目结构发生变化时，只需更新定义，所有派生配置会由 projen 重新生成，从而保证内部一致性。

关键步骤

1. 定义项目：通过 pnpm dlx projen new 创建项目时，projen 会交互式收集基础信息（如语言、构建工具、测试框架），并生成 projenrc 文件。该文件是项目的唯一定义，后续所有配置都由它派生。
2. 合成配置：运行 projen synth 时，Agent 读取 projenrc，依次生成/更新目标文件。生成过程是确定性的——相同输入始终得到相同输出，避免随机性引入差异。
3. 刷新配置：当项目结构变化（如新增测试框架）时，直接修改 projenrc 并重新运行合成，所有相关文件（如 jest.config.js、CI 步骤）会被同步更新，无需手动跨文件修改。

适用边界

• 需 Node.js 环境，依赖 npm 或 pnpm；
• 合成结果依赖 projen 内置逻辑，复杂自定义逻辑需通过 .projenrc 中的代码实现；
• 适合配置文件与代码强关联的仓库，纯静态文档类仓库收益有限。