必须通过 composer 插件机制实现：声明插件类型与主类，实现 commandproviderinterface 返回命令实例，命令类继承 basecommand 并重写 configure/execute，同时确保 autoload 正确覆盖命令类路径。
如何让 composer 命令自动触发环境检测逻辑
Composer 本身不支持直接注册自定义命令，必须通过插件（composer-plugin）+ CommandProviderInterface 实现。官方不提供“写个脚本就能注册命令”的快捷路径，硬要绕开插件机制，结果只会是命令无法被识别或执行时抛出 Command "xxx" is not defined.。
核心步骤只有三步：
- 在插件的
composer.json中声明"type": "composer-plugin"和"extra": {"class": "Your\Plugin"} - 插件主类实现
ComposerPluginCommandProviderInterface，返回自定义命令实例数组 - 每个命令类继承
ComposerConsoleCommandBaseCommand，重写configure()和execute()
别漏掉 require 里加 "composer-plugin-api": "^2.9"，否则 Composer 2.9+ 会拒绝加载插件。
为什么你的自定义命令总报 Class 'xxx' not found
常见原因是自动加载没覆盖到命令类——Composer 插件加载时，只自动加载插件自身命名空间（由 autoload.psr-4 定义），但默认不会加载你放在 src/Command/ 下的命令类。
解决方案只有两个，且必须选其一：
- 把命令类和插件主类放同一命名空间下，比如都用
Your\Plugin\，并确保composer.json的autoload.psr-4映射正确指向源码目录 - 在插件
activate()方法里手动 require 命令文件：require_once __DIR__ . '/src/Command/EnvCheckCommand.php';（不推荐，破坏 PSR-4 一致性）
运行 composer dump-autoload 后再试，别跳过这步——插件类和命令类都依赖 autoload 映射生效。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
环境检测命令该读哪些配置、查哪些实际状态
企业内部诊断不能只靠 php -v 或 phpinfo()，得结合项目上下文。典型检查项包括：
-
$_SERVER['DOCUMENT_ROOT']是否存在且可写（对部署环境敏感） - 检查
extension_loaded('opcache')+ini_get('opcache.enable')双重确认 - 读取项目根目录下的
.env，验证APP_ENV是否为prod/dev，并比对config/app.php中的实际配置 - 调用
exec('which node')或proc_open()检查前端构建工具链是否就位（若项目含 Vue/React）
注意：所有 exec 类操作必须加 @ 抑制警告，并用 is_executable() 预判权限，否则在容器或受限主机上会直接 crash。
如何避免诊断命令干扰 CI/CD 流程
CI 环境通常禁用交互、限制超时、屏蔽输出，而你的 env:check 命令如果默认输出彩色表格或等待用户输入，就会卡住 pipeline。
必须做三件事：
- 在
configure()中显式调用$this->addOption('quiet', 'q', InputOption::VALUE_NONE, 'Suppress output') - 执行阶段用
$input->getOption('quiet')分流：静默模式只 return exit code（0=通过，1=警告，2=错误） - 避免使用
$io->ask()或任何阻塞式 IO；如有必要交互，加if (!$input->isInteractive()) { throw new RuntimeException('Not in interactive mode'); }
CI 脚本里应始终带 --quiet 运行，比如 composer env:check --quiet || exit 1 —— 否则 exit code 不稳定，GitLab CI 或 GitHub Actions 就没法准确判断失败。
真正难的不是写命令，而是让命令在 dev、staging、prod、CI 四种环境里行为一致又各有所需。比如 prod 环境要严格校验 opcache，CI 环境却要跳过磁盘写入检查。这些分支逻辑一旦散落在 execute() 里，很快就会变成维护噩梦。
