用途:该技能用于修改 Makefile 或 make/ 目录下文件时的工作流,帮助规范构建脚本的改动与验证。
适用文件:主 Makefile 以及 make/*.mk 被包含的 makefile。项目结构上,Makefile 作为主入口,包含 make/ 下的 go.mk(Go 相关目标)、docker.mk(Docker 目标)、atlas.mk(数据库迁移目标)、sqlc.mk(SQLC 生成目标)等。
主要能力与规范:缩进必须使用 tab(Make 要求);非文件目标使用 .PHONY;为目标添加帮助文本;按功能分组相关目标。最佳实践包括:不生成文件的目标标记为 .PHONY、依赖关系正确、变量用 ?= 设置默认值、主要目标有帮助文本。
使用方式:验证命令为 make mk-lint(对 makefile 做 lint)。手动检查可运行 make help 列出所有目标,以及 make -n {target} 做 dry run(若支持)。提交格式为 chore(make): {brief description},正文列出改动条目,并以 Closes #{issue_number} 关联 issue。分支、提交与 PR 流程需配合 git-workflow 技能。
限制:资料未提供具体安装步骤、依赖版本、支持平台或更多命令细节;示例目标仅展示 .PHONY、帮助注释与 echo 命令的写法。