专业游戏数值策划 Worker
目标
保留独立的确定性数值能力工具。工具从受授权的配表、CSV、数值文档或结构化工作簿快照建立 统一数值模型，检查完整性和专业规则，运行场景、敏感性和候选比较，并在获准时把选定方案交付为受审 MR。
该能力服务游戏数值策划、游戏 Producer 和负责配置交付的开发人员。它不替代策划目标、体验判断、Producer 审批或载体系统的写入权限。
Owner 与事实源
- 产品合同和需求/AC：本目录及
catalog/features.json，ownerDOC。 - 独立能力工具：固定 DSP 来源 revision，owner
DSP；旧 Action/Profile 接线已退役。 - 旧 Plane Run 自动调用路径已停用；Symphony 执行状态由执行服务提供。数值专业工具保留不等于其旧 Worker Action 仍可运行。
- 数值源数据：工作项所指向的 owning repository / Plane Page / Luban 配表；临时
source_ref不是真源。
产品边界
保留的数值工具只做受控输入上的确定性分析，不读取任意路径、不联网、不持有 Plane/GitLab 凭据或执行终态权限。实际载体修改由各自 owning domain 完成。
旧 game_numeric_review/game_numeric_change Run 编排与 project2 Profile 接线已删除，不作为当前运行入口。独立工具存在不等于 Symphony 已自动装配；需要使用时必须由项目明确配置，并遵守 Issue 委托和人类验收边界。
核心需求
ADP-DEV-REQ-DOC-0001：受控来源与可追溯性
来源扫描只能接收调用方已获授权的结构化内容。每份来源生成内容寻址 source_ref 和哈希；公式错误、硬编码常量、
单位候选和截断警告必须保持可见。工具不得把缺失、公式失败或不可用结果转换成健康零值。
ADP-DEV-REQ-DOC-0002：标准数值模型
game.numeric-model.v1 至少表达目标、参数、单位、可调范围、公式、指标、经济流、成长点、概率分布、容量、硬约束和
来源定位。语义映射由数值策划 Agent 明确提交；缺值、歧义、未知引用和非法表达式必须使模型保持 incomplete，
不能静默猜测。
ADP-DEV-REQ-DOC-0003：确定性专业分析
能力面必须提供来源扫描、模型编译、专业审计、场景推演、敏感性排序、候选比较和只读变更集七个工具。审计覆盖 完整性、单位、经济、成长、概率、舍入和容量。候选比较分别呈现约束、指标、退化项和 Pareto 状态，不能只返回 一个无法解释的总分。
ADP-DEV-REQ-DOC-0004：只读评审 Action（退役）
旧 Run-backed 只读岗位编排已退役，历史实现与评审证据保留固定来源，不继续调用旧入口。
ADP-DEV-REQ-DOC-0005：受审变更 Action（退役）
旧 Run-backed 变更岗位编排已退役。独立数值变更集工具仍可输出计划，但不提交 MR 或自动写业务对象。
能力清单
| 工具 | 业务结果 |
|---|---|
game_numeric_source_scan | 结构化来源和 source_ref |
game_numeric_model_compile | ready 模型或明确的 unresolved/blocker |
game_numeric_audit | 分级 findings 与规则包汇总 |
game_numeric_scenario_run | KPI、资源变化、容量与约束结果 |
game_numeric_sensitivity_rank | 参数弹性、边界与非线性排序 |
game_numeric_candidate_compare | 每个候选的取舍、退化与 Pareto 状态 |
game_numeric_change_set_build | 不执行写入的精确变更清单 |
验收概要
- 相同来源和映射产生相同内容哈希、模型和计算结果。
- 损坏公式、未知引用、单位不一致、概率非法和硬约束失败不会被隐藏。
依赖与缺口
- 旧 Plane Automation Host、automation-spawn 和终态协议依赖已删除，不是独立能力工具的前提。
- 依赖 GitLab/Workspace/Luban owning tools 完成实际载体修改。
- 当前工作簿输入合同是结构化 workbook snapshot；原始二进制 XLSX 的授权提取由独立载体适配器负责，数值引擎不接收路径。
- package 发布、Project profile 安装和 runtime 激活不由本文或源代码合并自动完成。
- 当前功能状态为 draft；只有来源锁定、实现 MR 外部 CI、独立评审以及后续发布/激活门全部成立后，才可提升成熟度。