用途
wc-decision-logger 用于记录 FIFA World Cup Fantasy 中的决策过程。与普通决策日志不同，它记录的是“在给定选项集合中做出的选择”，包括推荐项、管理者的覆盖决定以及其推理理由。资料指出，三个学习循环依赖这些信息：原型记分板（archetype scoreboard）、揭示偏好（revealed preferences）和专家校准（specialist calibration）。仅记录“选择了 B”无法提供有效学习信号。
主要能力
- 构建日志条目，捕获完整选项集合、最终选择、理由和覆盖标记。
- 以追加方式原子写入 tracker/decisions-log.md，不覆盖已有内容。
- 将每轮生成归档到 generations/<round>/，包含种群、适应度、后代谱系、选项板和管理者选择。
- 更新 tracker/archetype-scoreboard.md，记录哪些基因型的模块被选中。
- 在发生覆盖或修改时，向 manager-profile.md 追加一条揭示偏好备注。
- 返回 decision_id。
使用方式
输入来自 Director，在管理者做出选择后提供：
- 选项板（包含谱系、适应度、方差、异议的选项集合）以及推荐默认项。
- 管理者的选择、任何修改、其陈述的理由、当前生效的目标 θ/k。
工作流程：
- 构建日志条目（按下方 schema），捕获完整选项集合、选择、理由和覆盖标记。
- 原子追加到 tracker/decisions-log.md（绝不覆盖）。
- 将生成归档到 generations/<round>/（种群、适应度、后代谱系、选项板、选择）。
- 更新 tracker/archetype-scoreboard.md（哪些基因型的模块被选中）。
- 在覆盖或修改时，向 manager-profile.md 追加一条揭示偏好备注。
- 返回 decision_id。
条目 schema（依据 decision-log-format.md）：
{iso8601} | {decision_type} | round {round_id}
- decision_id: {round_id}-{decision_type}-{NN}
- objective: θ={..}, k={..}
- board_options: [ A "{handle}" — lineage — fitness — variance ; B … ; C … ]
- recommended_default: {option}
- manager_pick: {A | modified A | own plan}
- manager_modification: {what they changed}
- manager_reasoning: {their stated why — verbatim/close; this is gold}
- override?: {yes/no}
- key_assumptions: {what the pick bets on}
- dissent_carried: {strongest case against the pick}
- confidence: {0–1}
- will_verify_on: {round id}
- outcome: {filled by round-review}
- outcome_recorded_on: {filled later}
- what_we_learned: {filled later}
decision_type ∈ squad-build | matchday | transfer | captain | chip | ad-hoc。
生成归档（进化轨迹）：写入 generations/<round>/<decision_type>.md，捕获整个搜索过程：种群（每个原型的候选与自我异议）、带分解的适应度表、带谱系和修复日志的后代、多样性报告、选项板以及管理者的选择。这是审计搜索过程以及模因学习重建哪些基因型产生获胜模块的方式。
记分板与揭示偏好更新：
- 原型记分板：对于被选中候选中出现的每个基因型模块，增加其“被选中模块”计数。轮次结束后（通过 round-review）附加得分结果，使记分板反映哪些基因型获胜，而不仅仅是被选中。
- 揭示偏好：当管理者覆盖或修改时，向 manager-profile.md 追加一行备注描述其倾向（例如“选择了差异化队长但拒绝第二个冒险 → 会赌队长袖标，而非整支球队”）。这些成为软适应度项。
适用场景
适用于 FIFA World Cup Fantasy 管理场景中需要记录决策过程、选项集合和推理理由的场合，尤其是需要追踪覆盖推荐、修改方案以及管理者偏好的情况。
限制
- 仅追加，绝不覆盖先前条目。结果由 round-review 稍后原地填入。
- 必须始终记录选项集合和理由，而不仅仅是选择。覆盖行是最高价值的训练信号，需捕获管理者的原话。
- 每个决策一条条目；每个决策一份生成归档。保持 decision_id 唯一且按时间顺序。