mcpField
C
cli-just

cli-just

github.com/paulrberg开发102787 次安装今天更新
代码仓库

关于 cli-just

cli-just 是用于编辑和验证 Just 命令运行器配置文件的技能,遵循仓库已安装的版本和既有约定。它强调先检查现有配方、尽量少改动,并安全地验证行为。

主要功能

  1. 01检查 Just 版本和现有配方
  2. 02查阅对应版本的参考指南
  3. 03最小化修改配方和设置
  4. 04验证解析结果与配方行为
  5. 05通过试运行评估副作用

适用场景

  1. 01为仓库添加任务配方
  2. 02按原有风格更新 justfile
  3. 03检查依赖版本的 Just 语法
  4. 04安全验证会改变状态的配方

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/paulrberg/agent-skills --skill cli-just

安装后在 Claude Code 中输入/cli-just确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
examples/
devkit.just
standalone.just
references/
inline-scripts.md
patterns.md
recipes.md
settings.md
syntax.md
version.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 时,采用用户的分节横幅样式。现有仓库的组织方式优先于该样式。

工作流

  1. 确定所需配方的行为、输入、输出、工作目录、Shell、环境、依赖项和成功条件。

  2. 使用已安装版本的手册(just --help、just --man 或 https://just.systems/man/en/)确认与版本相关的语法。只阅读与任务相关的参考资料:

    任务参考资料
    配方、参数、依赖项、缓存、可执行文件检查、回显规则references/recipes.md
    设置、dotenv、列表、模块references/settings.md
    表达式、函数、常量references/syntax.md
    Shell 或脚本配方、macOS Bash 限制references/inline-scripts.md
    检查/写入、状态、别名、组织references/patterns.md
  3. 只做最小限度的配方或设置更改。除非所需设计确实需要不稳定功能,且已安装版本支持,否则不要启用此类功能。

  4. 使用 just --list 或 just --summary 验证解析。然后执行影响范围最小且安全的配方路径。对于会更改状态的配方,使用现有的试运行/检查模式,或先检查展开后的命令。

约定式组织方式

对于新的独立文件,优先按以下顺序组织:依赖项声明、常量、公共配方、检查、私有辅助项。当没有适合作为默认操作的单一动作,且已安装版本支持时,使用 set default-list := true。可参考 examples/standalone.just 和 examples/devkit.just 中的起始模板。仅在创建相应结构时加载其中一个模板。

完成标准包括:justfile 可解析、所需配方行为符合预期,并提供与其副作用相适应的执行或试运行证据。最后以 ### ✅ Just 工作流已就绪 收尾;若更改了多个条目,则添加简洁的配方/别名/用途表;并添加 ### 🧪 验证,列出准确的命令及结果。确认提示、配方数据输出、编译器输出和 just --list 输出均不得添加装饰。保留仓库自身的横幅用语。

评论

支持 Markdown