SuperAPI AI 工具集

cmd-makefile

编程与开发

查看项目

更新于 10-16 10:21

技能介绍

用途:帮助为项目创建新的 Makefile、向现有 Makefile 添加目标、重构或改进已有 Makefile,以及设置 CI/CD 相关 make 目标与通过 GitHub Releases 分发预构建二进制。核心原则包括默认提供丰富分类帮助、Chrome 扩展默认采用模块化 makefiles/*.mk 布局、新建时先询问结构(扁平或模块化、丰富帮助或精简)、遵循已有约定、不过度设计、Python 命令一律用 uv run 执行,并在选择扁平或精简方案前解释原因。

主要能力与模板:按项目类型提供模板——任意项目 base.mk(最简)、Python+uv python-uv.mk(标准)、FastAPI python-fastapi.mk(全功能,会先询问测试是否拆分、是否需要 prod 目标、HEALTH_PATH)、PostgreSQL+Alembic postgres.mk(标准,会先询问 PG_PORT 默认 5433、软重置还是硬重置)、Node.js、Go、Chrome Extension(模块化)、Flutter(模块化)、Electron(模块化)、静态站点(标准,会先询问 DEPLOY_MODE 为 rsync/gh-pages/netlify/vercel/none)。配套文件包括 .template.env 与 scripts/export_openapi_spec.py。

使用方式:按分阶段流程执行。阶段一发现:先读现有 Makefile 匹配约定,确认技术栈、部署目标、项目规模。阶段二交互提问:一次性批量询问结构、帮助风格、Postgres 端口、测试粒度、是否需要 run-api-prod、是否导出 OpenAPI 规范。阶段三搭建:按顺序生成 Makefile 与 makefiles/*.mk、.template.env、.env.prod(仅在需要时,并确认已在 .gitignore)、导出脚本;不直接创建 .env,交给 make env-template。阶段四验证:运行 make help、make help-unclassified、make -n run-api-local db-migrate api-export-spec 做干跑,并检查守卫是否按预期触发。

命名与模式:目标用小写连字符加统一前缀分组(build-、dev-、db-、env-),内部目标以下划线开头不出现在帮助中;通用名 test、build、run、format、lint 可不加前缀。帮助由 ##@ 分节、## 注释自动生成,help 目标放在最后、catch-all 之前。变量用 ?= 便于命令行覆盖。

限制:具体收费、价格、平台支持与效果资料未提供;模板中的可选目标(如 build-beta、部署相关)是否需要取决于项目,资料未逐一说明全部适用边界。