generate

用途

该技能用于为 Lexsis 店面创建未发布的远程草稿，并在用户意图需要更深入验证时，将其同步并质检至可发布状态。草稿创建是可逆的，发布仍是单独的显式操作。

主要能力

• 从本地规范源创建远程草稿。
• 依据整个请求和对话推断意图，不要求触发短语。
• 默认使用 fast-draft 模式处理可逆的模糊请求，以及创建、试用、预览、探索或迭代类请求。
• 当用户要求最终打磨、详尽质检、活动交接或发布准备时，进入 production-ready 模式。
• 发布请求路由到 /publish；该技能从不推断实时发布批准。
• 复用已保存的 store/theme 绑定，仅在绑定有效时不再次调用 setup。
• 仅刷新易变的创建数据：选定的产品和变体、价格、可用性、权限、活动 island schema，以及现有页面的版本。
• 使用捆绑适配器准备精确的工具输入，并以 summary 模式编译。
• 若远程草稿已存在，则获取当前编辑上下文并复用该草稿，不再次调用创建。
• 创建成功后立即记录页面 ID、版本、预览 URL、本地哈希和编译包哈希，将 manifest 状态设为 draft_created，QA 设为 pending，并立即以 DRAFT_CREATED 呈现预览。
• 在预览存在后继续尽力验证，除非用户要求停在首个草稿。
• 对 production-ready 或升级现有 DRAFT_CREATED 的情况，获取持久化的源、包和版本证据，拒绝远程/本地哈希漂移并从当前本地源修复草稿，将页面图像作为一个活动整体审查，在 390px、768px 和 1280px 运行托管 QA，验证排版、媒体、水合、溢出、响应式几何、预期 Shopify 变体、购物车打开、数量、小计、Quick Add、产品网格稳定性、缩略图以及作者定义的页眉/页脚顺序，将证据和阻塞项写入 qa-report.md。
• 仅当所有阻塞检查通过时设置状态为 qa_passed，然后使用 --phase draft 和实时远程哈希运行验证器。
• 仅在同步和每个阻塞 QA 检查通过后返回 DRAFT_READY；否则返回现有的 DRAFT_CREATED，并附上具体阻塞项和下一步修复操作。
• 后续编辑时获取编辑上下文，遇到意外版本漂移则停止；先更改本地源，编译一次更改的输入，仅用 expected_version 修补更改的区段，成功后才更新同步状态。

使用方式

技能会读取以下参考文件：references/workflow-intent.md、references/source-and-sync.md、当源包含或需要动效时的 references/animation-system.md、当规划或设计被跳过时的 references/consumer-behavior-cro.md、仅针对现有页面的 references/page-editing.md、仅在复用商家模板时的 references/merchant-templates.md，以及用于生产就绪 QA 的 references/qa-recipe.md。

使用的工具包括：lexsis_catalog.get、lexsis_design.island_schema、lexsis_pages.compile、lexsis_pages.edit_context、lexsis_pages.source、lexsis_pages.integrity 和 lexsis_page_create.create。

输入与设置复用：使用 lexsis-source.html、page-theme.css 和紧凑的 schema-v3 manifest。复用 work/storefront/setup/setup.json 中保存的 store/theme 绑定。当该绑定有效时，不要再次调用 setup。

如果 /plan-page 或 /design-page 被有意跳过，则创建最小缺失的本地工件，记录跳过并继续。使用 references/consumer-behavior-cro.md 记录最小访客模式、首要决策问题、至多两个相关模式、图库缺口和主要指标。不要声称发生了实际未进行的设计批准。

草稿创建门禁：在首次远程草稿之前，仅要求：有效的已保存 store/theme 绑定和草稿写入权限；非空的规范源、主题 CSS、标题和页面 handle；当前产品/变体绑定且没有已知无效的硬编码变体；永久资产而非本地 URL；自定义字体由 head.fonts 中的完整 HTTPS 样式表 URL 支持，或有意的系统字体栈；干净的编译器结果。不要因批评截图、详尽哈希、托管响应式 QA、商务 QA 或 DRAFT_READY 验证器结果而阻止首次草稿创建。无法读取的可选设计或 QA 指南会产生一个警告，不会阻止草稿。缺失的源格式、manifest 或编译契约输入仍然阻塞。

从工作区编译：使用捆绑适配器准备精确的工具输入：

python3 <generate-skill>/scripts/prepare_workspace_compile.py
<page-workspace>
--output <page-workspace>/compile-request.json

使用适配器的 compile 对象作为 lexsis_pages.compile 的精确参数。使用 summary 模式；不要仅为检查而请求或回显完整的编译包。

如果 remote.pageId、remote.lastKnownVersion 和 remote.previewUrl 已存在，则获取当前编辑上下文并复用该草稿。不要再次调用 lexsis_page_create.create。仅在本地输入更改时编译，然后用 expected-version 保护修补现有草稿。

当不存在远程草稿时，从当前文件编译一次。立即将返回的 compile_id 和适配器的 create 字段传递给 lexsis_page_create.create，并设置 publish:false。

如果编译 ID 在创建前过期，对相同的已验证输入重新编译一次。如果客户端无法复用该 ID，则使用适配器中的精确 source、head、theme CSS 和 scripts 创建。过期不是重复规划、批评、资产搜索或批准的理由。

返回或复用可逆草稿：创建成功后，或确认现有草稿为最新后：记录页面 ID、版本、预览 URL、本地哈希和编译包哈希。将 manifest 状态设为 draft_created，QA 设为 pending。使用 --phase draft-created 运行验证器。立即以 DRAFT_CREATED 呈现预览。不要因为后续 QA 发现问题而删除、替换或隐藏可用的草稿。

生产就绪后续跟进：预览存在后，继续尽力验证，除非用户要求停在首个草稿。

后续编辑：获取编辑上下文，遇到意外版本漂移则停止。先更改本地源，编译一次更改的输入，仅用 expected_version 修补更改的区段，成功后才更新同步状态。

返回：始终返回工作目录、源路径、页面 ID、版本、预览 URL、推断的意图模式和当前状态：DRAFT_CREATED 或 DRAFT_READY。当尝试了 QA 时，包含 QA 报告。

适用场景

• 需要为 Lexsis 店面创建未发布草稿。
• 需要快速试用、预览、探索或迭代店面页面。
• 需要最终打磨、详尽质检、活动交接或发布准备。
• 需要复用现有草稿并进行后续编辑。

限制

• 该技能从不推断实时发布批准；发布请求路由到 /publish。
• 创建草稿的请求仅授权为指定页面使用一次页面创建额度。意图推断从不授权重复页面、付费资产生成、发布、删除或破坏性替换。
• 不要因批评截图、详尽哈希、托管响应式 QA、商务 QA 或 DRAFT_READY 验证器结果而阻止首次草稿创建。
• 无法读取的可选设计或 QA 指南会产生一个警告，不会阻止草稿。
• 缺失的源格式、manifest 或编译契约输入仍然阻塞。
• 不要声称发生了实际未进行的设计批准。
• 不要仅为检查而请求或回显完整的编译包。
• 不要因为后续 QA 发现问题而删除、替换或隐藏可用的草稿。
• 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。