woocommerce-dev-cycle

WooCommerce 開発サイクル

このスキルでは、テストの実行、コード品質チェック、トラブルシューティングなど、WooCommerce の開発ワークフローについて説明します。

手順

WooCommerce の開発ワークフローでは、次のガイドラインに従ってください。

1. テストの実行：running-tests.md で、PHP および JavaScript のテストコマンド、テスト環境のセットアップ、トラブルシューティングを確認します
2. コード品質：code-quality.md で、リンティング、コードスタイルの修正、依存関係を変更する際のロックファイルの手順を確認します
3. PHP のリンティングパターン：php-linting-patterns.md で、よくある PHP のリンティング問題とその修正方法を確認します
4. JS/TS の i18n パターン：js-i18n-patterns.md で、翻訳可能な文字列のパターンとプレースホルダーの使い方を確認します
5. Markdown のリンティング：markdown-linting.md で、Markdown ファイルのリンティングとフォーマットを確認します

開発ワークフロー

標準的な開発ワークフローは次のとおりです。

1. コードを変更します
2. 関連するテストを実行します：pnpm run test:php:env -- --filter YourTestClass
3. リンティングを実行します：pnpm --filter=@woocommerce/plugin-woocommerce lint:changes:branch（PHP と JS が対象です。このコマンドは CI の Lint ジョブで実行されます。未追跡ファイルはスキップされるため、新しいファイルは先に git add してください。trunk を対象としない PR の場合は、取得したベースブランチ（例：origin/release/X.Y）を末尾に追加してください）
4. 問題を修正します：PHP の場合は pnpm --filter=@woocommerce/plugin-woocommerce lint:php:fix を実行します。JS にはブランチ用の修正コマンドがないため、手動で修正してください（code-quality.md を参照）
5. テストが通ってから変更をコミットします

主な原則

• 機能を検証するため、変更後は必ずテストを実行します
• 開発中は、関連するテストを実行するために具体的なテストフィルターを使用します
• 現在のブランチのコードに対するリンティングエラーのみを修正します
• テストが失敗すると、期待値と実際の値を示す詳細な出力が表示されます
• テスト環境では、WordPress／WooCommerce のセットアップが自動的に行われます