SuperAPI AI 工具集

makefile

编程与开发

查看项目

更新于 10-16 09:49

技能介绍

用途:为项目创建或更新 Makefile,补齐标准目标(如 help、all、test、cover、lint、format 等)。若项目没有 Makefile 则从零生成;若已存在则只添加缺失目标,绝不未经批准改动已有目标。

主要能力:先检测技术栈,按 CLAUDE.md 或 AGENTS.md、README.md、语言清单(package.json、pyproject.toml、Cargo.toml、go.mod、Gemfile 等)的顺序读取,只使用项目已确认存在的命令,不臆造命令。生成的 Makefile 采用自文档模式,每个目标用 ## 描述,help 目标用 grep 与 awk 提取说明。所有目标需列入 .PHONY。

覆盖与测试细节:cover 目标要避免覆盖工具默认进入 watch 模式导致挂起,vitest 追加 -- --run,jest 追加 -- --watchAll=false;pytest-cov、cargo、go test 通常自行退出,需先验证再加参数。test 输出应平衡,成功时给出简洁汇总,失败时给出失败测试名与断言等信息;vitest 避免 --reporter=verbose,jest 避免 --verbose,pytest 可用 -q 或 --tb=short,cargo test 必要时 --quiet,go test 除非调试否则避免 -v,prove(Perl)避免 --verbose。若工具只支持静默或全量输出,应询问用户如何处理。

使用方式:调用时先宣布“Running paad:makefile v2.0.0”然后继续执行;按流程检测、创建或补充目标,结束时逐行列出写入或更新的文件并标注 new 或 updated。若因改动已有目标而停下等待批准,也需说明。

限制:若项目任务运行器不是 make(如 npm run、just、task、nox、cargo xtask)且不希望引入 Makefile,则不应使用;若 Makefile 由 autotools、CMake、cargo-make 等生成,修改会被覆盖,应改生成器。修改已有目标实现(包括只加参数)必须获得明确批准。配置为实验性质,可读取 paad/config/paad.md 与 paad/config/makefile.md;配置不能改变子代理类型或授予写权限,否则应拒绝。