typo3-conformance

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

在评估 TYPO3 扩展质量、一致性检查、标准合规性、v12/v13/v14 现代化、TER 准备情况或最佳实践审查时使用。还会触发：扩展审核、质量评分、全面评估、修复所有问题、一致性审核、Bootstrap 5 迁移、CSP 合规性、ViewHelper 安全性、XLIFF 卫生。

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

目录结构

当前层级: 根目录

📁 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.6 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
- 📄 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.0 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 26.0 KB
📄 SKILL.md 4.2 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."
---

# TYPO3 Extension Conformance Checker

Evaluate TYPO3 extensions for standards compliance, architecture, and best practices.

## When to Use

- Assessing extension quality before production deployment
- Generating conformance reports for code review
- Planning modernization to TYPO3 v12/v13/v14 standards
- Validating TER publishing readiness

## Skill Delegation

- **Testing**: Delegate to `typo3-testing` skill
- **Documentation**: Delegate to `typo3-docs` skill
- **OpenSSF Scorecard**: Delegate to `enterprise-readiness` skill

## Evaluation Workflow

### Step 0: Understand Extension Context (always first)

Before checking files, understand: purpose, target TYPO3/PHP version, extension type (plugin, module, site package, library), criticality, and codebase scope.

### Steps 1-9: Conformance Checks

1. **Initial Assessment** -- Extension key, target TYPO3 version, extension type
2. **File Structure** -- composer.json, ext_emconf.php, required directories
3. **Coding Standards** -- strict_types, type declarations, PSR-12
4. **Prohibited Patterns** -- No `$GLOBALS` access, no `GeneralUtility::makeInstance()` for services
5. **PHP Architecture** -- Constructor DI, Services.yaml, PSR-14 events
6. **Backend Modules** -- ES6 modules, Modal API, CSRF protection (v13+)
7. **Testing** -- PHPUnit setup, Playwright E2E, coverage >70%
8. **Best Practices** -- DDEV setup, runTests.sh, quality tools, CI/CD
9. **TER Publishing** -- Workflow, upload comment format, CI compatibility

### Step 10: Verification Loop

After fixes, re-run checks. Document score improvement (e.g., "58 -> 82"). Ensure no regressions.

## Scoring System

**Base Score (0-100):** Architecture (20) + Guidelines (20) + PHP Patterns (20) + Testing (20) + Best Practices (20). Excellence bonus up to 22 additional points.

| Score Range | Interpretation | Action |
|------------|----------------|--------|
| 90-100+ | Excellent | Ready for production and TER |
| 80-89 | Good | Minor improvements recommended |
| 70-79 | Acceptable | Address before major releases |
| 50-69 | Needs Work | Significant improvements required |
| Below 50 | Critical | Block deployment until resolved |

**Critical issues** (security, data loss, core incompatibility) block deployment regardless of score.

## Running Checks

```bash
# Full conformance check
scripts/check-conformance.sh /path/to/extension

# Individual checks
scripts/check-file-structure.sh /path/to/extension
scripts/check-coding-standards.sh /path/to/extension
scripts/check-architecture.sh /path/to/extension
scripts/check-testing.sh /path/to/extension
scripts/check-phpstan-baseline.sh /path/to/extension
scripts/generate-report.sh /path/to/extension
```

## References

Guidance for each evaluation area:

- `references/extension-architecture.md` -- Directory structure, required files
- `references/coding-guidelines.md` -- PSR-12, naming conventions, TYPO3 style
- `references/php-architecture.md` -- DI, services, events, Extbase, middleware
- `references/testing-standards.md` -- PHPUnit and Playwright requirements
- `references/composer-validation.md` -- composer.json validation rules
- `references/ext-emconf-validation.md` -- TER requirements, field specs
- `references/version-requirements.md` -- TYPO3/PHP compatibility matrix
- `references/dual-version-compatibility.md` -- v12+v13 patterns
- `references/v13-deprecations.md` -- Deprecated APIs and migration paths
- `references/backend-module-v13.md` -- ES6, Modal API, accessibility
- `references/ter-publishing.md` -- TER publication requirements
- `references/report-template.md` -- Standard report structure
- `references/excellence-indicators.md` -- Bonus scoring criteria
- `references/best-practices.md` -- Tea extension organizational patterns

### Asset Templates

Quality tool configs in `assets/Build/`: PHPStan, PHP-CS-Fixer, Rector, ESLint, Stylelint, TypoScript lint.

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

typo3-conformance

目录结构

SKILL.md

举报内容

提示