makefile-review

介绍

开发过程中，Makefile 常常因为缺乏规范审查而隐藏着构建错误、平台不兼容或配方冗余等问题。这个 Skill 能够自动扫描你的 Makefile 文件，从语法正确性、目标依赖完整性、变量引用、shell 命令可移植性、重复 recipe 等多个维度进行静态分析，并生成详细的审计报告，帮助你在 CI/CD 或本地开发阶段提前发现并修复构建脚本中的隐患。

使用方式非常简洁：你只需将需要审计的 Makefile 路径或项目目录告诉 AI，Skill 便会自动解析文件内容，遍历所有规则和 target，检查诸如路径硬编码、缺失依赖、不兼容的 shell 命令、重复的 recipe 块等常见问题。它会以结构化列表的方式输出问题位置、严重等级和修复建议，你也可以要求它自动生成修复后的 Makefile 版本。

这款工具特别适合后端开发工程师、运维工程师以及全栈开发者，尤其是那些维护大型编译项目（如 C/C++、Go、Rust 等）或需要跨平台构建的团队。对于使用 Makefile 管理复杂构建流程的项目，定期执行审计可以显著降低因构建脚本错误导致的线上故障和重复劳动。

建议在每次修改 Makefile 后或新项目初始化时运行一次审计，并配合 CI 流程作为代码质量门禁之一。需要注意的是，该工具侧重于静态规则检查，不会实际执行构建命令，因此对于某些动态生成的变量或依赖外部工具链的隐式规则可能无法完全覆盖，建议结合实际构建测试使用。