using-mise-tasks

What problem does it solve?

mise タスク機能の使い方。以下のいずれかに当てはまる作業では必ずこのスキルを参照する — モデルが学習データで混同しがちな mise 固有の構文を避けるため:

• mise run でのタスク実行（引数・フラグの渡し方。-- は -q/-v/-h/--help などの予約フラグ pass-through 専用）
• mise.toml の [tasks.*] の読み書き（run、depends、depends_post、usage、sources、outputs、tools、dir、raw）
• ファイルタスク (.mise/tasks/、mise-tasks/、.config/mise/tasks/ 等) の作成・編集（shebang、実行権限、#MISE / #USAGE ディレクティブ）
• monorepo タスク — experimental_monorepo_root、//path:task 絶対指定、//packages/...:* のパス×タスクワイルドカード、パッケージ間依存
• mise tasks --all --json などタスク調査コマンドの使い分け

対象外（別機能）: mise use/mise install などの tool・version 管理、shim 設定、top-level [env] セクション、mise.lock の運用、.mise.toml 以外の設定ファイル配置。

Using mise Tasks

mise のタスク機能を正しく使うためのガイドライン。ここでは、TOML タスクとファイルタスクの使い分け、モノリポ構成でのタスク参照、主要オプション、環境変数、引数定義の基本を解説します。

1. タスクの実行 mise run を使ってタスクを実行し、引数・フラグの渡し方や予約フラグのパススルーを理解します。TOML タスクとファイルタスクの定義方法、mise.toml / .config/mise/tasks/ の編集手順を学びます。

2. Monorepo タスク monorepoRoot 設定と絶対パス／ワイルドカードの使い分け、他プロジェクトのタスク依存の指定方法を理解します。

3. 主要な設定オプション run、depends、depends_post、env、dir、sources、outputs、tools、usage、raw など、タスク定義の主要フィールドと動作を把握します。

4. 環境変数 mise 実行時の環境変数の使い方と参照方法を理解します。

5. 引数の定義 TOML タスクの usage 形式とファイルタスクの #USAGE ヘッダの取り扱いを学びます。

Quick Start

Ask to run a basic mise task with mise run and reference how to define either a TOML task or a file task in a monorepo.