post-root-package-install 是 Composer 在根包首次安装后触发的一次性事件，用于执行项目初始化操作，如生成 .env 文件、清理模板文件、提示用户下一步操作等，仅在使用 create-project 创建项目时运行一次，区别于每次安装都触发的 post-install-cmd，适合安全执行一次性设置，避免重复冲突。

post-root-package-install 是 Composer 在安装根项目包后触发的一个事件，它只在项目初始化阶段运行一次，主要用在项目模板或骨架（如框架安装器、项目脚手架）中，用于执行首次安装后的初始化操作。

适用于项目创建后的初始化任务

这个事件的特殊之处在于：它仅当当前正在安装的包是“根包”（即你 composer create-project 或 composer install 的目标项目本身）时才会触发。常见用途包括：

• 生成默认配置文件（如 .env 示例文件）
• 清理模板专用文件（如删除 install.php 或 README.template.md）
• 提示用户下一步操作（如显示“请运行 php artisan key:generate”）
• 初始化项目结构目录（如创建 storage/logs 目录）

比如 Laravel 或 Symfony 的项目模板，在使用 create-project 创建新应用后，会自动复制 .env 文件并提示设置密钥，这类逻辑就可以绑定到 post-root-package-install 事件上。

与其它事件的区别

这个事件不同于 post-install-cmd，后者每次运行 composer install 都会执行，而 post-root-package-install 只在根包首次安装时触发一次。因此它更安全，适合做一次性设置，避免重复执行造成冲突。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

例如在 composer.json 中这样定义：

"scripts": { "post-root-package-install": [ "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"" ] }

这段脚本确保新项目创建时自动生成 .env 文件，但后续执行 composer install 不会再运行。

基本上就这些 —— 它是个专为“新建项目后第一件事”设计的钩子，适合做引导性、初始化类的操作。不复杂但容易忽略。