autoload配置错误会严重拖慢加载速度，关键在于路径精准、命名空间规范、classmap仅用于稳定类，且需验证是否真正生效。
composer.json里autoload配置写错，比不优化还慢
很多项目在composer.json里堆了一堆看似“为优化准备”的 autoload 条目，结果反而拖垮加载速度。根本问题不在要不要加--optimize-autoloader，而在于 autoload 本身是否干净、精准。
- 删掉所有无用路径：比如
"docs/": ["docs/"]、"tests/": ["tests/"]、"legacy/": ["legacy/"]——这些会让 Composer 白扫几百个文件，生成巨大但几乎不用的autoload_classmap.php - 合并重叠的 PSR-4 前缀：
"AppHttpControllers": "app/Http/Controllers/"和"AppHttpMiddleware": "app/Http/Middleware/"应合并为"AppHttp": "app/Http/"，减少匹配轮次 - 命名空间末尾必须带反斜杠：
"App": "app/"✅，"App": "app/"❌（后者会被忽略，导致类找不到却查不出原因） - 避免通配前缀：
"": "src/"或"MyLib*": "src/"不合法，Composer 会静默跳过，或触发全目录扫描
classmap字段不是“开了-o就自动扫”，必须显式声明
"optimize-autoloader": true 写在 composer.json 里纯属摆设，它不触发任何动作；真正决定 classmap 是否生成、扫哪些路径的，是 autoload.classmap 字段本身的内容。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 路径末尾必须带
/才递归扫描："app/Exceptions/"✅，"app/Exceptions"❌（只会报 warning，不扫子目录） - 只扫你明确信任的稳定路径：比如
"app/Contracts/"、"common/"，别把src/或app/整个塞进去——现代框架类大多走 PSR-4，classmap 只适合放接口、异常、DTO 等少量高频、结构稳定的类 - 如果
autoload.classmap是空数组或未定义，哪怕加了--optimize-autoloader --classmap-authoritative，生成的autoload_classmap.php也一定是空的
optimize-autoloader + classmap-authoritative 组合的真实代价
这个组合常被当成“终极加速方案”，但它不是更快，而是更严格——一旦 classmap 漏类，直接 Class not found，且错误不提示漏在哪，只报最终失败。
- 漏类常见原因：
AppConsoleCommandsDeployCommand.php的命名空间写成namespace AppConsoleCommands;（缺反斜杠），导致扫描失败 - 动态类名完全不进 classmap：
$class = 'App\Jobs\' . $type; new $class();这类逻辑在开启--classmap-authoritative后必然失败 - 全局函数文件（
"files": ["app/Helpers/functions.php"]）不会被 classmap 收录，但它们仍能加载——别误以为开了 -a 就“所有 autoload 都走 classmap” - 测试类若没隔离进
autoload-dev，又没加--no-dev，它们会被扫进主 classmap，文件体积暴涨 2–5 MB，PHP-FPM 每次请求都要反序列化整个数组
验证 classmap 是否真生效，别信文件大小
看到 vendor/composer/autoload_classmap.php 有几千行，不代表它在运行时被用了。关键看两点：
- 执行
php -d display_errors=1 -r "require 'vendor/autoload.php'; var_dump(class_exists('AppHttpControllersHomeController'));"，返回true且无 warning —— 说明走了 classmap 分支 - 用
strace -e trace=stat,openat php -r "require 'vendor/autoload.php'; new AppHttpControllersHomeController();"，如果没出现大量stat("/path/to/app/Http/Controllers/HomeController.php") = -1，说明没 fallback 查找 - 检查
vendor/composer/autoload_static.php是否存在且非空——Composer 2 默认优先用它，比 classmap 更轻；而autoload_classmap.php在 OPcache 下难缓存，体积大反而拖慢冷启动
composer.json 里的 autoload 块。 
