用途:评估 TYPO3 扩展是否符合 TYPO3 编码规范、架构模式与最佳实践,适用于扩展质量与 TER 就绪度检查、评分式一致性报告,以及向 v12/v13/v14(v14.3 LTS 为默认金标准)现代化。仅适用于扩展,站点/项目仓库(type: project + Compose)应使用金标准检查器 typo3-14-gold/tools/conformance。
主要能力:按 12 步工作流检查元数据(key、TYPO3 版本、type,以及 TER、docs.typo3.org、README、GitHub 上标题与描述一致)、结构(composer.json、ext_emconf.php、Classes/、Configuration/、Resources/)、编码(strict_types、PSR-12、PHP 8.4 显式可空、PHP 8.5 float-to-int)、禁用项(无 $GLOBALS、服务不用 GeneralUtility::makeInstance())、架构(构造器 DI、Services.yaml、PSR-14 事件、PSR-3 日志、工厂回退)、后端(ES6、Modal API、CSRF、v13+ CSP)、测试(PHPUnit、Playwright E2E、覆盖率 >70%)、实践(DDEV、runTests.sh、CI/CD)、TER 发布、审计(PHPStan baseline、TCA searchFields、XLIFF、cache has()+get()、查询属性、多版本适配器)与 v14 就绪度。评分基础 0-100:架构、指南、PHP、测试、实践各 20 分,卓越加分最多 22,关键问题直接阻断;90+ 优秀、80-89 良好、70-79 可接受、50-69 需改进、<50 严重。
使用方式:先读 ext_emconf.php 与 composer.json 获取版本、type、范围,再执行检查,修复后重跑并记录分数变化。提供快速 grep 配方,例如 grep -rL 'strict_types' Classes/ --include='.php'、grep -rn '$GLOBALS' Classes/ --include='.php'、grep -rn 'GeneralUtility::makeInstance' Classes/ --include='.php'、grep -rn '->has(' Classes/ --include='.php'、grep -l 'strict_types' ext_emconf.php、grep -rn 'HashService|GeneralUtility::hmac(|->findBy[A-Z]|->findOneBy[A-Z]|->countBy[A-Z]' Classes/ --include='*.php'、[ -f ext_tables.php ] && echo "WARN: ext_tables.php deprecated (#109438)"。
版本声明不一致时:先确定哪个文件正确,收集证据(仓库规则 AGENTS.md/CONTRIBUTING.md/README、CI 矩阵测试的版本、代码所需 API、git log -p -- composer.json ext_emconf.php),再对齐两个文件;只改版本声明及重复它们的文档,各文件用各自写法(composer.json 用 ^13.4,ext_emconf.php 用 13.4.0-13.4.99,ext_emconf.php 绝不用 caret)。若请求只是检查版本声明且已一致,说明范围与比较位置后停止,不添加未请求的观察。若请求是升级到新 TYPO3 版本,应交给 typo3-extension-upgrade,本技能只做现状审计。
限制:资料未提供具体安装命令、收费与价格信息;测试、文档、OpenSSF、发布/TER 分别委派给 typo3-testing、typo3-docs、enterprise-readiness、github-release。