wix-headless-fast

Wix Headless Fast

基于已交付、验证过的代码构建 Wix Headless 网站，而不是从头编写集成。 每个垂直领域都会随附集成代码本身——包括类型化数据层、钩子、组件、页面和种子脚本，均已确保正确。在能够运行这些代码的技术栈上（Wix 托管的 Astro、任何 React 项目），代码会被部署，Agent 的工作范围则缩小为品牌、布局、文案和接线。 在无法运行这些代码的技术栈上（没有打包器的静态网站、使用其他语言的服务器端渲染应用），同一份代码就是参考：其 REST 对应版本会部署到浏览器端，而它编码的规则就是 Agent 移植时要遵循的规则。无论哪种情况，决策都已体现在代码中；不要重新争论这些决策。

范围。 针对 Wix 托管的 Astro 进行了调整，每个垂直领域都只提供一种解决方案形态。只要需求没有与之冲突，就按原样使用。若需求需要这类方案形态无法表达的内容——或者网站建成后，工作转向管理或扩展网站——请使用 wix-docs 和 wix-manage，而不是在此处变通。

模型

• 已交付的代码就是实现。 每个垂直领域的所有内容都位于该技能仓库中的 templates/<vertical>/ 下，而非技能文件夹中：node <SKILL_ROOT>/install/templates.mjs 会一次性将全部内容拉取到 <SKILL_ROOT>/templates/（仅需几秒）并打印路径；下文的每个脚本都会在该文件夹缺失时自行拉取。该文件夹会留在项目中（只有组合生成的 project/ 脚手架不会纳入其仓库），因此后续会话读取的是项目构建时所用的版本。每个垂直领域都包含：
  • app/ — 与框架无关的核心（TypeScript）：一个返回纯粹、可序列化 DTO 的数据层（图片会解析为 https URL，价格会预先格式化）、React hooks，以及不含路由的无头组件。适用于 Astro islands、Vite SPA 和 Next。
  • app-astro/ — 轻量 Astro 覆盖层：通过核心获取数据的 SSR 页面，并将 DTO 传给 islands，其中预先配置了可由所有者编辑的商品页面 SEO。
  • seed/ — 构建时 REST 种子脚本（输入纯数据计划，输出创建的内容），以及对应的 SEED.md 契约。
  • INSTRUCTIONS.md — 该垂直领域的操作指南：文件映射、构建内容和硬性规则。
  • project/ — 将该垂直领域整合到 Wix CLI 的空白 Astro 脚手架中，并包含其锁文件：这是新建网站时 wix create 会复制的内容，因此首次安装该垂直领域时无需解析依赖。
• 统一的认证接缝。 所有已交付代码都通过 src/wix/sdk.ts 调用 Wix：在 Wix 托管的 Astro 上，认证信息会自动提供（无需客户端或 ID）；在其他任何 React 设置中，同一个文件会基于 src/wix/config.ts 中的公开客户端 ID 运行手动访客客户端。部署步骤会对此进行配置 — 无需手动接线。
• 数据照用，呈现由你负责。 数据层、hooks 和购物车界面都已接好，可直接使用 — 切勿重写其内部实现、通过 API 路由重新转发，或重新推导请求结构。如果需求涉及它们无法表达的内容，请阅读负责该功能的已交付文件，并通过 wix-docs 确认契约；切勿从生成的 SDK 类型、包文件或 node_modules 中自行推断。普通调用者有权执行的操作应放入新的数据层函数。特权操作应放入经过验证的服务端端点 — 参见 templates/shared/CUSTOM_OPERATIONS.md。不会随项目交付呈现层：垂直领域的 INSTRUCTIONS 会指出你需要自行设计和实现的界面，并使用已交付的 hooks；每个界面都附有承载其契约的骨架（对于店面：商店和 PDP 页面及其 islands，还有首页）。
• 绝不可依据训练数据或记忆来处理 Wix API。 URL、路径、版本、标头、字段名、筛选键或请求体都不例外。你发起或编写的每个 Wix 调用 — 无论在前端、种子脚本中，还是在构建时读取网站数据时 — 都必须来自此处已安装的官方 Wix 技能及其优先部署的代码，或者在它们未涵盖该调用时，来自通过 wix-docs 查阅的官方 Wix 文档。先在那里查阅，再编写调用。 每次请求前都要测试： 你在本次会话中运行的文件读取或文档搜索输出中，必须包含准确的路径和请求体，并且你必须从该输出中复制它们。其他任何内容都是记忆：输出在显示调用前被截断的文件、你记得以前读过的来源，或通过修改已找到调用的一部分而构造的调用。猜测的调用若返回 400 或无内容，并不代表更接近答案；这正是此规则要防止的失败。继续尝试其他变体仍然是在猜测，而未通过测试的调用返回空响应或错误，只能说明调用本身，不能说明网站。调用尚未确认时，应保留错误信息：不要使用 2>/dev/null，也不要使用 | echo。已交付代码经过真实网站测试；看起来相似的请求体可能什么也得不到，而且 API 很少会说明原因。
• 绝不模拟；失败时明确报错；通过 Wix 处理购买。 使用实时数据或如实呈现空状态；显示错误，不要吞掉错误；结账和购买始终通过 Wix 重定向会话完成。
• 可选功能依据计划部署。 垂直领域可以选择启用共享功能，无需复制敏感代码。对于普通文件上传，在计划中添加具名的 capabilities.mediaUpload.policies 条目；Fast 会一次性提供客户端辅助函数、Astro 端点、依赖项和生成的策略模块。选择此功能前，请阅读 templates/shared/CUSTOM_OPERATIONS.md。Agent 会将辅助函数接入商品界面；它绝不会自行编写或扩展端点。对于全站搜索（包含建议项的页眉搜索框，以及一个覆盖已部署垂直领域的商品、服务、文章和活动的 /search?q= 页面），添加 capabilities.siteSearch 条目；Fast 会一次性提供其数据层、stores、hooks、组件和搜索页面。启用此功能意味着种子步骤会在网站上安装 Wix Site Search 应用（install: true；在内容种子之后运行该功能的 seed/install.mjs）——安装后约半分钟内会填充索引。操作指南：templates/shared/capabilities/site-search/INSTRUCTIONS.md。

运行流程

全程需要：Node ≥ 20.11、git、已登录的 Wix CLI（npx @wix/cli@latest whoami； npx @wix/cli@latest login 使用设备代码流程：向用户显示 URL 和代码，绝不要将令牌 读入上下文），以及本技能旁边的两个配套技能 wix-docs 和 wix-manage（如果 .agents/skills/ 中缺少它们： CI=1 npx skills@latest add wix/skills --skill wix-docs --skill wix-manage --yes）。冷启动 页面 cold-start/cold-start.md 可让一台完全没有这些内容的机器达到该状态。在已经包含 wix.config.json 的文件夹中，先运行 node <SKILL_ROOT>/install/context.mjs：如果缺少 .env.local，它会运行 wix env pull，并打印项目的两个身份——部署站点（配置文件指向的 站点，wix release 会部署到这里）和内容站点（环境文件指定的站点，SDK 客户端以其应用 身份运行，且其控制面板用于管理业务）。除了 migration preview （guides/migration.md）之外，它们是同一个站点；在该预览中，环境文件指定的是正在迁移的 站点。这里的每个脚本都会读取此上下文；绝不会仅根据配置文件猜测调用的目标站点。然后 获取一次随附代码：node <SKILL_ROOT>/install/templates.mjs。它会打印文件夹路径； 下文的 templates/… 路径均相对于 <SKILL_ROOT>，文件会放在那里。 node <SKILL_ROOT>/install/check.mjs 会告知技能或其模板是否有较新版本，并打印更新命令； 它不会更改任何内容。

整个运行期间：如果用户要求向 Wix 发送反馈、表达不满或感到沮丧，或者运行中遇到任何阻碍—— 凡是本不该花这么多轮才能解决的问题，无论最终是否报错（令人困惑的错误、文档缺失、 必须重新运行的种子数据、无法满足需求的随附文件、必须阅读源代码才能理解的操作指南、 需要通过试错才能弄清的调用、不得不自行发明的变通方法、缓慢或不稳定的步骤、平台限制）， 都应根据 <SKILL_ROOT>/guides/feedback.md 提出代为向 Wix 反馈。默认主动提出，而不是等用户 询问；只有得到明确同意后才发送，绝不自动发送。第 5 步结束时也要进行同样的自检。

1. 确定技术栈。 默认采用 Wix 管理的 Astro——除非用户指定其他框架，或目录中已有 框架，否则就使用它。然后根据随附代码在该环境中的运行能力来选择：

   • React（Vite、Next 等）可运行所有随附内容——数据层、钩子和组件： --stack react。Agent 自己的文件可以使用 JS；随附文件是 TypeScript，在 JS 项目中 无需修改即可构建——绝不要手动移除 TypeScript；如果需求要求任何地方都不能使用 TypeScript，说明随附代码无法满足这一点，并在继续前征求用户意见。 指定的框架应先使用其自身命令搭建脚手架 （npm create vite@latest 等），然后在该文件夹中执行第 3 步。
   • 其他打包型 JS 框架（Vue、Svelte、Solid、纯 Vite）：数据层和与框架无关的存储模块 可运行（src/wix/ 中不含 React），React 钩子和组件则不适用：--stack lib。Agent 负责绑定存储模块，并根据相同的契约编写该框架的组件。
   • 没有打包工具，或使用其他语言——静态站点（纯 HTML/CSS/JS）、服务端渲染应用 （Flask、Laravel、Rails 等）：使用参考模式（见下方对应章节及 <SKILL_ROOT>/guides/reference-mode.md）。app/ 中的内容不会部署；REST 层会为浏览器端 部署，服务器端则移植该层以执行读取操作。 Wix 托管的要求，以及各技术栈要在此发布所需的配置。 wix release 会上传 wix.config.json 中指定的文件夹（site.outputDirectory），并将其作为文件提供服务——不支持 SPA 回退、目录索引或重写：/ 和实际存在的文件可以正常访问，直接加载或分享干净的客户端路由时则会返回 404。服务器代码只能通过 Cloudflare Workers 构建运行，声明方式为 outputDirectory: { client, server }。
   • Managed Astro 是 Wix CLI 搭建的技术栈：Wix Astro 集成（@wix/astro，环境身份验证）、托管适配器（@wix/astro-wix-hosting-adapter，Workers 构建）、用于已交付组件的 React 18 及 astro.config.mjs 中的 integrations: [wix(), react()]、adapter: wixHostingAdapter()、output: "server"、security: { checkOrigin: false } 和带有 static.wixstatic.com 的 image.domains。未通过 CLI 创建的 Astro 项目不包含这些配置；部署前请添加，否则网站将提供所有路由。该集成支持 Astro 5：使用其他主版本的项目必须先固定到 5，或连接为 React 宿主。
   • React 和其他打包工具会将自己的构建结果作为文件发布。因此，路由应使用哈希路由，或为每个路由生成一个以文件名链接的 HTML 文件——这必须在编写第一个路由之前确定；传给 Wix 作为返回目标的任何 URL 都必须是主机能够提供服务的 URL。请直接加载深层 URL 进行验证，而不要从 / 导航过去。
   • 构建结果为服务器的框架（Next、Nuxt、Remix、SvelteKit 等）只能以静态导出（文件，遵循上述规则）或通过 outputDirectory: { client, server } 进行 Workers 构建的方式发布；否则就必须自行托管，并在结账流程能够返回该站点之前，将其域名添加到 OAuth 应用的允许域名中。
   • 静态（无需构建）：outputDirectory 指向页面所在的文件夹；路由为页面加查询字符串 slug（引用模式）。

2. 种子计划。 如果需求说明以任何形式提供了内容——CSV、JSON、电子表格、提示词中的列表、PDF 价目表、照片文件夹和文本文件、现有目录链接，或任何其他列出内容的材料——那就是计划：按照 templates/shared/SUPPLIED-CONTENT.md 和该垂直领域的 SEED.md（“Supplied content”）将其映射到 plan.json，逐条收录，名称和价格照原样保留，使用其图片且不添加其他图片。只有在没有提供任何内容时，才根据需求说明拟定计划（此处只需阅读该垂直领域的 SEED.md——它仅取决于需求说明；将该垂直领域的 INSTRUCTIONS.md 留到第 4 步，在需要时再阅读）。现有网站没有计划：如果需求说明给出了网站 ID，内容已保存在该网站中——无需植入种子，前端直接读取现有内容（第 3 步的连接路径）。

3. 在项目文件夹中设置项目——无论文件夹为空还是已有项目，都使用同一个确定性调用；文件夹决定调用的操作：

   node <SKILL_ROOT>/install/setup.mjs --vertical <vertical>[,<vertical>…] [--plan plan.json] [--business-name "<Brand>"]
   

   在这一次调用中列出需求说明所需的每个垂直领域（带有会员账户的商店为 storefront,members）：第一个垂直领域的模板会搭建项目，并通过 --plan 运行其种子；其他垂直领域也会在同一次调用中部署，因此一次安装即可涵盖所有垂直领域。在安装开始后添加其他垂直领域，则需要再次安装。需求说明提供内容时，其他垂直领域的种子会随后运行，并各自使用单独的计划（members 种子会安装 Members Area 应用，无需计划）。

   • 空目录（或只有零散文件：CSV、简要说明）→ 创建：使用该行业的组合模板运行 wix create；此处的 --business-name 用于命名网站。
   • 没有 wix.config.json 的项目（根目录中有 package.json 或 index.html：例如某人的 Astro、Vite、Next 或纯 HTML 项目）→ 连接：在原目录运行 init，将文件夹关联到一个新网站（网站以文件夹命名），然后将随附代码部署到项目中，保留项目原样。传入在步骤 1 中确定的技术栈对应的 --stack，并在调用前或调用后立即将项目调整为该技术栈在 Wix 托管环境中所需的形式（步骤 1）。使用 --stack static 时，设置过程还会将 site/ 设为 wix release 上传的文件夹，并将 REST 层部署到 site/js/wix/；你需要将页面、样式和资源移入其中（guides/reference-mode.md）。
   • 有 wix.config.json 且已有项目 → 拒绝：该文件夹已经是带前端的 Wix 项目，无论它是由 CLI 创建、手动编写，还是由此技能构建。以下三个命令从项目根目录运行，即可完成设置所需的所有操作：deploy.mjs <vertical…> --stack <stack> 添加此技能的代码或解决方案（客户端 ID 来自 .env.local，配置文件是备用来源），然后运行一次 npm install，最后运行种子模块（如果有内容需要创建）。对于由此技能构建的项目，若要创建新解决方案，只需运行第一个命令；要修改已构建的内容，则需编辑文件并发布。
   • 有 wix.config.json，没有项目，且 .env.local 声明了迁移（从 Wix 下载、准备迁移到无头模式的网站项目；配置文件中的网站仅用于托管部署，环境变量中的网站是待迁移的网站）→ 迁移：设置过程会将该行业的组合模板复制到配置文件周围，以迁移后网站的应用作为客户端进行部署，启动安装，但不创建种子内容。ready_for_brand_layer 会显示 mode: "migrate"、作为 siteId 的父级网站，以及作为 deploySiteId 的子级网站。规则见 guides/migration.md。
   • 有 wix.config.json，没有项目，也没有迁移（init 在空文件夹中留下的状态）→ 网站已存在，但尚无前端：使用下文的 attach.mjs，它会从配置文件中读取网站、复用其托管环境、搭建脚手架并进行部署。不创建种子内容：网站已有自己的内容。
   • 简要说明中通过 ID 指定网站 → 不要运行此命令：阅读 <SKILL_ROOT>/guides/existing-site.md 并按其中说明操作（读取网站后运行 attach.mjs，它会对指定网站执行设置所需的操作；其中也介绍了自托管和磁盘上已有项目的情况）。

   必须传入 --vertical，以选择要部署的随附代码以及要运行的种子程序——使用从 Verticals 表中确定的行业。--plan 决定是否创建种子内容：若步骤 2 中有方案，则传入该方案；已有内容的网站不创建种子内容。创建种子内容是增量式的：绝不会删除或覆盖网站已有内容；如果看起来需要清理，请先询问。ready_for_brand_layer 事件会显示 mode（create 或 connect）、技术栈，以及该技术栈对应的 next，包括发布方式。

   设置过程使用 --skip-git 搭建脚手架：它会组合自己的步骤，并将版本控制留给你或外层仓库，因此不会创建脚手架通常会创建的 Git 仓库和初始提交（否则，若项目位于某个仓库内，该仓库会变成嵌套仓库的 gitlink）。

   项目会创建在当前目录中——即入口指引你操作的文件夹，该文件夹已经包含已安装的技能——因此项目是自包含的，之后在其中打开新会话时也能找到所有内容。如果文件夹中已有脚手架将要写入的文件，操作会被拒绝。若当前文件夹必须保持原样，可使用 --subfolder 在一个以业务名称命名的新文件夹中创建项目；此时技能位于项目上一级。 它每行会输出一个 JSON 事件，并在 约 35 秒后返回：从该垂直领域组合的模板中搭建项目（wix create 会复制模板：代码和锁定文件会随脚手架一同到位），部署文件夹中仍缺少的内容（将代码导入的所有依赖补丁到 package.json 中），然后启动两个分离的后台任务——安装依赖（npm ci --ignore-scripts || npm install --ignore-scripts）和播种——其日志和完成标记都会出现在事件中。最终的 ready_for_brand_layer 事件会包含项目目录、siteId、现成的仪表板链接以及两个标记。转发值得注意的事件。如果出现 error 事件，请按以下手动路径仅恢复该步骤，然后继续。

   恢复某个步骤，或稍后添加解决方案：这些步骤都可在项目根目录独立运行——node <SKILL_ROOT>/install/deploy.mjs <vertical…> --stack <stack>（客户端 id 从 wix.config.json 读取）、执行一次 npm ci --ignore-scripts || npm install --ignore-scripts（绝不能同时运行第二个 npm install：两个 npm 在同一个 node_modules 中会产生竞争并重复彼此的工作；设置流程已经启动了一个——等待其标记），以及按照 seed/SEED.md 中的说明运行该垂直领域的 seed 模块。 对现有项目所做的代码更改，只有在发布（步骤 5）且线上 URL 显示更改后才算完成，而不是在开发服务器或本地构建中显示更改时。管理更改（针对站点执行的配方）无需发布；前端会实时读取。

4. 在安装完成时设计并构建页面——在 ready_for_brand_layer 事件指定的项目目录中，按照该垂直领域的 INSTRUCTIONS.md 操作：设置 @theme 令牌，为界面框架添加品牌样式，并基于已提供的钩子自行实现该垂直领域的创意页面——针对店面，包括你自己的产品卡片和网格、店铺页面、PDP 页面及主页——设计应契合需求说明，而非照搬参考组件。现在阅读 INSTRUCTIONS 和共享基础规范——templates/shared/DESIGN.md + templates/shared/CONTENT.md（不要提前阅读——它们的约定从此步骤起才适用）；钩子和 DTO 约定已内嵌其中，因此不要打开已提供的文件本身。尽可能少地发送消息来编写页面——在一条消息中批量调用多个 Write（组件对应独立文件）；不要每个文件都单独往返一次。 如果需求说明要求的核心操作不在已提供的代码中，请在编写前阅读 templates/shared/CUSTOM_OPERATIONS.md。选择一条有文档说明的路径并实现；不要逆向分析 SDK 内部实现。

5. 等两个后台任务都完成后——安装任务的标记文件 node_modules/.package-lock.json 和种子任务的标记文件 .seed-exit 都已存在——确认种子任务成功（.seed-exit 内容为 0；seed-result.json 中包含用于总结的创建数量——如果非零，请阅读 seed.log 并手动重新运行种子模块）。只有在设置流程启动了种子任务时，这两个种子文件才会存在（attach 不运行种子任务：只等待安装标记）。如果你自行运行了 seed-store.mjs（connect/iterate 运行、参考模式），则无需等待标记文件：进程退出代码就是结果，标准输出中的 JSON 就是结果数据——等待进程结束（前台运行，或对其 pid 执行 wait），不要等待文件。随后构建并发布一次（托管模式），按照 ready_for_brand_layer 事件中针对该技术栈指定的 next 操作：Astro → 执行 npx @wix/cli@latest build，然后执行 npx @wix/cli@latest release；React 或其他打包工具 → 使用项目自身的构建命令，然后通过 npx @wix/cli@latest release 发布 wix.config.json 中指定的构建文件夹（深层 URL 必须能直接返回 200，参见步骤 1）；静态项目 → 仅执行 release。如果安装失败，再运行一次，然后构建。不要在流程中途构建并发布；后端内容在运行时获取，因此重新发布不会“刷新”已播种的数据。只有网站发布成功，运行才算完成——结束时提供线上 URL 和控制台链接 https://manage.wix.com/dashboard/<siteId>（使用 ready_for_brand_layer 事件中的 siteId：对于迁移预览，该控制台链接对应迁移后的网站，发布 URL 对应预览站点，原网站保持不变；用户批准后，下一步是在 Wix CLI 中完成迁移——以上三点都要说明）。从 wix release 输出中原样复制线上 URL——绝不要凭记忆重新输入（子域名输错会让用户遇到 404）。结束前，根据 guides/feedback.md 对整个会话进行反馈自检：任何本可更快完成、却耗费了更多轮次的事情，包括你默默恢复处理的情况，都是反馈信号；如果有符合条件的情况，在提供链接时主动询问用户是否愿意让你转达，只有得到明确同意后才发送。

参考模式——静态网站，或使用其他语言构建的服务端渲染应用

随项目提供的数据层还以 fetch 之上的 REST 层形式存在，供无法运行 app/ 的技术栈使用：没有打包器的静态网站，或使用其他语言构建的服务端渲染应用（Flask、Laravel、Rails）。REST 层负责部署到浏览器端；服务端则移植其读取逻辑。当第 1 步确定使用的是这些技术栈之一时，请在第 3 步之前阅读 <SKILL_ROOT>/guides/reference-mode.md：其中介绍了实现细节（site/ 布局及 setup 在其中的作用、浏览器端与服务端分别运行什么内容、自托管源站的 OAuth 允许列表、预渲染输出），以及如何结束此类运行。对于公共网站，使用托管版 Astro 仍是更好的选择；结束时请说明这一点。

垂直领域

速查表。根据第一列判断需求；如果其中提到了此处未列出的 Wix 产品或功能、可能符合两行，或者听起来像是此技能未提供的功能（会议、礼品卡、忠诚度、群组），请阅读 <SKILL_ROOT>/guides/capabilities.md：其中介绍了每种 Wix 产品、涵盖的内容、此处由哪个垂直领域提供，以及未提供的功能。

用户想要……	垂直领域	操作指南
在线商店：商品、分类、变体、购物车、结账	storefront	templates/storefront/INSTRUCTIONS.md
预约／课程：服务、时段、员工、预订、结账	bookings	templates/bookings/INSTRUCTIONS.md
租赁：按小时或天租用的房间、车辆、装备，由客户选择租期并结账	rentals	templates/rentals/INSTRUCTIONS.md
博客：文章动态、分类／标签、富内容文章页面	blog	templates/blog/INSTRUCTIONS.md
结构化内容集合（目录、菜谱、列表），页面根据架构设计	cms	templates/cms/INSTRUCTIONS.md
任何可由访客填写的表单：联系／咨询、注册、申请、问卷——根据实时架构呈现	forms	templates/forms/INSTRUCTIONS.md
活动：活动列表、活动页面、免费 RSVP、通过托管结账售票	events	templates/events/INSTRUCTIONS.md
会员账户：应用内自定义登录／注册、受限页面、账户页面	members	templates/members/INSTRUCTIONS.md
作品集／展示：项目集合、带媒体画廊的项目页面	portfolio	templates/portfolio/INSTRUCTIONS.md
会员／订阅方案：定价页面、方案详情、托管购买	pricing-plans	templates/pricing-plans/INSTRUCTIONS.md
餐厅：带照片的菜单、在线点餐、餐桌预订	restaurants	templates/restaurants/INSTRUCTIONS.md
常见问题：按类别分组的问题、搜索、可展开的答案、每个问题对应一个链接	faq	templates/faq/INSTRUCTIONS.md
捐款：活动页面、目标进度、通过托管结账进行一次性和定期捐款	donations	templates/donations/INSTRUCTIONS.md

垂直领域可以组合：跨越多个领域的需求（例如带博客的餐厅、带会员账户的商店）应在设置调用中列出所有领域（--vertical restaurants,blog），这样一次安装即可覆盖；每个垂直领域的种子数据都会按各自的方案运行。对于已构建的项目，在项目根目录运行 node <SKILL_ROOT>/install/deploy.mjs <vertical…> 添加一个垂直领域，然后运行一次 npm install，再运行其种子数据。与任何已提供的垂直领域都不匹配的需求没有现成代码：用一行说明这一点，然后通过 wix-docs 根据 Wix API 参考构建（先搜索，再查看方法页面），遵循其他所有调用相同的规则，并使用同一项目和技术栈；如果有最接近的已提供垂直领域，则从它开始（guides/capabilities.md 会说明是哪一个）。