用途:在 TYPO3 v14.x 代码库中编排可并行的大规模改动,把工作拆成 5–30 个互不冲突的独立单元,先向用户展示编号计划并获批,再逐单元执行与验证,最后汇总改动并列出失败项。
主要能力:Hook 到 PSR-14 事件迁移(含映射说明,如 drawHeaderHook/drawFooterHook → ModifyPageLayoutContentEvent,contentPostProc 各子钩子的对应关系,并指出 DataHandler 相关钩子无 1:1 事件);TCA 现代化(eval 转 required/nullable、renderType 转 type、items 数组转 label/value、清理 v14 自动生成列);GeneralUtility::makeInstance 转构造器注入;Fluid 模板重构(f:translate、f:link、f:image、Partial 抽取、无障碍属性);命名空间与扩展键重命名;ext_localconf/ext_tables 代码外移到 Configuration;测试与 CI 基础设施搭建;PHP 8.4 迁移(属性钩子、非对称可见性、array_find/array_any/array_all,并强调与 array_search、array_key_exists 语义不同);Content Blocks 迁移;本地化 XLIFF 批处理。
使用方式:按研究、分解、计划、执行、报告五步进行。每个单元须可独立验证,同一文件不得出现在两个单元中;PHP 改动后运行 composer normalize、php -l、PHPStan,可用时运行 vendor/bin/phpunit;每个单元单独提交并附描述性信息。计划以表格列出单元、文件数与风险等级,并询问是否继续。
限制:仅面向 TYPO3 v14.x。单元破坏测试、生成代码语法错误、两个单元意外需要同一文件或用户要求停止时须中止并报告。部分钩子无对应 PSR-14 事件,需改用 PSR-15 中间件或保留原钩子,迁移前须核对 Core 事件列表。前端渲染与后端表单需人工抽查确认。
该技能改编自 Boris Cherny(Anthropic)的 Claude Code /batch 技能,来源为 dirnbauer/webconsulting-skills。