roots-ecosystem

Roots 生态系统

概览

使用此技能导航 Roots 项目，无需将整个技术栈都加载到上下文中。从最小的相关参考文档开始；只有当用户要实现或调试实际更改时，才加载一本任务指南。

快速开始

1. 确定用户关注的层：

   • Bedrock 项目设置、.env、Composer、config/application.php、web/app/、mu-plugins -> 阅读 references/bedrock.md
   • Sage 模板、Blade、组件、composers、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
   • Acorn 扩展软件包，例如邮件、用户角色、文章类型、prettify、FSE helper、llms.txt 或 AI -> 阅读 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. 如果用户正在实现功能，请在子系统参考文档之后准确加载一本任务指南：

   • Bedrock 安装或配置更改 -> references/playbook-bedrock-setup.md
   • Sage 组件、composer、模板或视图工作 -> references/playbook-sage-components-and-composers.md
   • Acorn 提供者、路由、WP-CLI、软件包式扩展或自定义 Blade 渲染 -> references/playbook-acorn-service-providers-and-blade.md
   • Trellis 部署或构建钩子工作 -> references/playbook-trellis-deploy-and-build.md
   • 初始化或梳理完整的 Roots 项目技术栈 -> references/playbook-roots-project-bootstrap.md
   • 构建或提取可复用的 Acorn 软件包 -> references/playbook-acorn-package-authoring.md
   • 通过 GitHub Actions 部署 Trellis -> references/playbook-trellis-github-actions.md

3. 默认情况下避免加载所有参考文档。此技能专为渐进式披露而设计。

工作流

1. 从 Roots 专属资料入手，而不是通用 WordPress 或通用 Laravel 建议。
2. 当用户询问生态系统的完整性或资料溯源时，加载 references/source-coverage.md。
3. 需要解决冲突时，加载 references/source-priority.md。
4. 根据用户的主要任务加载一份子系统参考资料。
5. 如果任务涉及实现，则加载一份操作指南。
6. 仅在 Acorn 有意沿用 Laravel 行为的场景下使用 Laravel 文档，例如服务提供者、路由、中间件、控制器、软件包结构或 Blade 语法。
7. 工作流优先参考最新的 Roots 文档；具体结构和示例优先参考当前的 Roots 仓库代码。

导航地图

• references/source-priority.md：权威资料顺序与冲突解决
• references/source-coverage.md：此技能涵盖的资料及其深度
• references/ecosystem-map.md：整个技术栈一览
• references/bedrock.md：项目结构、配置模型、Composer、环境、mu-plugins
• references/sage.md：主题结构、Blade、组件、composers、Vite
• references/acorn.md：启动、服务提供者、路由、WP-CLI、Blade 渲染
• references/trellis.md：配置、部署、钩子、CLI
• references/packaging-and-distribution.md：WP Packages、WordPress 发行版、wp-config、私有插件、补丁
• references/tooling-and-ci.md：Trellis CLI、GitHub Actions 设置、共享 Roots 辅助工具
• references/acorn-extensions.md：Acorn 第一方软件包及其适用场景
• references/package-*.md：针对发行、工具和 Acorn 扩展软件包的逐包深入资料
• references/integration-patterns.md：各层之间的职责划分
• references/acorn-package-patterns.md：Roots 生态系统示例中的软件包实现模式

注意事项

• 不要将其视为通用 WordPress 技能。
• 除非 Acorn 文档或代码证实，否则不要假设 Laravel 的行为适用。
• 不要默认所有部署都推荐 Trellis；仅在项目已经基于 Trellis，或技术栈包含可自托管的 Roots 基础设施时使用。
• 不要假设每个 Roots 仓库都值得拥有单独的深入参考文件；除非某个软件包具有独特的运维行为，否则应将软件包专属细节放在共享参考资料中。
• 不要无故在各层之间转移职责：
  • Bedrock 负责项目结构和配置引导。
  • Sage 负责主题实现，以及面向主题的 Blade/Vite 约定。
  • Acorn 负责 Laravel 风格的应用容器和应用抽象。
  • Trellis 负责配置和部署编排。

请求示例

• “添加一个由 Composer 管理的插件，并更新 Bedrock 配置以用于预发布环境。”
• “构建一个 Sage Blade 组件，并使用 composer 绑定视图数据。”
• “在自定义主题中启动 Acorn，并注册一个服务提供者。”
• “在 Acorn 驱动的项目中使用 Blade 渲染自定义区块。”
• “将 Sage 资源构建接入 Trellis 部署钩子。”
• “通过 GitHub Actions 设置 Trellis 部署。”
• “解释 roots/wordpress-full、WP Packages 和 Bedrock 之间的关系。”
• “在现有 Acorn 项目中添加 acorn-mail 或 acorn-prettify。”
• “展示此技能实际涵盖哪些 Roots 仓库，以及相关资料的位置。”
• “解释 Bedrock、Sage、Acorn 和 Trellis 如何在一个项目中协同工作。”