Flex是recipe驱动的配置文件写入器，仅在composer require/remove时触发，且只对symfony/recipes中收录的稳定版包生效；未生成config/packages/xxx.yaml的主因是recipe未匹配，需检查composer recipes列表、allow-contrib设置、版本是否为stable，并用-v参数验证日志中是否有[Symfony\Flex\Recipe]标记。
Flex 不是自动配置工具，而是 recipe 驱动的配置文件写入器——它只在 composer require 或 composer remove 时触发，且仅对已收录 recipe 的稳定版包生效。
为什么 composer require 后没生成 config/packages/xxx.yaml？
最常见原因不是 Flex 失效，而是 recipe 根本没匹配上。Flex 不会“猜”你要什么配置，它只查 symfony/recipes 或 symfony/recipes-contrib 里有没有对应包+版本的目录。
- 运行
composer recipes看列表里有没有目标包（比如doctrine/doctrine-bundle），状态是不是✅ inst - 检查是否禁用了 contrib recipe：
composer config extra.symfony.allow-contrib返回false就得重开：composer config extra.symfony.allow-contrib true - 确认安装的是稳定版：
composer require doctrine/doctrine-bundle:^2.10@stable，加@stable强制跳过-dev或-beta版本（recipe 默认不生效） - 直接去 symfony/recipes 搜包名，看是否存在对应路径（如
doctrine/doctrine-bundle/2.10）
配置写了但 php bin/console debug:config xxx 报错或不生效？
Flex 写完文件只是第一步，后续还有环境判断、缓存编译、bundle 注册三道关卡。常见表现是文件明明存在，但容器里看不到服务或参数。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 检查
config/bundles.php是否真有该 bundle 的注册行（Flex 通常会追加，但手动删过或用了--no-scripts就不会） - 清缓存要指定环境：
php bin/console cache:clear --env=prod，否则 dev 环境的缓存清理不影响 prod - 看配置文件里有没有
when@dev或when@prod块，再核对当前APP_ENV值（echo $APP_ENV或php -r "var_dump($_SERVER['APP_ENV'] ?? 'not set');"） - 最彻底的验证方式：删掉
var/cache/整个目录，再跑命令
如何调试 Flex 到底有没有执行 recipe？
别靠猜，用 -v 看真实日志。Flex 的介入会在输出里留下明确标记。
- 运行
composer require doctrine/doctrine-bundle -v - 搜索输出中是否有类似
[Symfony\Flex\Recipe] Installing doctrine/doctrine-bundle (2.10.0)的行 - 如果没有，说明 Flex 没接管——此时再检查
composer show symfony/flex是否已安装，以及composer.json里有没有"type": "project" - 也可手动触发 recipe 列表刷新：
composer recipes:install doctrine/doctrine-bundle --force（需 Flex 1.21+）
多个 recipe 同时改 config/packages/framework.yaml 会冲突吗？
会，而且 Flex 不做合并，只按安装顺序覆盖。后装的 recipe 完全替换前一个写入的内容，没有 diff 或提示。
- 典型场景：先装
symfony/mailer，再装symfony/notifier，两者都往framework.yaml写mailer:和notifier:块——后者可能把前者整个顶掉 - 解决办法只有两个：要么手动合并，要么在装第二个前，把第一个已写入的配置块备份出来，装完再粘回去
- recipe 作者可通过
manifest.json中的merge字段声明合并策略，但绝大多数官方 recipe 并未启用，实际仍是覆盖行为
Flex 的自动化边界很清晰：它不读你的业务代码，不分析 YAML 语义，也不维护配置历史。一旦你手动改过 Flex 生成的文件，下次 composer recipes:update 就可能失败或跳过——这时候就得自己决定是保留修改，还是接受新 recipe 覆盖。
