att-mz-releaselisted
Install: claude install-skill yexi-by/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/` 是维护者资料,不是发行版翻译流程执行契约;执行翻译时不要读取源码 wiki、数据库表或维护者文档来替代本 Skill、CLI JSON 输出和当前工作区文件。
## 运行面
- `<发行版目录>` 是 A.T.T MZ 发行包目录。默认命令是 `<A.T.T MZ 可执行文件> <命令> ...`。
- 翻译流程内 `<发行版目录>` 默认只读。未经用户明确允许,严禁修改源码、测试、配置、提示词、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` |