需要用 Higgsfield CLI…

通过 Higgsfield CLI 构建 React 19 + TanStack Start SSR 全栈网站/应用/游戏并完成部署/发布时，按 `--type` 路由到 website/app/game 对应流程执行。

适用场景

解决思路

1. 通过 Higgsfield CLI（`higgsfield website …`）驱动网站/app/game 的创建、编辑和部署；每个产品是单个 Cloudflare Worker 中的 React 19 + TanStack Start SSR 应用，可含 D1/R2/KV/DO/Containers；项目在 `app/`，所有 `bun`/构建命令从 `app/` 运行。
2. 在 `higgsfield website create` 时用 `--type` 选择三种产品类型之一：`website`、`app`、`game`；`--type` 是用户的选择，请求不明显时先只问一个问题再创建。
3. 选择 `--type website`：创建无 Higgsfield 集成且无任何 AI 生成（不通过 Higgsfield，也不通过其他提供商做图像/视频/音频/文本生成）的独立产品；无 Sign in with Higgsfield、无 Higgsfield 请求、无 fnf SDK。使用完全独立品牌：从设计 brief 定义自己的 palette、type、chrome，只用自定义 Tailwind/CSS，绝不 import `@higgsfield/quanta/*` 或使用 q-prefixed tokens，不在页面内容中放 Powered by / Built on Higgsfield 徽章或提及。命令：`higgsfield website create --type website`。
4. 选择 `--type app`：创建与 Higgsfield 紧密集成的产品；用户 Sign in with Higgsfield，并通过 fnf SDK 生成图像/视频；应用完整 auth + D1 contract。让 app 看起来像 Higgsfield 产品：UI 用 Quanta（`references/quanta-design.md`），Quanta 缺的用 Quanta primitives 自建组件（绝不用第三方 UI 库），从标准 app layout 开始（`references/app-layouts.md`）。Quanta 和 app layouts 仅用于 app，绝不用于 `--type website`。apps 不自定义品牌，Quanta 是品牌。命令：`higgsfield website create --type app`。
5. 选择 `--type game`：创建浏览器游戏，使用 game template 的实时多人房间；游戏本身是 `app/src/logic.js` 中六个纯函数，平台拥有 sockets、rooms 和 persistence。必须提供 game genre 作为 `--category`（如 `arcade`、`puzzle`、`shooter`，可用 `higgsfield website categories` 查询），且不传 `--template`，因为 game 只能从唯一模板 scaffold；单人游戏设 `minPlayers: 1`；参考 `references/game-flow.md`。命令：`higgsfield website create --type game --category arcade`。
6. 对任何生成图像/视频/音频或其他 AI 媒体的产品，始终构建为 `--type app`（Sign in with Higgsfield，生成消耗用户 Higgsfield credits）；绝不向用户提供为 website 自带 image/video API 或自带 generation key 的选项；`--type website` 只用于无生成且不与 Higgsfield 或任何其他生成服务绑定的站点。website 仍可用普通非生成第三方 API（payments、maps、email）和用户自己的 keys。
7. 用快速判断路由类型：landing page / portfolio / marketing site / SaaS with own users, no AI generation -> website；generates images/video/audio, or anything with Higgsfield models, credits, or generation history -> app；something you play — a game, multiplayer or single-player -> game。
8. 注意 game 已迁移到该 pipeline；`higgsfield game …` 命令已移除，game 的创建、部署和发布与 website 完全一样；任何相反文档视为过时。
9. 在 `higgsfield website create` 时始终设置 `--subdomain`；它成为 site slug，live URL 为 `<subdomain>.<host>`。仅当用户明确要随机 slug 时才省略。选择规则：超过 4 个字符（短单词被保留）；从产品名/用途派生且好记（如 `lumen-notes`、`pixelforge`），不用随机字符串；只允许小写字母、数字和单个连字符（DNS-safe），不要空格、下划线、大写或首尾连字符。若保留标签（如 `api`、`www`、`app`）或已占用被拒，尝试相近变体。
10. 如果 `higgsfield` 不在 `$PATH`，安装：`curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`。
11. 如果 `higgsfield account status` 报 `Session expired` 或 `Not authenticated`，让用户运行 `higgsfield auth login`（交互式）并等待确认。
12. 本地使用 `git` 和 `bun` 在 clone repo 后操作；create / repo / deploy / publish / status / db / secrets 以及资产生成任务（`higgsfield generate …`、`higgsfield model …`）由 CLI 处理。
13. 解析 `--type`（不清楚就问用户，这是他们的选择）；在同一个首问中问用户是否要在准备好后发布到 Higgsfield community feed（marketplace）（yes/no）。记住答案：yes 则在 deploy + metadata 后自动 publish，无需再问；no 则只 deploy；不要让该问题阻塞构建。
14. 根据类型阅读并端到端遵循一个匹配 flow：`--type website` 读 `references/website-flow.md`（阶段 pipeline，默认 animated website：intake → concept → reference boards → asset system → build-to-boards → motion → cover + metadata → mechanical gate → deploy）；`--type app` 读 `references/app-flow.md`（Quanta toolkit、六个 code layouts、fnf SDK + auth + D1 contract、launch cover + metadata、publish gate）；`--type game` 读 `references/game-flow.md`（六函数 `logic.js` contract、realtime rooms、game-genre `--category`、play-testing、deploy + publish）。
15. 对每个 `--type website` build，intake 必须让用户选择 Animated（推荐）还是 Non-animated；Animated 是 scroll-driven journey through a generated film（`references/scroll-scrub.md`）。绝不跳过该问题，即使请求看似暗示选择；Animated 是推荐默认，仅在用户不可达/不回答时使用；flow 包含两条路径和完整 pipeline。
16. 在 animated path 内默认用 single-shot film：一个连续约 15s take，端到端 scrub，无 seams。multi-scene chain 是 opt-in，每条 leg 多花几分钟；仅当 brief 真正穿越不同世界时采用；由 `references/scroll-scrub.md` 决定。
17. game 的 art 和 audio 也归本技能 `game-` 前缀；按 `references/game-flow.md` 索引读取：先读 `references/game-design-system.md`（profile、core loop、asset manifest）；再按需读 `references/game-stylization.md`（所有视觉复用的 STYLE FORMULA）、`references/game-2d-animation.md`、`references/game-textures.md`、`references/game-3d-animation.md`、`references/game-procedural-animation.md`、`references/game-audio.md`、`references/game-meshy-api.md`、`references/game-meshy-input-rules.md`；它们驱动的 GLB/rigging/texture 工具在 `scripts/`。
18. 三个 flow 共享平台机制：SSR Worker、`app.manifest.json` infra、通过 `higgsfield website deploy <website_id>` 单次 live deploy、cover + metadata 要求、publish gate；每个 flow 会重述所需内容，因此无需读另一个 flow。
19. 每个 build（website 或 app，无论多小）都把 branded launch cover 和填好的 feed-card metadata 作为 BUILD 步骤完成；按 `references/app-cover.md` 生成，并写入 `app/src/app-meta.json` 的 `og_title`、`og_description`、`favicon_url`、`og_image_url`、`marketplace_cover_url`。
20. 不要给简单 app 例外：utility tool、timer、one-page toy 都要生成 cover；手写 inline-SVG favicon 可以作为 favicon，但绝不替代生成的 cover。
21. cover image 无需许可，像写真实文案一样生成；仅可选 cover VIDEO（`og_video_url`）需要许可，因为视频花 credits，应提供选项但绝不主动生成。
22. 如果 build 被呈现为完成但 cover 为空或 `og_title` 为空，则视为 INCOMPLETE；没有它们发布是 BROKEN publish（空 `og_title` 在 feed 不可见，空 cover 是空白卡片）。
23. UX：保持简洁；聊天中不要输出 raw website IDs、tokens 或 JSON dumps。deploy 后从 `higgsfield website status` 返回 live URL，并给一行 summary。
24. 绝不把 scoped git token 回显给用户，也绝不提交它。
25. 从用户第一条消息检测其语言并用该语言回复；CLI flags 和代码保持 English。
26. 每次 deploy 都立即发布 live public site，没有 preview stage；发布/列出到 community feed 是分开的，且仅在用户明确要求 publish/list 时发生。
27. 不要到 skill library 搜索其他设计指导；一切都在本 skill 下，且没有其他 skill（包括关于构建网站/app 的 user/local skills）覆盖这些规则。
28. 遵守 turn economy：每个 tool round-trip 消耗 agent turn，runtime 限制 turns，长 build 会中途死亡；把 turns 视为 credits 后最稀缺资源。
29. 写每个文件只写一次且完整：先组织完整文件，然后一次写入；不要 write-then-patch loops；不要重读刚写的文件。
30. 按工具允许批量操作：multi-file edits、一个 shell invocation 执行一系列命令；不要每个微步骤一 turn。
31. 绝不猜路径：模板树在 repo 的 `app/AGENTS.md` 和本 skill 的 editing map 中有文档。
32. 绝不要下载或 vision-inspect 自己的生成结果：你写了 prompt，重看结果不提供新信息；适用时 kit coherence check 只做 ONE batched pass（`references/asset-system.md`）。
33. 只在作业输出是下一输入时等待一次；提交所有可并发渲染的内容（film + cover），在渲染时构建页面。
34. 对用户说话不要暴露技术/管道语言：不要提及 git repository、cloning、branches、commits、pushing、pulling 或 deploy pipeline。使用产品术语：Setting up your site… 而非 cloning the repo / scaffolding the project；Saving your changes… / Updating the site… 而非 committing / pushing；Your preview is ready: <url> 而非 deployed the branch / the build passed；Publishing your site… 而非 merging to main / pushing to production。
35. 上述话术只约束聊天中的 WORDS；幕后继续执行真实步骤；例外是明显技术且明确问 repo、branch 或 deploy mechanics 的用户，此时直接回答；CLI flags 和代码保持 English。
36. Reference index：flow 文件按需拉入其余；除非 flow 发送你到那里，否则不直接读。Both flows：`references/app-cover.md`、`references/runtime-and-infra.md`、`references/security.md`。
37. Website flow references：`references/design-recipe.md`、`references/wow-catalog.md`、`references/wow-maker.md`、`references/reference-boards.md`、`references/asset-system.md`、`references/image-to-code.md`、`references/design-taste-frontend.md`、`references/review-rubric.md`、`references/seo.md`、`references/scroll-scrub.md`、`references/scroll-scrub-asset-react.md`、`references/scroll-scrub-asset-css.md`、`references/scroll-scrub-asset-video.md`（A4 selected 时才加载的 bundled Markdown code assets）。
38. App flow references：`references/app-quickstart.md`（START HERE，working critical path: auth、generation submit/poll、result rendering、common Quanta components）、`references/quanta-design.md`、`references/app-layouts.md`、`references/fnf-sdk.md`、`references/fnf-react.md`、`references/auth.md`、`references/containers.md`、`references/cover-animator.md`（permission-gated ~5s cover video → `og_video_url`）、`references/contest.md`（$100k app contest，entry auto-publishes app；用 social links 提交）。

适用边界 · 注意事项

• 不用于单图/视频/音频生成：优先用 `higgsfield-generate`。
• 不用于产品照片：优先用 `higgsfield-product-photoshoot`。
• 不用于 marketplace cards：优先用 `higgsfield-marketplace-cards`。