diff --git a/.codex/skills/genarrative-play-type-integration/SKILL.md b/.codex/skills/genarrative-play-type-integration/SKILL.md index d4bcb86a..1e3ab0c6 100644 --- a/.codex/skills/genarrative-play-type-integration/SKILL.md +++ b/.codex/skills/genarrative-play-type-integration/SKILL.md @@ -1,6 +1,6 @@ --- name: genarrative-play-type-integration -description: 在 Genarrative 中新增一个创作入口/玩法类型时,按入口配置、前端分流、契约、后端接口、工作台、结果页、可选 runtime 与作品架的顺序接入。 +description: 在 Genarrative 中新增或补齐一个创作入口/玩法类型时,按入口配置、前端分流、契约、后端接口、工作台、独立生成页、结果页、发布、统一作品详情、正式 runtime、公开 read model、基础统计与作品架/广场的顺序接入。 license: MIT metadata: author: Hermes Agent @@ -40,10 +40,43 @@ metadata: - 创作入口 - 工作台 - 草稿生成 +- 独立生成页(如果存在自动资产生成) - 结果页 - 发布 +- 统一作品详情页 - 试玩 runtime -- 作品架 / 广场 / 分享 +- 公开作品卡 / 作品架 / 广场 / 分享 +- 正式 runtime 统计 + +## 公开闭环决策点 + +新增玩法如果要作为公开作品交付,先按这些决策点对齐,不要直接套某个玩法的具体字段或 UI: + +```text +创作入口 / 工作台 + -> 草稿保存 / 编译 + -> 独立生成页(自动素材,可选但推荐) + -> 结果页(确认、单槽重试、上传、发布) + -> 统一作品详情页 /works/detail?work=<公开作品码> + -> 正式 runtime + -> 基础统计 / 公开 read model + -> 作品架 / 发现流 / 分类推荐 / 今日卡片 +``` + +必须先做这些决策: + +1. **公开作品身份**:是否需要公开作品码;前缀、解析入口、分享 URL 和统一作品详情页如何映射。 +2. **编辑契约边界**:哪些字段是 v1 公开编辑语义;旧字段是兼容、迁移、只读展示,还是明确不兼容。 +3. **生成阶段归属**:是否有自动素材生成;生成动作放在工作台、独立 `*-generating` 页,还是结果页手动触发。 +4. **失败承接策略**:全部失败、部分失败、单槽失败分别进入哪个页面;错误态由生成页还是结果页承接。 +5. **结果页能力边界**:结果页只做确认 / 单槽重试 / 重新生成 / 上传,还是还允许批量生成、规则编辑或资源配置。 +6. **发布后去向**:发布成功后默认进入统一作品详情页;只有明确需要时才新增专属详情页。 +7. **公开卡片资产来源**:封面是复用已有素材合成、使用首图、还是新增独立封面资产。 +8. **公开读取路径**:广场 / 发现流读取 SpacetimeDB view 或 public read model;api-server 是否需要订阅缓存,避免每请求 procedure 热路径。 +9. **runtime 模式差异**:`draft` 和 `published` 的输入能力、mock/debug 开关、鉴权、开始条件是否不同。 +10. **正式统计口径**:哪些 runtime 事件写正式统计;草稿试玩、mock、debug 是否必须排除。 +11. **规则参数归属**:哪些配置是创作者可编辑;哪些阈值、时长、冷却、计分、反作弊、裁决规则必须留在后端规则集。 +12. **旧数据策略**:旧草稿、旧发布配置、旧分享码是迁移、降级展示、重新生成,还是明确不兼容。 ## 推荐接入顺序