mise タスク オーケストレーション

<!-- ADR: 2025-12-08-mise-tasks-skill -->

mise [tasks] セクションを使用して、依存関係管理、引数処理、ファイル追跡を備えた複数ステップのプロジェクトワークフローをオーケストレーションします。

自己進化スキル: このスキルは使用を通じて改善されます。指示が間違っている場合、パラメータがドリフトしている場合、または回避策が必要だった場合は、このファイルをすぐに修正してください。延期しないでください。実際に再現可能な問題のみ更新してください。

このスキルを使用する場合

明示的なトリガー:

• ユーザーが mise tasks、mise run、[tasks] セクションに言及している
• ユーザーがタスク依存関係を必要としている: depends、depends_post
• ユーザーが .mise.toml でワークフロー自動化を望んでいる
• ユーザーがタスク引数または usage 仕様に言及している

AI 発見トリガー (規範的):

mise-configuration スキルが複数ステップワークフロー (テストスイート、ビルドパイプライン、マイグレーション) を検出した場合、規範的にこのスキルを呼び出して適切な [tasks] 定義を生成します。

クイックリファレンス

タスク定義

[tasks.build]
description = "Build the project"
run = "cargo build --release"

タスク実行

mise run build          # Run single task
mise run test build     # Run multiple tasks
mise run test ::: build # Run in parallel
mise r build            # Short form

依存関係の種類

種類	構文	用途
depends	depends = ["lint", "test"]	タスク実行前に実行
depends_post	depends_post = ["notify"]	タスク成功後に実行
wait_for	wait_for = ["db"]	実行中の場合のみ待機

主要なタスク プロパティ

プロパティ	用途	例
description	AI エージェント発見性 (重要)	"Run pytest with coverage. Exits non-zero on failure."
alias	短い名前	alias = "t"
dir	作業ディレクトリ	dir = "packages/frontend"
env	タスク固有の環境変数 (依存関係には渡されない)	env = { LOG_LEVEL = "debug" }
hide	mise tasks 出力から非表示	hide = true
sources	キャッシング用のファイル追跡	sources = ["src/**/*.rs"]
outputs	ソースより新しい場合はスキップ	outputs = ["target/release/myapp"]
confirm	実行前にプロンプト表示	confirm = "Delete all data?"
quiet	mise 出力を抑制	quiet = true
silent	すべての出力を抑制	silent = true
raw	直接の標準入出力 (並列化を無効化)	raw = true
tools	タスク固有のツールバージョン	tools = { python = "3.9" }
shell	カスタムシェル	shell = "pwsh -c"
usage	引数仕様 (Tera より推奨)	Task Arguments を参照

ネーミング

mise run 'test:*'      # All tasks starting with test:
mise run 'db:**'       # Nested: db:migrate:up, db:seed:test
mise tasks --hidden    # View hidden tasks (prefixed with _)

すべてのレベルの詳細な例とパターンについては、Task Levels Reference を参照してください。

---

レベル 10: モノレポ (実験的)

要件: MISE_EXPERIMENTAL=1 と experimental_monorepo_root = true

mise run //projects/frontend:build    # Absolute from root
mise run :build                       # Current config_root
mise run //...:test                   # All projects
mise run '//projects/...:build'       # Build all under projects/

サブディレクトリのタスクは自動発見され、パス プレフィックス付き (packages/api/.mise.toml のタスクは packages/api:taskname になります)。

完全なモノレポドキュメンテーションについては、advanced.md を参照してください。

---

レベル 11: Pants + mise を使用したポリグロット モノレポ

Python 中心のポリグロット モノレポ (10～50 パッケージ) の場合、mise をランタイム管理用に、Pants をビルド オーケストレーションおよびネイティブ影響検出用に組み合わせます。

ツール	責務
mise	ランタイム バージョン (Python、Node、Rust) + 環境変数
Pants	ビルド オーケストレーション + ネイティブ影響検出 + 依存関係推論

# Native affected detection (no manual git scripts)
pants --changed-since=origin/main test
pants --changed-since=origin/main lint
pants --changed-since=origin/main package

スケール	推奨
10 パッケージ未満	mise + カスタム affected (レベル 10 パターン)
10～50 パッケージ (Python 中心)	Pants + mise (このセクション)
50+ パッケージ	Bazel を検討

完全な Pants + mise 統合ガイドおよびツール比較については、polyglot-affected.md を参照してください。

---

[env] との統合

タスクは自動的に [env] 値を継承します。外部環境ファイルには _.file を使用し、シークレットには redact = true を使用してください。

[env]
DATABASE_URL = "postgresql://localhost/mydb"
_.file = { path = ".env.secrets", redact = true }

[tasks._check-env]
hide = true
run = '[ -n "$API_KEY" ] || { echo "Missing API_KEY"; exit 1; }'

[tasks.deploy]
depends = ["_check-env"]
run = "deploy.sh"  # $DATABASE_URL and $API_KEY available

完全な環境統合パターンについては、Environment Integration を参照してください。

---

アンチパターン

アンチパターン	問題点	代わりに
/itp:go を mise tasks で置き換える	TodoWrite なし、ADR 追跡なし、チェックポイントなし	mise tasks をプロジェクトワークフロー用に、/itp:go を ADR 駆動開発用に使用する
タスクにシークレットをハードコード	セキュリティリスク	_.file = ".env.secrets" を redact = true で使用する
巨大なモノリシック タスク	デバッグが難しく、再利用不可	依存関係を持つ小さなタスクに分割する
description をスキップまたは最小化	AI エージェントは名前からタスク目的を推測できない	リッチな説明を記述する: 実行内容、要件、出力、実行時期
ビルド depends なしで公開	DAG 予防の代わりに実行時エラー	公開タスクに depends = ["build"] を追加する
すべてのフェーズを含まないオーケストレータ	"次に X を実行" メッセージが無視される	すべてのフェーズを release:full depends 配列に含める

リリース固有のアンチパターンとパターンについては、Release Workflow Patterns を参照してください。

---

クロスリファレンス: mise-configuration

前提条件: タスクを定義する前に、[env] セクションが設定されていることを確認してください。

規範的: タスクを定義した後、mise-configuration スキル を呼び出して、[env] SSoT パターンが適用されていることを確認します。

mise-configuration スキルは以下をカバーします:

• [env] - デフォルト値付き環境変数
• [settings] - mise 動作設定
• [tools] - バージョン固定
• 特別なディレクティブ: _.file、_.path、_.python.venv

---

追加リソース

• Task Levels Reference - レベル 1～9: 基本的なタスク、依存関係、非表示タスク、引数、ファイル追跡、高度な実行、ウォッチ モード
• Task Patterns - 実際のタスク例
• Task Arguments - 完全な usage 仕様リファレンス
• Advanced Features - モノレポ、ウォッチ、実験的機能
• Environment Integration - [env] 継承と認証情報ロード
• Polyglot Affected - Pants + mise 統合ガイドおよびツール比較
• Bootstrap Monorepo - 自律型ポリグロット モノレポ ブートストラップ メタプロンプト
• Release Workflow Patterns - リリース タスク DAG パターン、ビルド前公開強制

---

トラブルシューティング

問題	原因	ソリューション
タスクが見つからない	タイポまたは誤った mise.toml	mise tasks を実行して利用可能なタスクを一覧表示
依存関係が実行されない	循環依存	タスク depends 配列でサイクルをチェック
ソースが機能しない	誤った glob パターン	mise.toml の場所から相対パスを使用
ウォッチがトリガーされない	ソースリスト外のファイル	ファイルパターンを sources 配列に追加
環境変数が利用できない	タスクが誤ったディレクトリにある	mise.toml が cwd またはその親にあることを確認
エラーで実行に失敗	スクリプト パスの問題	絶対パスまたは mise.toml からの相対パスを使用

実行後の反省

このスキルが完了した後、閉じる前にチェックしてください:

1. コマンドは成功しましたか? — そうでない場合は、失敗を引き起こした指示またはエラー テーブルを修正してください。
2. パラメータまたは出力が変更されましたか? — 基盤となるツールのインターフェースがドリフトしている場合は、使用例とパラメータ テーブルを更新して一致させてください。
3. 回避策が必要でしたか? — 即座に対応した場合 (異なるフラグ、追加ステップ)、このスキルを更新して、次の呼び出しで同じ回避策が必要にならないようにしてください。

実際に再現可能な問題の場合のみ更新してください — 推測的ではなく。