用途:围绕 Just 命令运行器编写与维护任务自动化,包括创建 justfile、编写 recipe、配置 settings、添加模块/属性,以及搭建命令运行器工作流。目标是生成可读、与仓库已安装 Just 版本和既有 justfile 约定一致的自动化。
主要能力与约定:编辑前先检查 just --version、现有 justfile/模块树和 just --list,以已安装能力与现有语法为准。保留仓库特有格式,不用 just --fmt 重写 justfile;仅当仓库明确以内置格式化器为准时才用 just --fmt --check。just --dump 只作检查输出,不作格式化来源。多元素字符串序列每行一项并用括号拼接,非末项保留尾部分隔符,不合并为长字符串;三引号字符串仅用于换行有语义的值。优先显式的小 recipe、Just 原生可执行检查、私有 helper、check/write 成对 recipe,以及放在目标 recipe 之后的 alias。若 justfile 已启用 set unstable 与 set lists,优先用 which() 加 assert() 并给出可操作的安装指引,否则可用 require()。断言仅在所有 recipe 都需要该工具时放顶层,否则作为受影响 recipe 的私有前置。recipe 默认静默,除非回显命令有明显价值,否则在名称前加 @;@recipe 内的行不再加 @;[script] recipe 不加 @。在原生 macOS 上默认 /bin/bash 3.2,除非显式选择更新 shell。新建独立 justfile 时沿用用户的 section-banner 风格,仓库既有组织优先。
使用方式:先确定所需 recipe 的行为、输入、输出、cwd、shell、环境、依赖与成功条件;用已安装手册(just --help、just --man 或 https://just.systems/man/en/)核对版本敏感语法;按任务只读对应参考(recipes.md、settings.md、syntax.md、inline-scripts.md、patterns.md)。做最小改动,不启用不需要的不稳定特性。用 just --list 或 just --summary 验证解析,再执行最窄的安全路径;有副作用的 recipe 先用 dry-run/check 或先查看展开命令。
适用场景与限制:适合维护 Just 任务自动化与命令运行器工作流。完成标准是可解析的 justfile、实现所需行为,并有与副作用相称的执行或 dry-run 证据。资料未提供具体版本兼容范围、平台支持细节与更多示例,需以实际安装版本和仓库约定为准。