typo3-conformance

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

在评估 TYPO3 扩展质量、一致性检查、标准合规性、v12/v13/v14 现代化、TER 准备情况或最佳实践审查时使用。还会触发：扩展审核、质量评分、全面评估、修复所有问题、一致性审核、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 46.8 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
- 📄 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 17.6 KB
- 📄 testing-standards.md 6.5 KB
- 📄 v13-deprecations.md 10.5 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 53.8 KB
📄 SKILL.md 4.0 KB

SKILL.md

---
name: typo3-conformance
description: "Use when assessing TYPO3 extension quality, conformance checking, standards compliance, modernization to v12/v13/v14, TER readiness, or best practices review. Also triggers on: extension audit, quality score, full assessment, fix all findings, conformance audit, Bootstrap 5 migration, CSP compliance, ViewHelper security, XLIFF hygiene, PHP 8.4/8.5 compat."
metadata:
  version: "2.10.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

- Assessing extension quality or TER readiness
- Generating scored conformance reports
- Planning modernization to v12/v13/v14

## Delegation

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

## Workflow

### Step 0: Context

Read ext_emconf.php + composer.json to determine TYPO3/PHP version, extension type, scope.

### Steps 1-10: 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

### Step 11: Verify

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

## Quick Grep Recipes

```bash
# Missing strict_types
grep -rL 'strict_types' Classes/ --include='*.php'
# Prohibited $GLOBALS
grep -rn '\$GLOBALS' Classes/ --include='*.php'
# makeInstance for services
grep -rn 'GeneralUtility::makeInstance' Classes/ --include='*.php'
# PHP 8.4 implicit nullable (deprecated)
grep -rPn '\(\s*[A-Za-z\\]+\s+\$\w+\s*=\s*null' Classes/ --include='*.php' | grep -v '?'
# Cache has()+get() anti-pattern
grep -rn '->has(' Classes/ --include='*.php'
# ext_emconf must NOT have strict_types
grep -l 'strict_types' ext_emconf.php
# PHP 8.5 implicit float-to-int (deprecated)
grep -rn '(int)\s*\$' Classes/ --include='*.php'
# Bootstrap 4 data attributes in Fluid
grep -rn 'data-toggle\|data-dismiss\|data-ride' Resources/ --include='*.html'
```

## 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

- `references/extension-architecture.md` -- Structure, required files
- `references/coding-guidelines.md` -- PSR-12, naming, PHPStan
- `references/php-architecture.md` -- DI, events, middleware
- `references/testing-standards.md` -- PHPUnit/Playwright
- `references/composer-validation.md` -- composer.json rules
- `references/ext-emconf-validation.md` -- TER fields
- `references/version-requirements.md` -- TYPO3/PHP compat
- `references/dual-version-compatibility.md` -- v12+v13
- `references/multi-version-dependency-compatibility.md` -- Adapter pattern
- `references/v13-deprecations.md` -- Migration paths
- `references/backend-module-v13.md` -- ES6, Modal, a11y
- `references/ter-publishing.md` -- TER workflow
- `references/report-template.md` -- Report format
- `references/excellence-indicators.md` -- Bonus scoring
- `references/best-practices.md` -- Organizational patterns

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

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

typo3-conformance

目录结构

SKILL.md

举报内容

提示