smashup-faction-implementation

Smash Up 派系玩法实施工作流

适用范围

用于 Smash Up 新派系在 intake 完成后的正式玩法实施：运行时接入、ability / trigger / interaction / base ability 实现、共享机制复用、测试、E2E、evidence 和批量收口。本流程不重新裁定图片、atlas、资源真相源；这些属于 smashup-faction-intake。

进入 implementation 前必须已有 intake 合同和 handoff 包，至少包含主真相源、atlas 几何、row-major 索引、基地元信息、faction 清单、card/base canonical 名称、仍待裁定项和复用风险。intake 未收口时必须停下，不能边猜边做。

执行原则

• 连续推进：用户给出“长期任务 / 继续 / 不要停 / 最后再总结”时，默认清空当前 scope；硬阻塞才停，并写清剩余对象和卡在哪层。
• 一次一个派系：批量任务也按单派系闭环推进：实现、测试、E2E、evidence，再进入下一个派系；禁止多个派系同时改一半。
• 资源完成不等于玩法完成：atlas、locale、选派系入口、静态数据或单测通过，只能证明结构或展示接通；玩法完成必须包含玩法实现、测试、真实入口和 evidence。
• 先复用共享机制：优先查 src/games/smashup/domain/、src/games/smashup/abilities/、src/games/smashup/__tests__/ 是否已有 bury / uncover、ongoing modifier、movement、destroy、duel、before/after scoring、response window 等机制；确实缺共享抽象时再扩展共享层。
• 共享重构默认允许：确认共享抽象缺口后可直接做必要扩展，前提是服务当前和后续派系、不引入一次性硬编码、同步测试与 evidence，并说明影响范围。分支 / worktree / tag、删除本地数据等高风险动作仍需用户确认。
• 新派系 AI 走 outcome 合同：新增行动牌、可发动能力或其它会消耗手牌 / 次数 / 资源的对象时，AI 收益判断必须复用 game-ai-strategy-design 的共享 outcome 合同和 smashUpAiRuntime.projectActionOutcome；旧派系可按触碰范围逐步迁移，但新派系不得再为单卡补“零收益 / 无目标”特例。

批量重审模式

当任务是整批重审、重录或补证时：

1. 建立批次对象清单，粒度到单卡、单基地或单 effect atom。
2. 每项标注证据轴：未核图 / 已核图 / 已修数据 / 已过最终状态 / 已过真实入口 / 已过生命周期。
3. 用户说“继续”默认推进下一个未完成对象，不重复汇报上一个对象。
4. 抽样发现 HIGH / CRITICAL、语义反转、ID 漂移、注册不触发或旧测试沿错语义时，旧“全面 / 收口”结论失效，必须回到全量矩阵。
5. 批次清单仍有未完成对象时，只能写“仍有残余范围”。

effect atom 是重审最小单位。一张卡包含多个动作时，按目标选择、摧毁、额外打出、洗牌 / 重排等自然语义拆开；每个 atom 必须追到描述限定词、静态字段、command / validator、handler / reducer / trigger、UI / 交互出口、测试和证据。若测试断言沿错语义，测试本身就是 finding。

结论等级

对外汇报必须选择当前证据能支撑的等级：

• 结构审计通过：静态接入、注册、targetType、defId 或结构测试通过；不证明玩法。
• 代表性玩法已验证：有行为级测试和至少一条真实规则链路，但不是全对象覆盖。
• 当前发布口径已收口：当前计划发布范围内，结构、行为、真实入口、生命周期和残余范围声明都闭合。
• 仍有残余范围：仍有未审家族、共享根因、交互链或验证缺口。
• 旧结论失效：旧 audit / rollup / closeout 被新证据推翻，必须回写原文档。

只说“审计 / 重审 / 收口审计”时，默认是对已锁定对象范围做对象级审计，不自动扩大到整批派系。只有所有对象都有对象级结论，或明确登记为共享链路完全同构、仅配置不同，才允许写“当前发布口径已收口”。