lili 8ea972340e chore: 工作树散落活账整理提交(多工作线)
- .gitignore:忽略 AgentScope 2.0.2 源码克隆(.claude/skills/agentscope-skill/agentscope/,本机开发直读参考、~17MB、含自带 .git、非本仓产物、可重克隆)
- .claude/skills/agentscope-skill/SKILL.md:agentscope skill 更新
- contracts/prompts/04-config/cheap-system.md:便宜档 system prompt 加「核心操作非无脑」第9条好玩自检(否决项:⑨不命中则①-⑧全中也只是有元素的无趣游戏)+ 决策层与九门自动验收解耦(基础分保盲驱动器过门 / 技巧分给真人爽感)
- game-runtime/evidence/integration/evidence.json:集成 evidence 更新
- game-studio/public/mock-manifests/:U5+U2 真 UI 走查 runbook + walk 脚本 + mock manifest
- wg1/gen-worker/results/gamedef-quickcheck.json:bake-off 结果(同既有 27 tracked 同类)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-01 19:00:42 -07:00
..

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 全量跑。