关于 cli-just
cli-just 是用于编辑和验证 Just 命令运行器配置文件的技能,遵循仓库已安装的版本和既有约定。它强调先检查现有配方、尽量少改动,并安全地验证行为。
主要功能
- 01检查 Just 版本和现有配方
- 02查阅对应版本的参考指南
- 03最小化修改配方和设置
- 04验证解析结果与配方行为
- 05通过试运行评估副作用
适用场景
- 01为仓库添加任务配方
- 02按原有风格更新 justfile
- 03检查依赖版本的 Just 语法
- 04安全验证会改变状态的配方
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ paulrberg/ agent-skills --skill cli-just安装后在 Claude Code 中输入/cli-just确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlexamples/devkit.juststandalone.justreferences/inline-scripts.mdpatterns.mdrecipes.mdsettings.mdsyntax.mdversion.txt详细介绍
Just 命令运行器
创建易读的任务自动化,使其符合仓库中已安装的 Just 版本和现有 justfile 约定。
默认规则
-
编辑前检查
just --version、现有 justfile/模块树以及just --list。已安装的功能和现有语法优先于本技能中的示例。 -
保留定制格式。不要用
just --fmt重写 justfile。仅当仓库明确以内置格式化程序为准时,才使用just --fmt --check。just --dump是检查输出,不是格式化依据。 -
多项字符串序列应逐项单独成行,并用括号括起拼接。每个非末项末尾都要保留分隔符。不要将它们合并成一个长字符串。三引号字符串用于换行具有语义的值,而非仅为视觉换行。例如:
check-steps := ( "event-class-coverage " + "orphan-disposal " + "price-coverage" ) -
创建新的独立 justfile 时,采用用户的分节横幅样式。现有仓库的组织方式优先于该样式。
工作流
-
确定所需配方的行为、输入、输出、工作目录、Shell、环境、依赖项和成功条件。
-
使用已安装版本的手册(
just --help、just --man或 https://just.systems/man/en/)确认与版本相关的语法。只阅读与任务相关的参考资料:任务 参考资料 配方、参数、依赖项、缓存、可执行文件检查、回显规则 references/recipes.md设置、dotenv、列表、模块 references/settings.md表达式、函数、常量 references/syntax.mdShell 或脚本配方、macOS Bash 限制 references/inline-scripts.md检查/写入、状态、别名、组织 references/patterns.md -
只做最小限度的配方或设置更改。除非所需设计确实需要不稳定功能,且已安装版本支持,否则不要启用此类功能。
-
使用
just --list或just --summary验证解析。然后执行影响范围最小且安全的配方路径。对于会更改状态的配方,使用现有的试运行/检查模式,或先检查展开后的命令。
约定式组织方式
对于新的独立文件,优先按以下顺序组织:依赖项声明、常量、公共配方、检查、私有辅助项。当没有适合作为默认操作的单一动作,且已安装版本支持时,使用 set default-list := true。可参考 examples/standalone.just 和 examples/devkit.just 中的起始模板。仅在创建相应结构时加载其中一个模板。
完成标准包括:justfile 可解析、所需配方行为符合预期,并提供与其副作用相适应的执行或试运行证据。最后以 ### ✅ Just 工作流已就绪 收尾;若更改了多个条目,则添加简洁的配方/别名/用途表;并添加 ### 🧪 验证,列出准确的命令及结果。确认提示、配方数据输出、编译器输出和 just --list 输出均不得添加装饰。保留仓库自身的横幅用语。