Composer不支持冒号命名空间命令，如composer my:command会报错；仅支持扁平化命令（如composer install）和composer run-script name调用scripts，可通过scripts前缀分组、Shell函数封装或独立CLI工具模拟命名空间效果。
Composer 本身不支持自定义命令命名空间——你不能像写 Laravel Artisan 命令那样，注册一个 app:serve 或 dev:sync 这类带冒号的、可被 composer app:serve 调用的“命名空间化命令”。
为什么 composer mynamespace:command 不生效
Composer 的命令系统是扁平结构：所有命令（包括第三方插件）都注册在顶级命令空间下，比如 composer install、composer dump-autoload。它没有内置的子命令解析器或命名空间路由机制。所谓 vendor/bin/composer 启动后，只认字面匹配的命令名，不拆解 : 分隔符做层级分发。
- 你写
"scripts": { "my:deploy": "..." }，运行的是composer run-script my:deploy，不是composer my:deploy - 第三方插件（如
hirak/prestissimo）注册的是composer global级命令，但仍是单层名，如composer global update，而非composer global:update - 任何尝试用
composer foo:bar直接调用的行为，都会报错Command "foo:bar" is not defined.
真正能模拟命名空间效果的三种方式
虽然不能原生支持冒号命名空间，但可通过组合手段达成近似体验，关键是选对场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
项目内脚本分组：用
scripts键 + 前缀统一管理，比如"scripts": { "dev:clear": "...", "dev:serve": "...", "prod:deploy": "..." }。运行时仍需composer run-script dev:clear，但语义清晰、团队可读性强 -
Shell 函数封装：在
~/.zshrc中定义comdev() { composer run-script "dev:$1"; }，之后就能用comdev clear。注意：这仅限本地终端，不进 Git，也不影响 CI -
独立 CLI 工具包：若逻辑复杂（如需参数解析、子命令、交互式流程），应剥离为单独的 PHP CLI 应用（如基于
symfony/console），发布为 Composer 包，通过bin自动软链。用户安装后直接运行mytool dev:clear，与 Composer 解耦
composer.json 里写 scripts 时容易踩的坑
很多人以为 scripts 是“别名”，其实它是 shell 命令执行器，行为严格受 shell 规则约束：
- 数组形式的 script（如
"refresh": ["@clear", "composer install"]）每项都新开一个 shell 进程，前一项失败不会中断后续项；加&&才能链式控制："refresh": "@clear && composer install" -
@xxx只能复用同文件中已定义的 script 名，不能跨文件、不能带路径，也不能用变量（如@dev:${ARG}不合法） - 脚本中若含空格或特殊字符（如
php -S "localhost:8000" -t public/），必须用双引号包裹整个命令字符串，否则 shell 解析出错 - Windows CMD 下
&&和|行为与 bash 不同，建议开发环境统一用 WSL 或 GitHub Actions 测试
最常被忽略的一点：Composer 的 scripts 本质是执行 shell 命令，不是 PHP 函数调用。它不感知你的命名空间、不加载 vendor/autoload.php，也不会自动帮你 use 类——所有依赖必须靠命令本身显式触发（比如先 php bin/mycli.php，而不是期望 composer my:cmd 直接跑 PHP 类方法）。
