cli-just

Just コマンドランナー

リポジトリにインストールされている Just のバージョンと既存の justfile の規約に合った、読みやすいタスク自動化を作成します。

デフォルト

• 編集前に、just --version、既存の justfile／モジュールのツリー、just --list を確認します。インストール済みの機能と既存の構文を、このガイドの例より優先します。

• 独自の書式を維持します。just --fmt で justfile を書き換えないでください。組み込みフォーマッターを正式な基準としてリポジトリが明示している場合に限り、just --fmt --check を使用します。just --dump は確認用の出力であり、書式設定の基準ではありません。

• 複数項目からなる文字列の並びは、括弧で囲んだ連結を使って、1 行につき 1 項目で定義します。最後以外の各項目の末尾には区切り文字を付けます。すべてを 1 つの長い文字列にまとめないでください。三重引用符付き文字列は、改行が見た目上の折り返しではなく、意味を持つ値に使用します。たとえば、次のようになります。

  check-steps := (
    "event-class-coverage " +
    "orphan-disposal " +
    "price-coverage"
  )
  

• 新しい単独の justfile を作成する場合は、ユーザーのセクション見出しスタイルを使用します。既存のリポジトリの構成は、そのスタイルより優先されます。

ワークフロー

1. 求められているレシピの動作、入力、出力、作業ディレクトリ、シェル、環境、依存関係、成功条件を確認します。

2. バージョンによって異なる構文については、インストール済みのマニュアル（just --help、just --man、または https://just.systems/man/en/）を参照します。タスクに必要なリファレンスだけを読みます。

   タスク	リファレンス
   レシピ、パラメーター、依存関係、キャッシュ、実行可能ファイルのチェック、エコー規則	references/recipes.md
   設定、dotenv、リスト、モジュール	references/settings.md
   式、関数、定数	references/syntax.md
   シェルまたはスクリプトのレシピ、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 workflow ready を記載し、変更した項目が複数ある場合は簡潔なレシピ／エイリアス／目的の表を添えます。また、### 🧪 Verification に正確なコマンドと結果を記載します。確認プロンプト、レシピのデータ出力、コンパイラーの出力、just --list の出力には装飾を付けないでください。リポジトリ独自の見出し用語を維持します。