mcpField
T
typo3-core-contributions

typo3-core-contributions

github.com/dirnbauer開発3364 回インストール13 週間前に更新
リポジトリ

typo3-core-contributions について

typo3-core-contributionsは、TYPO3 Coreに貢献する開発者向けのスキルです。Forgeの課題分析からGerritへの投稿、CIの調査、レビュー後の更新までを案内します。

主な機能

  1. 01Forge課題の分析と作成
  2. 02Gerritへのパッチ投稿手順
  3. 03コミット形式とGit操作
  4. 04CIログの調査とローカルチェック
  5. 05レビュー対応とパッチセット更新

活用シーン

  1. 01TYPO3 Coreのパッチを準備して投稿
  2. 02TYPO3 CIジョブの失敗を調査
  3. 03Gerritレビュー後にコミットを修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dirnbauer/webconsulting-skills --skill typo3-core-contributions

インストール後、Claude Code で/typo3-core-contributionsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
account-setup.md
commit-message-format.md
commit-msg-hook.md
ddev-setup-workflow.md
forge-api.md
gerrit-review-patterns.md
gerrit-workflow.md
modern-typo3-patterns.md
troubleshooting.md
scripts/
create-commit-message.py
create-forge-issue.sh
query-forge-metadata.sh
setup-typo3-coredev.sh
validate-commit-message.py
verify-prerequisites.sh

詳細

TYPO3 Core への貢献

TYPO3 Core への貢献に関するガイドです。Forge の課題、Gerrit のパッチ、CI のデバッグ、レビューのワークフローについて説明します。

使用する場面

  • Forge の課題の分析または作成（forge.typo3.org/issues/*）
  • パッチの提出、CI のデバッグ、Gerrit のレビューのワークフロー
  • コミットメッセージの書式設定、チェリーピック、リベース

前提条件

${CLAUDE_SKILL_DIR}/scripts/verify-prerequisites.sh を実行して、TYPO3.org アカウント、Gerrit SSH（ssh -p 29418 <user>@review.typo3.org）、Gerrit に登録したものと一致する Git のメールアドレスを確認します。詳しくは references/account-setup.md を参照してください。

ワークフロー

  1. セットアップ：アカウントと環境（${CLAUDE_SKILL_DIR}/scripts/setup-typo3-coredev.sh、references/ddev-setup-workflow.md）
  2. ブランチ：git checkout -b feature/<issue>-description
  3. 分析：コーディングを始める前に、根本原因、再現手順、影響を受けるバージョンを把握します
  4. 開発：修正とテストを実装し、typo3-conformance-skill で検証します
  5. コミット：以下の書式に従い、Resolves: #<issue> と Releases: を含めます
  6. プッシュ：git push origin HEAD:refs/for/main（最初は WIP として開始します）
  7. CI：すべてのジョブが完了するまで待ちます。GitLab の実際のログを git.typo3.org/typo3/CI/cms/-/jobs/<id> で確認します。すべての失敗を修正し、1 回の amend+push で反映します
  8. レビュー可能にする：git push origin HEAD:refs/for/main%ready または Gerrit UI の「Start Review」でレビュー可能にします
  9. レビュー：フィードバックに対応してコミットを amend し、Change-Id を維持します。レビュアーによるメッセージの編集を保持するため、先にレビュアーのパッチセットを取得します：git fetch origin refs/changes/XX/NNNNN/N && git reset --soft FETCH_HEAD
  10. 更新：git commit --amend && git push origin HEAD:refs/for/main

コミットの書式

[TYPE] Subject (imperative mood, max 52 chars)

How and why (not what). Wrap at 72 chars.

Resolves: #12345
Releases: main, 13.4, 12.4

種別：[BUGFIX]、[FEATURE]（main のみ）、[TASK]、[DOCS]、[SECURITY] 破壊的変更：[!!!][TYPE] を先頭に付け、Releases: main のみ 必須：すべてのコミットに Resolves: が必要です（Related: だけでは不可）

CI のデバッグ

失敗したジョブのログをすべて確認します（推測で判断しないでください）。よくあるジョブは cgl pre-merge（コードスタイル）、phpstan（静的解析）、unit／functional（テスト）です。すべてを 1 つのパッチセットで修正します。ローカルでのチェック：

./Build/Scripts/runTests.sh -s unit && ./Build/Scripts/runTests.sh -s functional
./Build/Scripts/cglFixMyCommit.sh
./Build/Scripts/runTests.sh -s phpstan

主な操作

タスクコマンド
Gerrit にプッシュgit push origin HEAD:refs/for/main
レビュー可能にするgit push origin HEAD:refs/for/main%ready
WIP に設定git push origin HEAD:refs/for/main%wip
リベースgit fetch origin && git rebase origin/main
パッチをチェリーピックgit fetch origin refs/changes/XX/NNNNN/N && git cherry-pick FETCH_HEAD
フックをインストールcp Build/git-hooks/commit-msg .git/hooks/ && chmod +x .git/hooks/commit-msg
メールアドレスの不一致を修正GIT_COMMITTER_EMAIL="registered@email" git commit --amend --no-edit
Forge API${CLAUDE_SKILL_DIR}/scripts/create-forge-issue.sh、references/forge-api.md

参考資料

トピックファイル
アカウントのセットアップreferences/account-setup.md
コミットの書式references/commit-message-format.md
Gerrit のワークフローreferences/gerrit-workflow.md
レビューパターンreferences/gerrit-review-patterns.md
モダンなパターンreferences/modern-typo3-patterns.md
DDEV のセットアップreferences/ddev-setup-workflow.md
Forge APIreferences/forge-api.md
コミットフックreferences/commit-msg-hook.md
トラブルシューティングreferences/troubleshooting.md

クレジットと帰属表示

このスキルは、 Netresearch DTT GmbH による優れた取り組みを基にしています。

元のリポジトリ：https://github.com/netresearch/typo3-core-contributions-skill

Copyright (c) Netresearch DTT GmbH — 手法とベストプラクティス（MIT / CC-BY-SA-4.0）

このスキルコレクションの形成に貢献した、TYPO3 コミュニティへの寛大なオープンソースの貢献について、Netresearch DTT GmbH に心より感謝します。 このスキルコレクション向けに webconsulting.at が改変

コメント

Markdown 対応