编写 Composer 插件无需修改源码，只需实现 PluginInterface 和 EventSubscriberInterface 接口，通过 activate() 注入逻辑、getSubscribedEvents() 绑定事件，并可选实现 CommandProviderInterface 添加自定义命令；插件需设 type 为 composer-plugin，正确配置 autoload 和入口类。
编写 Composer 插件并不需要修改 Composer 源码，而是通过实现特定接口、注册事件监听器，在 Composer 的生命周期中注入自定义逻辑。核心在于理解 Composer 的插件机制和事件驱动模型。
了解 Composer 插件类型与入口点
Composer 支持两类插件：全局插件（安装在 COMPOSER_HOME）和项目级插件（作为依赖写在项目 composer.json 中）。无论哪种，都必须满足：
- 包的
type字段为composer-plugin - 在
composer.json中声明extra.plugin-class或通过自动发现机制指定主类 - 主类必须实现
Composer\Plugin\PluginInterface
创建基础插件类
新建一个类（例如 MyPlugin），实现两个必需方法：activate() 和 deactivate()。常用做法是在 activate() 中绑定命令或监听事件：
use Composer\Plugin\PluginInterface;
use Composer\IO\IOInterface;
use Composer\Composer;
use Composer\EventDispatcher\EventSubscriberInterface;
<p>class MyPlugin implements PluginInterface, EventSubscriberInterface
{
public function activate(Composer $composer, IOInterface $io)
{
// 可选：注册自定义命令（需同时实现 CommandProviderInterface）
// 可选：监听事件，如下
}</p><pre class="brush:php;toolbar:false;">public function deactivate(Composer $composer, IOInterface $io) {}
public static function getSubscribedEvents()
{
return [
'post-install-cmd' => 'onPostInstall',
'post-update-cmd' => 'onPostUpdate',
];
}
public function onPostInstall($event) { /* 自定义逻辑 */ }
public function onPostUpdate($event) { /* 自定义逻辑 */ }}
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
扩展命令或添加新命令
若想添加新 CLI 命令（如 composer hello），插件类还需实现 Composer\Command\CommandProviderInterface，并返回命令实例数组：
- 继承
Composer\Command\BaseCommand编写命令类 - 重写
configure()设置名称、描述、参数 - 重写
execute()实现业务逻辑（可访问$this->getComposer()和$this->getIO()） - 在插件的
getCommands()方法中返回该命令实例
发布与测试插件
本地开发时，用 path 仓库方式在测试项目中引入插件，避免反复发布：
// 测试项目的 composer.json
"repositories": [
{
"type": "path",
"url": "../my-composer-plugin"
}
],
"require-dev": {
"myvendor/my-composer-plugin": "*"
}运行 composer update 后，插件即生效。检查是否加载成功，可运行 composer list 查看新增命令，或加 -v 参数观察插件激活日志。
基本上就这些。不复杂但容易忽略的是命名空间自动加载配置和插件类的 PSR-4 映射——确保 composer.json 中的 autoload 正确指向你的插件类文件。
