用途:指导 TYPO3 Core 贡献工作流,从账号配置到补丁提交。适用于分析 TYPO3 Forge 问题(如 https://forge.typo3.org/issues/105737)、提交补丁、修复 TYPO3 Bug、处理 Gerrit 评审流程、rebase 与 CI 失败,以及贡献核心文档。
主要能力与流程:
- 前置检查:运行 scripts/verify-prerequisites.sh,确认 TYPO3.org 账号、Gerrit SSH 与 Git 配置(邮箱须与 Gerrit 一致)。
- 环境搭建:账号配置后执行 scripts/setup-typo3-coredev.sh。
- 分支:git checkout -b feature/105737-fix-description。
- 深度分析问题:明确损坏行为与预期行为、追溯根因、记录最小复现步骤、确认受影响版本(main、13.4、12.4)、审阅相关测试与实现、考虑边界情况。
- 开发:实现并编写测试,用 typo3-conformance-skill 校验。
- CI 验证:本地运行 ./Build/Scripts/runTests.sh -s unit && ./Build/Scripts/runTests.sh -s functional,检查代码风格 ./Build/Scripts/cglFixMyCommit.sh,运行 PHPStan ./Build/Scripts/runTests.sh -s phpstan;推送后等待 Gerrit CI 全部作业完成,阅读实际日志定位失败,一次性修复全部问题再标记就绪。
- 提交:git push origin HEAD:refs/for/main(初始为 WIP);修改用 amend 加 push,须保留 Change-Id。
- 获批后验证目标分支:检查 Releases 行(如 main, 13.4, 12.4),逐分支 cherry-pick 并验证,避免版本差异导致回移失败。
提交信息格式:[TYPE] 主题行(祈使句,不超过 52 字符),正文说明 how 与 why,包含 Resolves: #12345 与 Releases: main, 13.4, 12.4。类型包括 [BUGFIX]、[FEATURE]、[TASK]、[DOCS]、[SECURITY]、[!!!]。
相关技能:typo3-ddev-skill(开发环境)、typo3-testing-skill(测试编写)、typo3-conformance-skill(代码质量校验)。
限制:资料未提供官方支持范围、收费或平台信息;具体脚本参数与 CI 配置细节以项目实际仓库为准。