用途:面向在 tasks.py 或 tasks/ 包中新增、重命名、审查 invoke 任务的人,给出命名与接线的约定,并说明相关风险。
主要能力:提出三条命名规则——任务名以动词开头(如 apt.install-base);已有 CLI 惯例名(status、list、version、check、diff)优先保留;setup、verify、clean、deploy、test 这类命名空间本身即动作,叶子名表示范围(如 verify.all)。同时要求同一含义固定用一个动词,避免近义词混用;若 docstring 已以动词开头,该动词通常就是任务名。
使用方式:按上述规则确定 inv <namespace>.<task> 的读法;审查已有仓库可用 inv --list | grep -oP '^ [a-z0-9.-]+' 列出全部任务,再对照模块源码分类为合规、惯例、动作命名空间或违规。重命名需同步修改 Python 函数名、phase 列表或 pre= 引用、文档、CI、Dockerfile 等外部引用,并建议一次改干净而非保留别名。
适用场景:任务命名评审、重命名改写、仓库规范审计。
限制:资料未提供具体版本要求、安装命令或收费信息。资料指出 invoke 任务不得运行等待键入输入的内容,pty=True 无法解决 Python 3.14 下 stdin 无法转发导致的挂起;被导入的任务会被 Collection.from_module 再次发布,需显式声明模块级命名空间;命名空间只有在接线后才会存在。