Makefile 工作流生成器

要解决的问题

• 团队仓库缺少统一入口，build、test、lint、clean 全靠手写，新人只能翻脚本猜命令。
• .PHONY 声明容易漏写，伪目标和同名文件发生隐式依赖后，行为变得难以预测。
• 依赖文件变化追踪依赖手工规则，包含关系一旦复杂，make 经常「以为没变」。
• 不同语言栈混用时，npm scripts、Poetry tasks、Cargo commands 分散在不同目录，缺少统一编排。

技能如何工作

核心能力：

• 使用 GNU Make 语法 生成结构清晰、可被 make help 直接解释的 Makefile。
• 通过 autodeps pattern rules 让编译器或依赖扫描器产出的依赖文件被自动纳入增量构建判断。
• 把 npm scripts、Poetry tasks、Cargo commands 映射为标准 target，减少入口不一致。
• 产出 .PHONY 声明与 help 目标，让常用命令可以被发现、被复用、被安全重复执行。

关键步骤：

• 解析项目结构，识别语言栈、包管理器配置和已有脚本入口。
• 为常见工作流建立 target 草案，补齐参数、依赖顺序和执行目录。
• 在需要增量构建的位置插入 autodeps pattern rules，并让依赖关系可追踪。
• 生成 .PHONY 列表与 help target，使默认输出能列出可用命令。
• 输出可直接进入仓库的 Makefile，保留必要的注释与后续扩展位。

适用边界与注意点

• 输出遵循 GNU Make 语法；如需兼容 BSD make 或其他实现，应自行验证差异。
• autodeps 依赖工具链能稳定产出依赖文件，扫描失败或格式不一致会削弱增量判断效果。
• 生成结果适合作为工程基线，复杂发布流程、多阶段 CI 编排仍建议在 review 后补充。
• 不要把与技能无关的容器或文档安装页内容混入仓库配置，保持生成物单一职责。