GrumPHP安装后需四者对齐才能触发检查：Composer源同步、PHP≥7.4、git:init初始化钩子、grumphp.yml配置正确；报“Could not find package”主因是国内镜像未同步，应切官方源并确认PHP版本与--dev参数。
GrumPHP 不是装完就能用的“开箱即用”工具，它依赖 Composer 的安装路径、PHP 版本、Git 钩子注册状态和配置文件位置四者严格对齐；任一环节错位，git commit 就不会触发检查。
composer require --dev phpro/grumphp 为什么报 Could not find package
最常见原因是 Composer 源未同步最新包，尤其国内镜像（如阿里云）存在数小时延迟，而 phpro/grumphp 4.x 起已要求 PHP ≥ 7.4 且依赖新版 Symfony 组件，旧镜像常缺这些包。
- 临时切回官方源再试：
composer config -g repo.packagist composer https://packagist.org - 确认 PHP 版本：
php -v，必须 ≥ 7.4（推荐 8.0+） -
--dev参数不可省略——GrumPHP 是开发期工具，不是运行时依赖 - 装完别跳过初始化：
vendor/bin/grumphp git:init，否则.git/hooks/pre-commit不会生成
git commit 不触发 grumphp：hook 文件存在但不执行
Hook 存在 ≠ 能执行。Linux/macOS 下权限不对、Windows 下 Git Bash 环境变量缺失、或提交时加了 -n / --no-verify 都会导致静默跳过。
- 检查 hook 是否可执行：
ls -l .git/hooks/pre-commit，输出中应含x（如-rwxr-xr-x） - 若不可执行，手动修复：
chmod +x .git/hooks/pre-commit - Windows 用户建议用 WSL 或 PowerShell 执行
vendor/bin/grumphp git:init，Git Bash 常因$PATH缺失php而失败 - 日常提交务必用
git commit -m "xxx"，避免任何绕过 flag
grumphp.yml 配置写对了，task 却提示 “is not registered”
GrumPHP 本身不带任何检查能力，每个 task（如 phpcs、phpstan）都需单独安装对应 Composer 包，并在配置中显式启用——漏装、拼错名、缩进错层都会导致任务注册失败。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 先装工具：
composer require --dev squizlabs/php_codesniffer（对应phpcstask） - 配置文件必须叫
grumphp.yml（不是.yml或grumphp.yaml），且放在项目根目录 - 顶层键必须是
grumphp:（冒号不能少），tasks:必须缩进对齐，task 名全小写、无空格、无下划线（如phpcs，不是PHP_CodeSniffer） - 示例有效片段：
grumphp: tasks: phpcs: standard: PSR12 triggered_by: ['php']
非标准项目结构下 grumphp run 报错 “Cannot find composer.json”
GrumPHP 默认从当前工作目录向上查找 composer.json，若你的 composer.json 在 backend/ 子目录，或项目根目录不含该文件，就会失败。
- 启动时显式指定配置路径：
php ./vendor/bin/grumphp run --config=backend/grumphp.yml - 或设环境变量（CI 场景更稳）：
GRUMPHP_COMPOSER_DIR=backend php ./vendor/bin/grumphp run - 也可在
composer.json的extra.grumphp中硬编码路径："extra": { "grumphp": { "config-default-path": "backend/grumphp.yml", "project-path": "backend" } }
真正卡住人的往往不是某一步不会做，而是多个路径变量（GRUMPHP_COMPOSER_DIR、GRUMPHP_PROJECT_DIR、grumphp.yml 位置、Git 工作目录）之间互相影响，改一个就得全盘验证——建议每次只动一个变量，用 vendor/bin/grumphp -v run 看实际加载的路径和配置。
