Composer插件必须由主进程在install/update时加载，需满足type为"composer-plugin"、实现PluginInterface、extra.class正确指向且可自动加载；仅全局安装或项目根目录require才生效，require后须运行install/update。
Composer 插件不会因为 composer require 就自动生效——它必须被 Composer 主进程在 install 或 update 阶段加载并实例化，而这个过程依赖严格的配置、类型声明和生命周期时机。
插件不生效？先确认是不是真插件
很多包被误认为是插件，其实只是普通库或命令行工具。真正能干预 Composer 行为的插件，必须同时满足以下条件：
-
composer.json中明确声明"type": "composer-plugin" - 实现
Composer\Plugin\PluginInterface（注意命名空间和接口全名，拼错一个字母就静默失败） -
extra.class字段存在且指向可自动加载的完整类名，如"Acme\MyPlugin\Installer"，不能是短名或相对路径 - 该类在
autoload（通常是psr-4）中正确映射，否则 Composer 根本找不到它
验证方式：运行 composer show vendor/package，检查输出里是否包含 types : composer-plugin。没有？那它不是插件，只是个普通依赖。
全局安装 vs 项目内 require，哪个才对？
绝大多数 Composer 插件（比如 hirak/prestissimo、dealerdirect/phpcodesniffer-composer-installer）必须全局安装，否则根本不会被扫描到。
- 全局安装：用
composer global require vendor/plugin，确保~/.composer可写，且该目录在 Composer 的 autoloader 路径中 - 项目内安装：仅适用于通过
pathrepository 显式引入的本地插件，且必须在根项目的composer.json中声明为require或require-dev，不能只放在被安装的包里 -
composer require vendor/plugin后不执行composer install或composer update vendor/plugin，插件类永远不会注册
常见假象：执行 composer global require 后马上跑 composer install，却没看到任何日志——这不是插件没运行，而是它压根没被 Composer 扫描到。用 file_put_contents('/tmp/plugin-activated', 'yes') 在 activate() 里打点，再执行 composer -V 验证，才是唯一靠谱的检测方式。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
插件装了但命令不出现？检查 getCommands() 和继承关系
插件生效 ≠ 命令注册成功。自定义命令需要额外契约：
- 插件类必须实现
getCommands()方法，并返回Composer\Command\Command实例数组 - 每个命令类必须继承
Composer\Command\BaseCommand（或兼容基类），不能只是普通类 - 运行
composer list查看命令是否列出；没出现，说明插件虽加载成功，但未暴露命令 - 某些插件需在根项目
composer.json的extra字段中手动启用，比如"my-plugin": {"enabled": true}，否则getCommands()可能直接返回空数组
别在事件回调里 throw 异常来“中断流程”——这会让整个 composer install 报红退出，用户只看到堆栈，看不到你的提示信息。
本地开发调试时，改了代码却没反应？缓存和重载是关键
Composer 不会自动检测插件文件变更，改完代码不重建 autoload，旧版本仍驻留在内存中：
- 删掉
vendor/composer/autoload_psr4.php和vendor/composer/autoload_classmap.php，强制重建 autoloader - 执行
composer dump-autoload -o确保新类路径生效 - 必须重新运行
composer install（不是require），否则 Composer 仍使用缓存的旧实例 - 如果插件修改了安装路径（如
type: theme），还需composer clear-cache并删掉vendor/和composer.lock后重装，否则 Composer 会复用已缓存的路径信息
最易被忽略的一点：插件类构造函数如果有依赖（比如 IOInterface 以外的参数），而这些依赖在 Composer 初始化阶段尚未解析，就会静默失败——无报错、无日志、不触发 activate()。调试时优先检查构造函数是否干净。
