post-update-cmd 是 Composer 在显式执行 composer update 时触发的脚本钩子，非自动响应 install 或 require；需正确定义在 composer.json 的 "scripts" 下，键名为 "post-update-cmd"，值为字符串或数组命令列表。
post-update-cmd 是什么，它真在“更新后”执行吗？
post-update-cmd 是 Composer 的一个脚本钩子，但它只在你显式运行 composer update 时触发，不会在 composer install 或 composer require（除非后者内部调用了 update）时自动跑。很多人以为只要装了包就走一遍，结果脚本静默失效。
常见错误现象：
- 在 CI 环境里用
composer install部署，但post-update-cmd完全没执行，静态资源没生成、缓存没清理 - 本地
composer update成功，但脚本报错退出，而你没注意到终端最后几行红字
它本质是「命令列表」，不是函数回调，所以顺序执行，任一命令失败（非零退出码），后续命令直接中断。
怎么写进 composer.json 才真正生效
必须把脚本定义在 "scripts" 字段下，且键名严格为 "post-update-cmd"（注意大小写和连字符）。值可以是字符串或数组：
"scripts": {
"post-update-cmd": [
"@php artisan clear-compiled",
"@php artisan optimize:clear",
"npm run build"
]
}
关键细节：
- 数组形式更安全，每条命令独立执行，失败不影响其他（前提是没加
&&） - 用
@php而不是php，能复用 Composer 自带的 PHP 解析器路径，避免环境 PHP 版本不一致导致的语法错误 - 命令里含空格或参数时，别漏引号；比如
"@php artisan config:cache --env=prod" - 不要写成
"post-update"或"postUpdateCmd"，Composer 不认
为什么本地能跑，CI 里却报 “command not found”
根本原因是执行上下文不同：本地有全局安装的 npm、php、artisan，而 CI 容器往往只有最小化环境。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
常见错误现象：
-
npm: command not found—— 容器没装 Node.js -
artisan: command not found——vendor/bin没进$PATH，或没生成可执行软链 -
PHP Parse error—— CI 用 PHP 7.4，但脚本里用了 8.0 的 match 表达式
实操建议：
- 优先用
vendor/bin/xxx路径调用二进制，比如"vendor/bin/phpunit --version" - Laravel 项目中，
artisan必须用php artisan显式调用，不能裸写artisan - CI 脚本里先确认工具存在：
which npm && npm --version || echo "npm missing" - 避免依赖 shell 别名或 .bashrc 设置，
post-update-cmd运行在非交互式 shell 下，那些配置压根不加载
想让它也响应 composer install 怎么办
Composer 没有 post-install-cmd 这个钩子（那是旧版 typo），正确名字是 post-install-cmd —— 等等，其实是 post-install-cmd，但注意：它只在首次 install 时触发，后续 composer install（已有 lock 文件）默认不执行任何脚本，除非加 --no-scripts 以外的明确开关。
所以更靠谱的做法是：
- 把共用逻辑抽成独立脚本，比如
scripts/deploy.sh - 在
post-update-cmd和post-install-cmd里都调用它："sh scripts/deploy.sh" - 或者统一用
post-autoload-dump—— 它在 autoloader 重建时必跑，install和update都会触发，适合清理缓存、生成代理类等与代码结构强相关的事
不过要注意：post-autoload-dump 不保证 vendor 已完全就位，别在里面直接 require vendor/autoload.php 或调用未安装的包命令。
有些事注定得手动补一刀，比如前端构建。别硬塞进 Composer 钩子里，该在 CI 的 deploy 步骤里单独写清楚。
