SuperAPI AI 工具集

makefile

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:Makefile 模板生成与验证工具,支持 Generate(按项目类型生成标准化 Makefile)和 Validate(检查现有 Makefile 是否符合规范)两种模式。核心原则是注释即文档、make 即入口。

主要能力:Generate 模式提供 Go、Node、Python、Docker、Monorepo 五类模板,可依据 go.mod、package.json、pyproject.toml/setup.py、docker-compose.yml、pnpm-workspace.yaml/lerna.json 自动检测项目类型,无法检测时询问用户。生成流程为检测或询问类型、读取对应模板、调整变量(如 APP_NAME、端口)、写入 Makefile,并提示运行 make 验证 help 输出。约定 .DEFAULT_GOAL := help,使无参数 make 等同 make help;## 描述须与 target 同行,格式为 target: deps ## 描述;.PHONY 声明所有非文件 target;help 的 grep/awk 管线不要随意改动。

Validate 模式:读取目标 Makefile,按规则逐项检查并输出格式化报告。ERROR 包括缺少 .DEFAULT_GOAL := help、缺少 help target、help 未用 ## 解析、非文件 target 缺 ## 注释、注释未同行、## 后无空格、.PHONY 不完整、缩进未用 Tab;WARNING 包括未声明 SHELL、缺 clean、变量未用 :=、长命令未换行、help 管线缺 ANSI 高亮、target 未分组;INFO 为最佳实践建议。报告后如有 ERROR 会询问是否自动修复,修复后重新校验。

适用场景:需要为不同技术栈快速生成统一 Makefile,或对已有 Makefile 做规范检查与修复。

限制:资料未提供具体安装命令、收费方式、平台支持及模板完整内容;模板文件路径为 assets/Makefile.<type>.tmpl,校验规则详见 references/validation-rules.md。