SuperAPI AI 工具集

php-modernization

通用与其它

查看项目

更新于 10-16 01:35

技能介绍

用途:在现代化 PHP 代码时使用,覆盖 PHP 8.1-8.5 特性、PSR/PHP-FIG/PER-CS 合规,以及 PHPStan、Rector、PHP-CS-Fixer、PHPat 等工具链,并处理 DTO、枚举、readonly、属性钩子等改造。

主要能力:提供发现、检查与批量改造流程。发现可用 uv run ${CLAUDE_SKILL_DIR}/scripts/introspect.py(轻量)或 verify_php_project.py --summary(完整,含 agent_actions[]);逐项排查用 --check PM-XX;应用改造用 uv run ${CLAUDE_SKILL_DIR}/scripts/modernize_loop.py --mode dry-run,先审阅记录再应用。参考资料按需加载,不预加载,涵盖 PHP 8.0-8.3 基线、8.4、8.5、PSR/PER-CS、PHPStan 配置、静态分析工具、PHP-CS-Fixer 弃用、类型安全、请求 DTO、适配器注册表、多版本兼容、Symfony 模式、PSR-15 中间件、Doctrine 边界、API Platform、不可变性、契约与不变量、变异测试、跨版本词法分析、迁移策略、公共 API 清单、PHPUnit 12→13、多智能体调度风险、安全读取 PHP 配置等。

使用方式与限制:硬性护栏包括:不得对 Doctrine 实体或映射父类应用 readonly;Rector 必须加 --dry-run,且直接调用 vendor/bin/rector;提升 PHPStan 级别前须重新生成并提交 baseline,只缩小不删除;不得未经确认对 mock 目标或扩展点加 final;不得编辑 @generated 文件及 var/cache/、vendor/、node_modules/、.Build/ 下文件;共享树中不得对范围外文件执行 git checkout --,改用 git stash / git diff;vendor 变更后先 rm -rf /tmp/phpstan-* var/cache/phpstan;不得批量把 createMock 替换为 createStub。迁移清单涉及 declare(strict_types=1)、@PER-CS、PHPStan ≥9、PHPat、返回与参数类型、DTO 替代数组、backed 枚举替代常量、PSR 接口类型提示、#[Override]、#[SensitiveParameter]、typed constants、readonly 仅用于 DTO/VO/事件、属性钩子、array_find/any/all、管道 |>、PHPUnit 12+ 的 stub/mock 用法、Rector withComposerBased(symfony: true) 等。具体脚本参数与完整细节以官方资料为准,暂未提供更多收费、平台或效果信息。