用途:为项目生成符合惯例的 justfile,用 just 替代 Makefile 和零散 shell 脚本,让命令可发现、可复用。
主要能力:区分文件目标与命令,无需 .PHONY;任意缩进即可;支持参数、dotenv、OS 检测与模块;just --list 配合文档注释即可展示命令;支持 shebang 与 [script()] 内联脚本;多语言项目用生态后缀区分(如 test-rust、test-ts)。默认约定一个规范命令 just build(自动修复门禁)及其无自动修复的 CI 版本 just ci,产物打包用 dist 或 release。
使用方式:先扫描项目根目录识别生态标记(Cargo.toml、pyproject.toml、uv.lock、package.json、go.mod、Gemfile),再检查已有 Makefile、Taskfile.yml、Rakefile、package.json scripts 或 shell 脚本并迁移;已存在 justfile 时先给出差异并等授权。justfile 置于项目根,常用设置包括 set dotenv-load 与 set shell := ["bash", "-euo", "pipefail", "-c"];依赖工具用 require("jq") 声明。生成后需更新 AGENTS.md/CLAUDE.md 等代理上下文与 README 的开发章节,并把 CI 的验证步骤指向 just ci。
适用场景:需要统一构建/测试/lint 入口的项目、从 Makefile 迁移、多语言单仓(用 mod 组合各模块门禁)。
限制:just 是命令运行器而非构建系统,不能复刻 Make 的文件目标依赖跟踪,也不应替代 cargo、webpack 等真实构建系统;不设计 CI 流水线、不创建 Docker 配置;删除旧 Makefile 前需用户确认;不要把密钥写入 justfile;注意 just 可能不在 PATH、模块路径相对 justfile 位置等。
具体命令与配置示例、各语言参考文件与完整模板暂未提供。