用途:检查并配置项目的 Makefile,使其符合团队标准,覆盖新项目初始化、现有 Makefile 缺失目标审计以及 CI/CD 结构合规检查。
主要能力:识别项目类型(Python、Node、Rust、Go 或通用),检查必需目标 help、test、build、clean、lint 是否存在;按上下文判断是否需要 start、stop、format。检查 .DEFAULT_GOAL := help、.PHONY 声明、彩色输出变量和自动生成的 help 目标。按项目语言使用对应命令,如 Python 的 uv run ruff check .、uv run pytest,Node 的 npm run lint、npm test,Rust 的 cargo clippy -- -D warnings、cargo nextest run,Go 的 golangci-lint run、go test ./...。
使用方式:调用 /configure:makefile;参数 --check-only 仅报告合规状态不做修改,--fix 自动应用修复,无参数则检查后提示确认。执行流程为检测项目类型、分析现有目标、运行合规检查、生成报告,必要时创建或更新 Makefile,并更新 .project-standards.yaml(如 components: makefile: "2025.1"),最后提示运行 make help 验证。
适用场景:为需要 Make 的项目新建 Makefile、审查缺失标准目标、统一团队约定、CI/CD 合规检查、添加语言特定构建/测试/lint 目标。
限制:若项目可改用 Just 或需从 Makefile 迁移至 Justfile,应使用 /configure:justfile;编写复杂构建依赖规则需参考 GNU Make 文档;若项目完全使用语言原生构建系统(如 cargo、go build),不适用;调试单个目标可直接运行 make -n <target>。批量合规检查用 /configure:all,相关技能还有 /configure:workflows 和 /configure:dockerfile。