SuperAPI AI 工具集

makefile-review

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:用于审查 Makefile,检查构建正确性、可移植性和配方重复,并给出改进建议。适合在 Makefile 改动或新增、构建系统优化、可移植性改进、CI/CD 流水线更新和开发者体验改进时使用。不适合创建新 Makefile(可用 abstract:make-dogfood)或架构审查(可用 architecture-review)。

使用方式:入口为 /makefile-review。流程包含六个必做项:context-mapped、dependency-graph、dedup-candidates、tooling-alignment、evidence-logged、findings-verified。第 1 步确认基线:pwd && git status -sb && git diff --stat,并查找 Make 相关文件:rg -n "^include" -g'Makefile*' 与 rg --files -g '*.mk'。第 2 步依赖图,第 3 步去重审计,第 4 步可移植性检查,第 5 步用 imbue:proof-of-work 记录命令输出与 file:line 引用并汇总问题(严重度、影响、建议重构、负责人与日期)。第 6 步将结果写入 .review/findings.json,运行引用校验器(Skill(imbue:review-core) 第 5 步),被拒绝的发现需删除或标注 UNVERIFIED。可按需加载 modules/best-practices.md 与 modules/plugin-dogfood-checks.md。

输出格式:包含 Summary、Context(审查文件与改动目标)、Dependency Analysis、Duplication Candidates(每条含位置、verbatim 锚点、建议)、Portability Issues、Missing Targets(如 help、format、lint)以及 Recommendation(Approve / Approve with actions / Block)。

限制:需项目中存在 Makefile 或 .mk 文件;include 链需用 rg -n "^include" -g'Makefile' 手动追踪。可用 pytest plugins/pensive/tests/skills/test_makefile_review.py 验证审查逻辑。