Composer命令找不到的根源是PATH未正确配置：Linux/macOS需将composer.phar移至/usr/local/bin/composer并赋执行权限，Windows需手动添加C:\ProgramData\ComposerSetup\bin到系统Path；全局命令如laravel还需将%APPDATA%\Composer\vendor\bin（Windows）或~/.composer/vendor/bin（Linux/macOS）加入对应PATH并重载终端。
composer 命令本身找不到？先看它在不在 PATH 里
“command not found: composer” 不是 Composer 没装好，而是 shell 根本没找到那个可执行文件。系统只在 $PATH 列表里的目录中查找命令。
Linux/macOS 下最稳的方式是把 composer.phar 放到 /usr/local/bin/composer，然后确认该路径在 $PATH 中：
- 下载
composer.phar后运行：sudo mv composer.phar /usr/local/bin/composer - 加执行权限：
sudo chmod +x /usr/local/bin/composer - 检查是否生效：
which composer应输出/usr/local/bin/composer
macOS 若用 Homebrew 安装，brew install composer 会自动处理路径，不用手动干预。
Windows 用户别信安装器默认勾选的 “Add to PATH”，装完必须新开一个 PowerShell 或 CMD 窗口再试；旧窗口的 $env:PATH 不会自动刷新。
全局安装的工具（如 laravel、phpunit）调不了？vendor/bin 没进 PATH
composer global require laravel/installer 成功后敲 laravel --version 报错，99% 是因为 ~/.composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows）没加入 PATH。
必须手动添加并重载环境：
- Linux/macOS：在
~/.zshrc或~/.bashrc末尾加一行：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc - Windows（PowerShell）：
$env:PATH += ";$env:APPDATA\Composer\vendor\bin"（仅当前会话）；永久设置请用系统属性 → 环境变量 → 用户变量 → 编辑Path，新增%APPDATA%\Composer\vendor\bin
验证方法：echo $PATH | grep composer（Linux/macOS）或 echo %PATH%（Windows），看到对应路径才算成功。再试 which laravel 或 where laravel。
改了 COMPOSER_HOME，为什么全局命令还是不加载？
设了 COMPOSER_HOME="/opt/my-composer" 后，composer global list 能看到包，但 laravel 仍报 “command not found”，说明你只改了配置和缓存位置，没把新路径下的 vendor/bin 加进 PATH。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
COMPOSER_HOME 控制的是全局配置、插件和缓存位置，而全局命令实际放在 $COMPOSER_HOME/vendor/bin/。这个目录必须显式加入 PATH，不能靠默认值。
例如设了 COMPOSER_HOME="/opt/my-composer"，就得把 /opt/my-composer/vendor/bin 加进 PATH，而不是原来的 ~/.composer/vendor/bin。
常见错误：只改了 COMPOSER_HOME，却忘了同步更新 PATH —— 这会导致 composer global require 装的包存在，但 shell 根本找不到它们的二进制文件。
vendor 目录改了，autoload 和 bin 命令全挂了？路径硬编码没动
用 "config": {"vendor-dir": "third-party"} 改了项目级 vendor 位置后，require 'vendor/autoload.php' 报错、phpunit 找不到，不是配置失效，是你代码和脚本里写死了 vendor。
必须同步改三处：
- PHP 代码里所有
require 'vendor/autoload.php'→ 改成require 'third-party/autoload.php' - shell 脚本或 CI 配置中所有
vendor/bin/phpunit→ 改成third-party/bin/phpunit - IDE（如 PHPStorm）需手动在 Settings → PHP → Include Paths 中添加
third-party，否则无法跳转和补全
注意：config.bin-dir 也要配，否则 third-party/bin/ 下不会生成符号链接。正确写法：
"config": {
"vendor-dir": "third-party",
"bin-dir": "third-party/bin"
}
改完必须删掉旧 vendor 目录，再跑 composer install —— dump-autoload 不会重建目录结构或符号链接。
