typo3-conformance

分类: 测试与安全 | 上传者: netresearch | 下载: 0 | 版本: v1.0（最新）

在评估 TYPO3 扩展质量、一致性检查、标准合规性、v12/v13/v14 现代化（v14.3 LTS 是默认/黄金标准）、TER 准备情况或最佳实践审查时使用。还会触发：扩展审核、质量评分、全面评估、修复所有结果、一致性审核、Fluid 5 严格 ViewHelpers、ext_tables.php 删除、Extbase 属性（Authorize/RateLimit）、HashService 删除、Bootstrap 5 迁移、CSP 合规性、ViewHelper 安全、XLIFF 卫生、PHP 8.4/8.5 兼容。

更新日志: Source: GitHub https://github.com/netresearch/typo3-conformance-skill

目录结构

当前层级: tree/main/skills/typo3-conformance/

📁 assets/
- 📁 .github/
  - 📁 workflows/
    
    📄 publish-to-ter.yml 2.9 KB
- 📁 Build/
  - 📁 composer-unused/
    
    📄 composer-unused.php 1.1 KB
  - 📁 eslint/
    
    📄 .eslintrc.json 515 B
  - 📁 php-cs-fixer/
    
    📄 php-cs-fixer.php 1.0 KB
  - 📁 phpstan/
    
    📄 phpstan-baseline.neon 530 B
    
    📄 phpstan.neon 3.5 KB
  - 📁 rector/
    
    📄 rector.php 4.0 KB
  - 📁 stylelint/
    
    📄 .stylelintrc.json 367 B
  - 📁 typoscript-lint/
    
    📄 TypoScriptLint.yml 1.1 KB
📁 references/
- 📄 backend-module-v13.md 40.6 KB
- 📄 backend-wizard-patterns.md 19.5 KB
- 📄 best-practices.md 48.3 KB
- 📄 coding-guidelines.md 16.0 KB
- 📄 composer-validation.md 11.9 KB
- 📄 crowdin-integration.md 38.6 KB
- 📄 development-environment.md 13.2 KB
- 📄 directory-structure.md 17.0 KB
- 📄 dual-version-compatibility.md 3.9 KB
- 📄 excellence-indicators.md 22.6 KB
- 📄 ext-emconf-validation.md 15.7 KB
- 📄 ext-files-validation.md 11.3 KB
- 📄 extension-architecture.md 8.6 KB
- 📄 hooks-and-events.md 8.4 KB
- 📄 localization-coverage.md 7.3 KB
- 📄 multi-tier-configuration.md 10.6 KB
- 📄 multi-version-dependency-compatibility.md 6.9 KB
- 📄 php-architecture.md 36.8 KB
- 📄 report-template.md 4.5 KB
- 📄 runtests-validation.md 12.4 KB
- 📄 ter-publishing.md 18.1 KB
- 📄 testing-standards.md 6.5 KB
- 📄 v13-deprecations.md 10.5 KB
- 📄 v13-v14-dual-compatibility.md 10.1 KB
- 📄 v14-deprecations.md 17.4 KB
- 📄 version-requirements.md 4.9 KB
📁 scripts/
- 📄 check-architecture.sh 6.4 KB
- 📄 check-coding-standards.sh 3.9 KB
- 📄 check-conformance.sh 7.1 KB
- 📄 check-documentation.sh 2.5 KB
- 📄 check-file-structure.sh 5.7 KB
- 📄 check-phpstan-baseline.sh 3.5 KB
- 📄 check-testing.sh 6.1 KB
- 📄 generate-report.sh 6.4 KB
📄 checkpoints.yaml 55.4 KB
📄 SKILL.md 4.4 KB

SKILL.md

---
name: typo3-conformance
description: "Use when assessing TYPO3 extension quality, conformance checking, standards compliance, modernization to v12/v13/v14 (v14.3 LTS is the default/gold standard), TER readiness, or best practices review. Also triggers on: extension audit, quality score, full assessment, fix all findings, conformance audit, Fluid 5 strict ViewHelpers, ext_tables.php removal, Extbase attributes (Authorize/RateLimit), HashService removal, Bootstrap 5 migration, CSP compliance, ViewHelper security, XLIFF hygiene, PHP 8.4/8.5 compat."
metadata:
  version: "2.12.0"
  repository: https://github.com/netresearch/typo3-conformance-skill
  author: Netresearch DTT GmbH
---

# TYPO3 Extension Conformance Checker

Evaluate TYPO3 extensions against TYPO3 coding standards, architecture patterns, and best practices.

## When to Use

- Extension quality / TER readiness
- Scored conformance reports
- Modernization to v12/v13/v14 (**v14.3 LTS is default/gold standard**)

## Delegation

Testing -> `typo3-testing` | Docs -> `typo3-docs` | OpenSSF -> `enterprise-readiness`

## Workflow

### Step 0: Context

Read ext_emconf.php + composer.json for TYPO3/PHP version, type, scope.

### Steps 1-11: Checks

1. **Metadata** -- Extension key, TYPO3 version, type
2. **Structure** -- composer.json, ext_emconf.php, Classes/, Configuration/, Resources/
3. **Coding** -- strict_types, PSR-12, PHP 8.4 explicit nullable, PHP 8.5 float-to-int
4. **Prohibited** -- No `$GLOBALS`, no `GeneralUtility::makeInstance()` for services
5. **Architecture** -- Constructor DI, Services.yaml, PSR-14 events
6. **Backend** -- ES6 modules, Modal API, CSRF, CSP (v13+)
7. **Testing** -- PHPUnit, Playwright E2E, coverage >70%
8. **Practices** -- DDEV, runTests.sh, CI/CD, quality tools
9. **TER** -- Publish workflow, upload comment format
10. **Audit** -- PHPStan baseline, TCA searchFields/default_sortby, XLIFF completeness, cache has()+get() anti-pattern, Extbase query property names, multi-version adapters
11. **v14 readiness** -- no `ext_tables.php`/`HashService`/magic repo finders; Fluid VHs strict-typed; XLF 2-space. See `references/v14-deprecations.md`.

### Step 12: Verify

Re-run after fixes. Document score delta ("58 -> 82").

## Quick Grep Recipes

```bash
grep -rL 'strict_types' Classes/ --include='*.php'                   # missing strict_types
grep -rn '\$GLOBALS' Classes/ --include='*.php'                       # prohibited $GLOBALS
grep -rn 'GeneralUtility::makeInstance' Classes/ --include='*.php'    # makeInstance for services
grep -rPn '\(\s*[A-Za-z\\]+\s+\$\w+\s*=\s*null' Classes/ --include='*.php' | grep -v '?'  # PHP 8.4 implicit nullable
grep -rn '->has(' Classes/ --include='*.php'                          # cache has()+get() anti-pattern
grep -l 'strict_types' ext_emconf.php                                 # ext_emconf must NOT have strict_types
grep -rn '(int)\s*\$' Classes/ --include='*.php'                      # PHP 8.5 implicit float-to-int
grep -rn 'data-toggle\|data-dismiss\|data-ride' Resources/ --include='*.html'  # Bootstrap 4 in Fluid
grep -rn 'HashService\|GeneralUtility::hmac(\|->findBy[A-Z]\|->findOneBy[A-Z]\|->countBy[A-Z]' Classes/ --include='*.php'  # v14 removals
[ -f ext_tables.php ] && echo "WARN: ext_tables.php deprecated (#109438)"   # v14.3 deprecation
```

## Scoring

**Base (0-100):** Architecture(20) + Guidelines(20) + PHP(20) + Testing(20) + Practices(20). Excellence bonus up to 22. Critical issues block regardless.

| Range | Level | Action |
|-------|-------|--------|
| 90+ | Excellent | Production/TER ready |
| 80-89 | Good | Minor fixes |
| 70-79 | Acceptable | Fix before release |
| 50-69 | Needs Work | Significant effort |
| <50 | Critical | Block deployment |

## References

See `references/` for deep-dives:

- **Architecture & code:** `extension-architecture.md`, `php-architecture.md`, `coding-guidelines.md`, `best-practices.md`
- **Validation:** `composer-validation.md`, `ext-emconf-validation.md`, `version-requirements.md`, `testing-standards.md`
- **Multi-version:** `dual-version-compatibility.md` (v12+v13), `v13-v14-dual-compatibility.md` (v13+v14), `multi-version-dependency-compatibility.md`, `v13-deprecations.md`, `v14-deprecations.md`
- **Backend & publishing:** `backend-module-v13.md`, `ter-publishing.md`, `report-template.md`, `excellence-indicators.md`, `localization-coverage.md`

Asset templates in `assets/Build/`: PHPStan, PHP-CS-Fixer, Rector, ESLint, Stylelint, TypoScript lint.

登录后下载/点赞/收藏 ❤ 6 | ★ 0

typo3-conformance

目录结构

SKILL.md

举报内容

提示