att-mz

# A.T.T MZ Skill 本 Skill 是翻译任务执行协议，不是项目说明书。主文件只做路由：触发边界、运行面、阶段索引和硬停止规则。阶段细节、JSON 结构、任务契约和失败恢复按需读取 `references/`。 ## 核心原则 - 业务数据只通过 A.T.T MZ CLI、工作区 JSON、当前游戏目录和用户明确提供的信息流转。 - 任何会消耗模型额度、导入规则、保存译文或写进游戏文件的动作，都必须先满足当前阶段的通过标准。 - 主代理是总控与裁决者：用户确认、规则导入、译文保存、写回许可、字体覆盖和最终风险判断不能交给子代理。 - 运行期下一步优先以 `doctor --game <游戏标题> --no-check-llm` 的 `flow_decision`、`flow_reason` 和 `flow_next_command` 为准；主代理负责执行或解释裁决，不把已能自动判断的问题丢给用户。 - 默认自动推进：除写文件、危险回溯、完整重译、源码/Skill 修改、接受不可逆或用户风险、显著增加额度/时间成本等真实决策外，主代理应自行诊断、修规则、重跑校验、导入修复和收束报告，不把可由流程判断的问题改成中途选择题。 - 子代理分为工作席和审查席：工作子代理主动发现并产出候选，审查子代理反向检查漏选、误选、偷懒、原文残留、过拟合和规则风险；子代理输出只是证据和候选，主代理必须裁决。 - 第一次写进游戏文件只表示生成第一版可试玩汉化结果，稳定版本依赖用户试玩反馈继续补漏。 - `docs/wiki/` 是源码维护者资料，不是翻译流程执行契约；执行翻译时不要读取或引用 docs wiki 来替代本 Skill、CLI JSON 输出和当前工作区文件。 ## 运行面 - `<项目目录>` 是 A.T.T MZ 源码仓库。默认命令是 `uv run python main.py <命令> ...`。 - 翻译流程内 `<项目目录>` 默认只读。未经用户明确允许，严禁修改源码、测试、配置、提示词、Skill、文档、构建脚本、发行脚本或任何项目文件；不得把“顺手修复”“排障需要”“测试失败”“格式化一下”当作源码修改许可。 - `<游戏目录>` 是目标 RPG Maker MV/MZ 游戏目录。首次注册必须使用没有 `data_origin`、`js/plugins_origin.js` 和 `js/plugins_source_origin` 的干净原始目录；注册游戏时由 CLI 创建可信源快照。 - `<工作区>` 是任务临时工作目录。导出文件、规则草稿、任务包、临时脚本和手动填写译文表都放在这里，不能散落到 `<项目目录>` 或游戏根目录。 - `reset-game` 是危险的时光回溯命令，只能在用户明确要求注销、重置游戏或恢复到注册前状态时使用。 - 模型客户端只从 `setting.toml` 读取，命令行只通过 `--llm-client` 选择客户端；模型密钥不写进任务文件、报告或提交。路径、业务参数和可调开关按本地配置或 CLI 参数读取。 - CLI stdout 只读取最终 JSON；长任务的 stderr 进度行是阶段进展，不是结果 JSON。 ## 按需参考资料 | 主要工作 | 必读参考资料 | 读取时机 | | --- | --- | --- | | 启动与注册 | `cli-command-contract.md`、`workspace-schema.md` | 运行或排查启动、注册、状态检查和危...