docs(prompts): 四道闸CI接线步骤0——registry 消费面三态对账(17条逐条+门焊口径)

用一手代码证据坐实 17 条 prompt 的 live/fossil/batch-relic 三态,防把 CI 焊在死面上白花钱:
- live 10 条:safety.prompt-check(SafetyCheckClient GP9 门真发 LLM)+ tier2×8(roles.py prompts.load 运行时读)+ config.cheap-system(cheap_roles.py)
- fossil 5 条:clicker/merge/idle/tycoon(AigcTemplateConstants.SUPPORTED_TEMPLATE_IDS 已整体下架、gamedef 产物形态已废)+ generic-coder(STUB,PromptResourceLoader 只为 isReady/schema 加载、不喂 LLM)
- batch-relic 2 条:quality.adversary-review / fix.design-revise(全仓无 live 代码消费方,仅已删 agent-loop v1 evalflow.py 批跑过)

门焊口径写进 registry 头部:段 A 离线版本闸对全部条目生效(改正文必升 version,纯结构纪律零成本);段 B 真模型闸只焊 live——有金标真跑(唯 safety)、无金标 fail-closed(cheap-system/tier2)、fossil/relic SKIP 豁免。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
lili 2026-07-04 08:54:47 -07:00
parent e9b14a3186
commit d5865f57cd

View File

@ -2,7 +2,52 @@
# owner各 prompt 归属工位 | 治理:见 .agents/skills/prompt-governance.md 与 docs/agent-specs/prompt治理体系-execution.md
# 引用方式Dify/aigc 用 {{registry:id@ver}} 引用;变更 prompt 必须升 version 并过四道闸CI
version: 1
# ─────────────────────────────────────────────────────────────────────────────
# 消费面三态对账W-PCI · 2026-07-04四道闸 CI 接线步骤 0用代码证据坐实、非凭注释推断
#
# 为什么要对账:四道闸 CI 只该焊在「真被 live 生产路径消费、喂给 LLM」的 prompt 上;焊在早已下架
# 的死面上,既白花真模型钱,又给出虚假的治理安全感。下表把 17 条逐条判定三态,段 B 真模型闸据此
# 决定跑还是豁免。三态定义:
# · live —— 现行生产生成路径运行时读它、渲染后发给 LLM改它会真影响线上生成质量
# · fossil —— 代码里仍有加载壳,但产物形态或模板白名单已废,现行不会有任务走到它(改它无线上影响)。
# · batch-relic —— 只被已删除的 agent-loop v1 批跑编排evalflow.py消费过无任何 live 代码消费方。
#
# 逐条结论(证据 = 一手代码,路径见括注):
# safety.prompt-check live SafetyCheckClient.java:51 构建期加载 01-safety/prompt-safety-check.md
# GP9 合规门渲染 {{input.prompt}} 真发 LLMgp9-safety独立于模板白名单
# config.clicker-designer fossil PromptResourceLoader.TEMPLATE_RESOURCES 仍构建期加载,但
# config.merge-designer fossil AigcTemplateConstants.SUPPORTED_TEMPLATE_IDS 已把旧四模板整体下架
# config.idle-designer fossil (白名单 = generic + 5 品类):提交抛 AIGC_TEMPLATE_NOT_EXISTS、
# config.tycoon-designer fossil 执行判 no_template_match 不烧 LLM。它们产的 GameConfig 是已废 gamedef 形态。
# config.generic-coder fossil registry 自标 STUB 0.0.1PromptResourceLoader 加载它只为 isReady()
# 通过 + schema 进校验缓存,其类注释明写「后端不在进程内渲染/喂 LLM 该 prompt」
# generic 任务实走外置 Python cheap-worker用 cheap-system.md非本条
# quality.adversary-review batch-relic 全仓 grep 无任何 .py/.java live 消费方;仅 agent-loop v1 evalflow.py已删批跑过。
# fix.design-revise batch-relic 同上,无 live 消费方。
# tier2.design-system live tier2 gen-worker roles.py 经 prompts.load 运行时读design_team 兜底)。
# tier2.design-systems-designer live roles.py:245 prompts.load 运行时读(阶段 1 工作室专家)。
# tier2.design-economy-designer live roles.py:246 prompts.load 运行时读。
# tier2.design-level-designer live roles.py:247 prompts.load 运行时读。
# tier2.design-presentation-designer live roles.py:248 prompts.load 运行时读。
# tier2.design-leader-system live roles.py:264 prompts.load 运行时读(阶段 1 leader带参 brief
# tier2.writer-system live roles.py:280 prompts.load 运行时读(阶段 2 单写 agent 前缀)。
# tier2.player-system live roles.py:297 prompts.load 运行时读L3 视觉软检玩家)。
# config.cheap-system live cheap-worker cheap_roles.py _load_system_prompt() 运行时读(便宜档 A-model 生成)。
#
# 门焊接口径(据上表):
# · 段 A 离线版本闸check_version_bump.py对全部 contracts/prompts/ 条目生效——「改正文必升 version」是
# 纯结构纪律、零成本,无需区分三态,一律强制。
# · 段 B 真模型闸eval_gate.py只焊 live 条目safety + tier2×8 + cheap-system
# - live 且有金标集 → 真跑四道闸(当前仅 safety.prompt-check见其 eval/ 10 条负例);
# - live 但无金标集cheap-system / 8 条 tier2本表 eval 字段待建)→ fail-closed 报「金标缺失」,绝不假绿;
# - fossil / batch-relic → 显式 SKIP 豁免clicker/merge/idle/tycoon/generic-coder/quality/fix不花真模型钱。
# · 注04-config 下 business-sim/narrative/puzzle/trpg/heritage 五个 -designer.md 是 SUPPORTED_TEMPLATE_IDS 内
# 的 live 白名单模板,但同 generic 一样「只进 schema 缓存、不喂 LLM」且未登记进本 registry不在本次对账 17 条内。
# ─────────────────────────────────────────────────────────────────────────────
prompts:
# 【三态·段B处置】safety.prompt-check = liveSafetyCheckClient GP9 合规门真发 LLM且有 eval/ 10 条负例金标集
# → 段 B 真模型闸对它真跑四道闸当前唯一「live 且有金标」的条目)。
- id: safety.prompt-check
version: 1.0.0
stage: "01-safety" # 8 阶段01-safety 02-intent 03-template 04-config 05-asset 06-quality 07-fix 08-meta
@ -11,6 +56,8 @@ prompts:
desc: 创作者 Prompt 安全/注入检测(生成链路第 1 节点)
eval: eval/safety.prompt-check/ # Golden eval 集四道闸Schema/成功率/回归diff/成本延迟)
# —— agent 化生成 QA 闭环 v1 三件套HJ-AGENT-LOOP-EXEC-001 §5v1 仅 clicker 走批跑)——
# 【三态·段B处置】以下 clicker/merge/idle/tycoon 四策划模板 = fossil已废 gamedef 线SUPPORTED_TEMPLATE_IDS
# 已整体下架、不可被生成)→ 段 B 真模型闸对它们 SKIP 豁免(保留条目不删,见头部对账总表)。
- id: config.clicker-designer
version: 1.1.0 # v1.1.0batch-001 冻结告警→新增 designIntent 模板内约束(加规则不改口径)
stage: "04-config"
@ -40,6 +87,8 @@ prompts:
desc: agent 闭环 tycoon 模板策划创意一句话→GameDesign 三段designIntent/expectedPlaySeconds/configconfig 受 contracts/templates/tycoon.schema.json 约束)
eval: eval/config.tycoon-designer/ # 新建 Golden 目录(首版无种子,随批回流)
# —— P3 生成主线编码 promptW-G12026-06-14范式=编码出 bundle 源码,非策划出 GameConfig——
# 【三态·段B处置】generic-coder = fossil·STUBPromptResourceLoader 只为 isReady/schema 加载它、不喂 LLM
# generic 任务实走外置 cheap-worker 的 cheap-system.md→ 段 B SKIP 豁免。
- id: config.generic-coder
version: 0.0.1 # ⚠️ STUB 占位骨架04-config/generic-coder.md 仅 frontmatter+三要点提纲,非正式 promptL1 出正式草案时整体替换并升版,两处 version 同步
stage: "04-config"
@ -47,6 +96,8 @@ prompts:
file: 04-config/generic-coder.md
desc: P3 编码 prompt创意一句话→GameHostFactory 源码→esbuild 打 __GameBundle bundle非策划出 GameConfig。【当前为 STUB 占位骨架·L1 出正式草案替换】
eval: eval/config.generic-coder/ # 新建 Golden eval 目录(首版无种子,随 bake-off 批回流)
# 【三态·段B处置】quality.adversary-review 与 fix.design-revise = batch-relic无 live 代码消费方,仅
# 已删的 agent-loop v1 evalflow.py 批跑过)→ 段 B SKIP 豁免(有金标集也不跑真模型,见头部对账总表)。
- id: quality.adversary-review
version: 1.1.2 # v1.1.2:细则①追加 merge 域示例P0/P1 口径文字仍未动)
stage: "06-quality"
@ -62,6 +113,8 @@ prompts:
desc: agent 闭环 fix 变体:原 GameDesign+findings(P1) 回灌重出(只修指出项,未指出字段原样保留;回炉额度合计 1 轮)
eval: eval/fix.design-revise/ # 每批 evalflow.py 强制回流fix 前后对照跨目录按 rootDesignId 关联§16 D2-a
# ── tier2 富游戏自治生成线 prompt09-tier2-richgamerange=tier2/gen-worker/worker/roles.py─────────────
# 【三态·段B处置】以下 8 条 tier2 = liveroles.py 经 prompts.load 运行时读),但 eval 字段待建、当前无金标集
# → 段 B 真模型闸对它们 fail-closed 报「金标缺失」(绝不假绿;补金标后即真跑,见头部对账总表)。
# 范式AgentScope 2.0.2 ReAct 两阶段角色(阶段 1 工作室多 agent 设计 / 阶段 2 单写 ReAct + L3 软检玩家),
# 【非】cheap-line 的策划/编码出 GameConfig|bundle 范式。与 Tier0/1 既有条目01-safety~07-fix完全隔离、互不影响。
# 消费方 = roles.py 经 worker/prompts.py 运行时读本段 file 指向的正文;读不到/脏 → 回落 roles.py 内置原文best-effort绝不中断生成
@ -116,6 +169,8 @@ prompts:
file: 09-tier2-richgame/player-system.md
desc: L3 视觉软检玩家 agent看截图+语义 state 判富游戏体验;只评分绝不当门;带参 input.persona
# ── cheap-worker 便宜档 A-model 生成线 prompt04-configrange=cheap-worker/cheap_roles.py──────────
# 【三态·段B处置】config.cheap-system = livecheap_roles.py 运行时读,便宜档生成主力面),但无 eval 金标集
# → 段 B 真模型闸 fail-closed 报「金标缺失」(补金标后即真跑,见头部对账总表)。
# 消费方 = cheap_roles.py 经 _load_system_prompt() 运行时读本段 file 指向的正文;
# 读不到/脏/缺文件 → 回落 cheap_roles._SYSTEM_PROMPTbest-effort绝不中断生成
# 首版正文 = _SYSTEM_PROMPT 内置原文逐字节对齐(含 ⟦G⟧/⟦SCAFFOLD_DESC⟧ 占位符),默认行为字节不变;