mcpField
R
roots-ecosystem

roots-ecosystem

github.com/aitormendez開発1340 回インストール28 週間前に更新
リポジトリ

roots-ecosystem について

Roots Ecosystemは、RootsベースのWordPressプロジェクトに取り組む開発者向けのナビゲーションスキルです。作業に応じて参照資料や実装プレイブックを絞り込み、スタック全体を一度に読み込まずに済みます。

主な機能

  1. 01作業に応じたサブシステム資料の案内
  2. 02必要に応じた実装プレイブックの読み込み
  3. 03Bedrock、Sage、Acorn、Trellisの役割整理
  4. 04情報源の優先順位とカバー範囲の案内
  5. 05Rootsパッケージの実装パターン

活用シーン

  1. 01Bedrockプロジェクトの設定
  2. 02Sageテンプレートやコンポーネントの作成
  3. 03Acornプロバイダーやルートの実装
  4. 04Trellisデプロイワークフローの設定

インストール

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

$npx skills add https://github.com/aitormendez/roots-ecosystem-skill --skill roots-ecosystem

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

同梱ファイル

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

references/
acorn-extensions.md
acorn-package-patterns.md
acorn.md
bedrock.md
ecosystem-map.md
integration-patterns.md
package-acorn-ai.md
package-acorn-fse-helper.md
package-acorn-llms-txt.md
package-acorn-mail.md
package-acorn-post-types.md
package-acorn-prettify.md
package-acorn-user-roles.md
package-setup-trellis-cli.md
package-support.md
package-trellis-cli.md
package-wordpress-full.md
package-wordpress-packager.md
package-wp-config.md
packaging-and-distribution.md
playbook-acorn-package-authoring.md
playbook-acorn-service-providers-and-blade.md
playbook-bedrock-setup.md
playbook-roots-project-bootstrap.md
playbook-sage-components-and-composers.md
playbook-trellis-deploy-and-build.md
playbook-trellis-github-actions.md
sage.md
source-coverage.md
source-priority.md

詳細

Roots エコシステム

概要

このスキルを使うと、スタック全体をコンテキストに読み込まずに Roots プロジェクトを把握できます。まず最も関連性の高い小さなリファレンスから確認し、ユーザーが実際の変更を実装またはデバッグする場合にのみ、タスク用プレイブックを1つ読み込みます。

クイックスタート

  1. ユーザーが作業しているレイヤーを特定します。

    • Bedrock プロジェクトのセットアップ、.env、Composer、config/application.php、web/app/、mu-plugins -> references/bedrock.md を読みます
    • Sage テンプレート、Blade、コンポーネント、コンポーザー、app/、resources/views/、Vite、エディターアセット -> references/sage.md を読みます
    • Acorn の起動、サービスプロバイダー、ルート、WP-CLI、テーマテンプレート外での Blade レンダリング -> references/acorn.md を読みます
    • Trellis のプロビジョニング、デプロイ、フック、trellis CLI、デプロイ時の Sage ビルド手順 -> references/trellis.md を読みます
    • WordPress パッケージの配布、WP Packages、roots/wordpress-full、roots/wordpress-packager、roots/wp-config、非公開プラグインのワークフロー、Composer パッチ -> references/packaging-and-distribution.md を読みます
    • Trellis CLI、roots/setup-trellis-cli、GitHub Actions によるデプロイ、Roots 共通のサポートヘルパー -> references/tooling-and-ci.md を読みます
    • mail、user roles、post types、prettify、FSE helper、llms.txt、AI などの Acorn 拡張パッケージ -> references/acorn-extensions.md を読みます
    • コアではない Roots パッケージの詳細を確認する場合は、上記の該当パッケージのインデックスから始め、リンク先の package-*.md 詳細ファイルを読みます
    • スタック全体にまたがる所有権やアーキテクチャ -> references/integration-patterns.md を読みます
    • Roots パッケージの再利用可能なプロバイダー、設定、コマンド、ビューのパターン -> references/acorn-package-patterns.md を読みます
    • ソースの網羅範囲、このスキルに含まれる内容、完成度に関する質問 -> references/source-coverage.md を読みます
    • ガイダンスが矛盾する場合や、どの情報を優先すべきか判断できない場合 -> references/source-priority.md を読みます
    • エコシステム全体の概要 -> references/ecosystem-map.md を読みます

  2. ユーザーが実装を進めている場合は、サブシステムのリファレンスを確認した後、プレイブックを1つだけ読み込みます。

  3. すべてのリファレンスを最初から読み込むのは避けてください。このスキルは段階的な情報開示を前提に設計されています。

ワークフロー

  1. 一般的な WordPress や Laravel のアドバイスではなく、Roots 固有の情報源から始めます。
  2. エコシステムの網羅性や情報源の追跡可能性について質問された場合は、references/source-coverage.md を読み込みます。
  3. 競合を解決する必要がある場合は、references/source-priority.md を読み込みます。
  4. ユーザーの主なタスクに基づいて、サブシステムのリファレンスを 1 つ読み込みます。
  5. 実装に関するタスクの場合は、プレイブックを 1 つ読み込みます。
  6. Acorn が意図的に Laravel の動作を踏襲している場合に限り、Laravel のドキュメントを使用します。該当するのは、プロバイダー、ルーティング、ミドルウェア、コントローラー、パッケージ構成、Blade 構文などです。
  7. ワークフローには最新の Roots ドキュメントを、具体的な構成や例には最新の Roots リポジトリコードを優先します。

ナビゲーションマップ

ガードレール

  • これを汎用的な WordPress スキルとして扱わないでください。
  • Acorn のドキュメントまたはコードで確認できない限り、Laravel の動作が適用されると想定しないでください。
  • すべてのデプロイで Trellis をデフォルトで推奨しないでください。プロジェクトがすでに Trellis ベースである場合、またはセルフホスト型の Roots インフラストラクチャがスタックに含まれる場合に使用してください。
  • Roots のすべてのリポジトリに専用の詳細リファレンスファイルが必要だと想定しないでください。そのパッケージに固有の運用上の動作がない限り、パッケージ固有の詳細は共有リファレンスにまとめてください。
  • 理由なくレイヤー間で責務を移動しないでください。
    • Bedrock はプロジェクト構成と設定の初期化を担当します。
    • Sage はテーマの実装と、テーマに関する Blade／Vite の規約を担当します。
    • Acorn は Laravel 風のアプリケーションコンテナーとアプリケーションの抽象化を担当します。
    • Trellis はプロビジョニングとデプロイのオーケストレーションを担当します。

リクエスト例

  • 「Composer 管理のプラグインを追加して、ステージング用に Bedrock の設定を更新してください。」
  • 「Sage の Blade コンポーネントを作成し、コンポーザーでビューのデータをバインドしてください。」
  • 「カスタムテーマで Acorn を起動し、サービスプロバイダーを登録してください。」
  • 「Acorn を利用するプロジェクトで、カスタムブロックを Blade でレンダリングしてください。」
  • 「Sage のアセットビルドを Trellis のデプロイフックに接続してください。」
  • 「GitHub Actions を使った Trellis デプロイを設定してください。」
  • 「roots/wordpress-full、WP Packages、Bedrock の関係を説明してください。」
  • 「既存の Acorn プロジェクトに acorn-mail または acorn-prettify を追加してください。」
  • 「このスキルが実際に対象とする Roots のリポジトリと、その情報の場所を示してください。」
  • 「Bedrock、Sage、Acorn、Trellis が 1 つのプロジェクトでどのように連携するかを説明してください。」

コメント

Markdown 対応