rule-bug-fix-workflow

name	rule-bug-fix-workflow
description	BoardGame 规则 bug 修复流程。用于卡牌、技能、Token、状态、阶段、伤害、资源、升级/基础差异、结算顺序和审计漏审。

规则 Bug 修复流程

先读

• 合同门禁：docs/ai-rules/rule-contract-audit.md
• 回归收口：docs/ai-rules/regression-closeout.md
• 全面审计入口：docs/ai-rules/testing-audit.md
• 全面审计核心原则与矩阵：docs/ai-rules/testing-audit-core-principles.md
• 录入复核：.codex/skill/data-entry-workflow/SKILL.md
• 全面游戏审计：.codex/skill/game-audit-workflow/SKILL.md
• 不确定入口时：docs/ai-rules/doc-index.md

判层

• 跨游戏判断方法：锁症状、查合同、判实现消费、回写合同、补回归、同类扩审。
• 当前单游戏答案：具体卡牌原文、技能等级差异、骰面公式、图标裁定、结算数字。
• 单游戏答案下沉位置：docs/games/<gameId>/...、对应 evidence、用户故事、规则矩阵或专项 workflow。

禁止把当前游戏的专属规则答案写进项目通用层。

执行顺序

1. 锁原始症状
   • 写清反馈断言指向哪个对象、哪个等级/版本、哪个状态并存、哪个时机、哪个最终结果。
   • 反馈断言包括对话描述、线上反馈记录、截图/红圈标注、日志解释、测试观察和交接摘要里的 bug 表述；它们都只是待核对输入，不是自动真相。
   • 不得把排查中发现的外围异常替换成本轮目标。
2. 找已有录入合同
   • 先查规则文档、录入表、evidence 子句表、user story、静态数据和当前描述。
   • 判断合同是 locked / blocked / disputed / 未找到。
   • 必须先把反馈断言与当前技能/卡牌/Token/状态描述逐项比对；反馈断言不是自动真相，当前描述也不是免检真相。
3. 判断是不是实现消费错误
   • 合同 locked 且实现与合同冲突：按实现 bug 处理。
   • 反馈断言与当前合同一致：优先检查实现是否正确消费合同，不要先重看图片。
   • 反馈断言与当前合同不一致：先回图面、规则书或录入真相源复核；确认合同错了再修合同和实现，不得直接按反馈断言改规则逻辑。
   • 合同缺失、冲突或反馈断言与合同冲突：回 data-entry-workflow 复核，不得直接改规则逻辑。
4. 拆原子断言
   • 至少拆出触发时机、可选/必须、资源消耗、状态授予/消费、伤害或最终状态、基础版/升级版差异。
   • 对“同时拥有多个状态”“先后结算”“低数值边界”“已持有状态再获得状态”必须单列断言。
5. 最小修复
   • 优先修直接消费点、共享 helper 或时序根因。
   • 若根因是共享抽象错误，必须扩到共享层修；不得只给单对象打补丁。
6. 同步合同入口
   • 同步中文/英文描述、能力定义注释、升级版描述、测试断言、evidence 或用户故事。
   • 旧错误描述未清干净时，不得说规则 bug 已收口。
7. 补回归验证
   • 引擎/规则问题至少补单测或 GameTestRunner 断言。
   • UI 入口问题按 docs/ai-rules/e2e-verification.md 决定是否需要 E2E 与截图。
8. 同类扩审与漏审复盘
   • 查同名基础版/升级版、同族对象、共享 helper、同一状态字段、旧测试和旧 evidence。
   • 写清为什么这次旧审计或旧测试没挡住；必要时更新通用规范或单游戏文档。

不做什么

• 不把旧测试、旧 i18n、旧注释当作规则真相。
• 不在已锁合同齐全时反复重读图。
• 不用相邻技能、同家族高级版或旧实现习惯替代当前对象合同。
• 不把止血、跳过、禁用目标、吞异常说成根因修复。
• 不把单游戏规则答案升格为项目通用规则。

最终汇报

必须包含：

• 原始症状与目标对象。
• 录入合同状态和路径。
• 结论：实现 bug、录入合同 bug、二者都有、还是证据不足。
• 改动覆盖：实现、测试、中文/英文描述、evidence 或用户故事。
• 验证命令与结果。
• 同类扩审范围与漏审复盘。