GenarrativeAI/Genarrative
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: freeze play creation tool SOP

Browse Source
This commit is contained in:
高物
2026-05-19 16:45:00 +08:00
parent 356d54a034
commit f370539a6f
5 changed files with 381 additions and 582 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.hermes/shared-memory/pitfalls.md
View File

@@ -22,6 +22,14 @@
- 验证：拼图入口测试仍可通过，且新组件可通过不同页面复用而不需要复制上传卡实现。
- 关联：`src/components/common/CreativeImageInputPanel.tsx`、`src/components/puzzle-agent/PuzzleAgentWorkspace.tsx`。
## 新增玩法不要直接复制旧玩法创作工具
- 现象：新玩法一开始就复制既有玩法的聊天式 Agent、轻输入 Agent、专属素材 DTO 或生成流程，后续在结果页、作品架和 runtime 上不断补兼容层。
- 原因：既有玩法只是历史实现，不是平台默认模板；把它们当起点会把玩法专属字段误当平台通用字段，导致创作工具和契约越来越难控制。
- 处理：新玩法先走平台级 SOP，默认用表单/图片输入创作工作台、单图资产槽位和通用系列素材图集生成；如果确需例外，先写 PRD 例外原因、影响范围和回退方式，再编码。
- 验证：新增玩法 PRD 中能直接找到平台级创作工具声明，不需要从某个既有玩法反推接入方式。
- 关联：`.codex/skills/genarrative-play-type-integration/SKILL.md`、`.hermes/skills/genarrative-play-type-integration/SKILL.md`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
## OTLP 端点只填 Collector HTTP base endpoint
- 现象：生产或容器 env 里把 `OTEL_EXPORTER_OTLP_ENDPOINT` 填成 `4317`、Rider 端口或别的非 HTTP base endpoint 后，api-server 发不出 OTLP，或者链路被错误转发。