SuperAPI AI 工具集

makefile

部署与运维

查看项目

更新于 10-16 00:22

技能介绍

用途:创建和管理针对 AI 智能体交互优化的 Makefile,用于服务进程生命周期管理。核心理念为“干净启动、干净停止、记录一切、掌握状态”,强调面向 AI 智能体(输出可程序化读取、无交互提示)、默认后台运行(服务分离运行,读日志而非开终端)、完整日志(所有输出写入 .logs/)、进程卫生(无孤儿进程)以及可适配任意服务拓扑。

主要能力:提供进程生命周期目标(run-* / stop-*)、组合操作(run、stop、restart)、测试与质量(test、lint)、实用目标(logs、status、help)。核心模式包括:后台启动并用 PID 跟踪、按进程组停止(kill -TERM -- -$PID)、状态检查、日志查看(logs、logs-follow)、带前置条件的测试、自文档化的 help 目标。

使用方式:创建前先做发现(服务拓扑、启动命令与环境变量、端口、初始化步骤、测试与 lint 工具、项目语言与约定)。Makefile 标准结构依次为配置变量、目录设置、服务生命周期目标、组合操作、测试与质量、实用目标、.PHONY 声明。make run 启动全部服务,make stop 停止全部服务,make restart 重启,make status 查看状态,make logs 或 make logs-follow 查看日志,make test 运行测试,make lint 运行检查。建议将 .pids/ 与 .logs/ 加入 .gitignore。

适用场景:需要启动、停止、监控多个本地服务(后端、前端、worker、模拟器等)的开发项目,尤其适合 AI 智能体驱动的工作流;可按场景适配多后端后缀命名、数据库迁移、Docker Compose 包装、monorepo 子目录变量、多种测试类型和 watch 模式。

限制:资料未提供安装命令、依赖要求、官方支持平台、许可与收费信息,暂未提供。