c18e7f5324
① .agents/skills/heritage-game-design.md:非遗品类设计手册(照 sim-business 体例:玩法化 范式/工序节奏目标值/双层奖励/文化表述红线/§11 品类 rubric 5 条 逐条 0/1+层标 L2×3/L3×1/ L4×1+正反例,对齐质量模型 SoT §4 计分制;成长轴按 SoT §7 申报为工艺步骤解锁)。 ② game-runtime/games/_template-feiyi/:工序节拍品类骨架(轻起点):一条工序链依次就绪→ 火候窗口内点击完成→出成品,过窗回炉不判死;L1 plumbing 逐字节复用 _template-shop; core.js 顶部多样性参数空间(CRAFT_CHAIN/WORKS/节奏常量);_forensicsView targets/score 取证契约(occupied=当前就绪且窗口内可点的工位)。独立过九门:A-I 全绿、H_progress score 0→302、latch advisory(限时类口径,同经营打样)(verdict= games/_wg1-gen/p11d-tpl/evidence/verdict.json,本品类金标 spec 驱动);tools.mjs check 机器门 PASS;单测 11/11(core 8 + headless 3,headless 按本品类语义重写、不复刻陈旧拷贝)。 ④ fixtures/golden-specs/heritage-craft.play-spec.json(tap-targets occupied 族 + score 递增 + expectLatch;test_golden_specs 登记 heritage-craft,6/6 绿)+ fixtures/genre-rubrics/heritage.rubric.json(机器可读评分尺,锚定值待金标复验回填)。 路由(双源+热取三处同改):cheap_roles.py _SYSTEM_PROMPT 与 prompt.mjs 与 contracts/prompts/04-config/cheap-system.md 各加先读手册第 6 步(非遗品类→heritage skill + _fewshot-feiyi few-shot 指针,正例随品类小批蒸馏后落库);cheap-system version 1.0.0→1.1.0 + registry 同步(check_registry 17 条对齐 OK)。 既存问题(非本单造成,未扩大):cheap-system.md 自 8ea97234 起领先内置 _SYSTEM_PROMPT 一段「决策层/9 条自检」→ test_roles 两条 hotload 不变量测试基线即红;本单第 6 步在 热取/内置双路对称加入、漂移行数不变(仍 7 行)。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
contracts/prompts/ —— 第 8 类契约：Prompt Registry
Prompt 即契约。所有生成链路的 LLM prompt 在此 Git 化注册、版本化、过门禁，禁止散落在 Dify 节点/代码里。 治理细则见
.agents/skills/prompt-governance.md与docs/agent-specs/prompt治理体系-execution.md。
目录结构（8 阶段）
prompts/
├── registry.yaml # 注册表：id@version / owner / stage / file / eval
├── 01-safety/ # Prompt 安全/注入检测
├── 02-intent/ # 意图解析
├── 03-template/ # 模板匹配
├── 04-config/ # GameConfig 生成
├── 05-asset/ # 素材生成（ComfyUI 引导）
├── 06-quality/ # 质量评估
├── 07-fix/ # 失败修复/重生成
├── 08-meta/ # 标题/简介/封面文案
└── eval/<id>/ # 每条 prompt 的 Golden eval 集（inputs/expect/baseline）
引用与变更
- 引用：Dify/aigc 用
{{registry:id@ver}}引用，PromptRegistryLoader 加载注入。 - 变更：改 prompt 必须升 version，并过四道闸 CI（Schema 通过率 / 生成成功率≥80% / Golden 回归 diff / 成本延迟）；四闸绿后运营 HITL 抽检 K 条方可合入。
Registry 一致性 CI 门（check_registry.py）
check_registry.py（本目录同级）验证 registry.yaml 里每条 version 与对应 .md frontmatter 的 version 是否完全一致。防止 Java PromptResourceLoader 构建期快照加载的 prompt 版本与注册表宣称版本漂移（二者不一致会导致日志/追溯/审计失真）。
手动跑：
python3 contracts/prompts/check_registry.py
# exit 0 = 全部对齐；exit 1 = 有漂移（打印具体 id + 两侧 version）
接入 CI / pre-commit（推荐）：
- CI：在流水线加步骤
python3 contracts/prompts/check_registry.py（无三方依赖，标准库即可跑）。 - pre-commit：在
.pre-commit-config.yaml加 hook，entry: python3 contracts/prompts/check_registry.py，pass_filenames: false。
触发时机：任何 .md 或 registry.yaml 变更都应跑一次；CI 全量跑。