Yao GEOFlow Design 是一个用于当前 GEOFlow 前端体验工作的技能。它负责设计与规划以及预览产物,不负责线上激活或后端改动。
用途 该技能面向 GEOFlow 前端体验的设计与规划工作,帮助在默认站点与 GeoFlow Agent 渠道站点之间进行前端体验的发现、比较、预览、克隆和编排。
主要能力
- 负责 Laravel Blade 主题发现。
- 负责预览编辑会话。
- 负责参考站点映射。
- 负责首页 homepage-design.json。
- 负责带现有 lead_form_slug 的 lead_form 模块。
- 负责默认站点与渠道前端对比。
- 负责目标包能力缺口分析。
- 负责同步预览规划。
边界 该技能明确排除以下内容:后端/路由/模型/迁移、lead-form 增删改查、CLI 操作、直接生产激活、原始 HTML 复制,以及不支持的远程 PHP 编辑。
对于创建 lead form、导出 leads、发布主题编辑器草稿或运行系统更新等运营管理 Web 操作,应使用 yao-geoflow-cli。
使用方式 必需检查:
- 确认 GEOFlow Laravel 工作区:artisan、routes/web.php、resources/views/site、resources/views/theme。
- 运行 scripts/discover_themes.py 和 scripts/discover_frontend_surfaces.py。
- 选择 target_surface:default_site、channel_site、cross_channel_sync 或 template_mapping。
- 当 HomepageModuleBuilder/import 存在时,优先使用经过审查的 homepage-design.json,而非 Blade 编辑。
- 对于 lead_form,要求存在一个现有的活动 slug,并输出规范的 lead_form_slug;不要在此处创建表单。
- 对于渠道同步,将默认站点支持的模块与目标包 frontend-capabilities 进行比较;将不支持的 lead_form 降级为 CTA/link,或要求目标升级。
- 将预览/导入/同步/激活保持为独立的确认步骤。
参考资料:
- 默认站点工作请阅读 geoflow-frontend-map.md、homepage-composition-guide.md 和 template-boundary.md。
- 渠道工作还需阅读 channel-frontend-contract.md、distribution-target-site-map.md 和 backend-connection-workflow.md。
- 包/编辑流程请阅读 laravel-theme-contract.md、theme-package-contract.md、theme-edit-workflow.md 和 design-optimization-playbook.md。
- 检查路由时查看 trigger_cases.json 和升级报告。
适用场景 适用于 GEOFlow 前端体验的设计与规划,包括默认站点与渠道站点的前端对比、主题发现、预览编辑、参考站点映射、首页设计、lead_form 模块处理以及同步预览规划。
限制 该技能不涉及后端/路由/模型/迁移、lead-form 增删改查、CLI 操作、直接生产激活、原始 HTML 复制和不支持的远程 PHP 编辑。运营管理 Web 操作需使用 yao-geoflow-cli。