用途:mise 文件任务(file tasks)是放在 mise-tasks/ 或 .mise/tasks/ 等目录中的独立脚本,可像完整 CLI 命令一样运行,适合逻辑较长、需要参数、依赖或 monorepo 组织的任务。
主要能力:支持参数解析、自动生成帮助、依赖管理,可用 bash、node、python、ruby 等语言编写。脚本头部用注释指令声明元数据,如 #MISE description、#MISE depends、#MISE dir、#MISE env;参数用 #USAGE 指令定义 flag、option、arg,解析结果以 usage_ 前缀注入环境变量(如 --dry-run 对应 usage_dry_run,--env 对应 usage_env)。
使用方式:将脚本放入 ./mise-tasks/(推荐)、./.mise/tasks/ 或 mise.toml 中 [tasks] 配置的目录;脚本需包含 shebang。monorepo 需在根 mise.toml 启用 experimental_monorepo_root = true,任务可用绝对(mise run //packages/frontend:build)、相对(mise run :build)或通配(mise run //packages/*:test)方式寻址,子项目继承父级工具与环境变量。调试可用 mise tasks ls 检查发现与解析,用 mise run taskname --help 查看生成的帮助。
限制与注意:自动补全需安装 usage CLI(mise use -g usage);usage_ 前缀必须保留,flag 中的连字符会转为下划线;注意 #MISE depends 的循环依赖;通过 mise run 运行时文件不强制需要 chmod +x,但建议加上。monorepo 功能标注为实验性。