القائمة
仅在用户明确要求使用 A.T.T MZ 发行版执行或继续 RPG Maker MV/MZ 游戏翻译流程时使用，包括注册游戏、准备工作区、分析术语和文本规则、导入规则、调用模型翻译、检查译文、手动修复、写进游戏文件与试玩反馈补漏。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | att-mz-release |
| description | 仅在用户明确要求使用 A.T.T MZ 发行版执行或继续 RPG Maker MV/MZ 游戏翻译流程时使用，包括注册游戏、准备工作区、分析术语和文本规则、导入规则、调用模型翻译、检查译文、手动修复、写进游戏文件与试玩反馈补漏。 |
本 Skill 是翻译任务执行协议，不是项目说明书。主文件只做路由：触发边界、运行面、阶段索引和硬停止规则。阶段细节、JSON 结构、任务契约和失败恢复按需读取 references/。
doctor --game <游戏标题> --no-check-llm 的 flow_decision、flow_reason 和 flow_next_command 为准；主代理负责执行或解释裁决，不把已能自动判断的问题丢给用户。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-command-contract.md、workspace-schema.md | 运行或排查启动、注册、状态检查和危险回溯前 |
| 工作区与基础候选 | cli-command-contract.md、workspace-schema.md、agent-review-workflow.md、subtask-package-mode.md | 读取、填写、修复、审查、分发任务包或清理工作区 JSON 前 |
| MV 虚拟名字框 | agent-review-workflow.md、mv-virtual-namebox-rules.md、rpg-maker-mv-mz-world-knowledge.md | MV 游戏第零轮规则发现、审查、编写或修复前 |
| 术语工程 | agent-review-workflow.md、terminology-workflow.md、translation-rule-examples.md、subagent-collaboration.md、subtask-package-mode.md | 进入术语工程、派发术语候选、分发术语任务包、审查术语质量、合并字段译名表或制作正文术语表前 |
| 外部文本规则 | agent-review-workflow.md、external-rules-workflow.md、plugin-rules-agent-task.md、event-command-rules-agent-task.md、note-tag-rules-agent-task.md、translation-rule-examples.md、subagent-collaboration.md、subtask-package-mode.md | 处理、主动发现、分发任务包或审查插件、事件指令、Note 标签规则前 |
| 非标准 data 与插件源码支线 | agent-review-workflow.md、nonstandard-data-agent-task.md、plugin-source-text-agent-task.md、workspace-schema.md、subagent-collaboration.md | 风险报告提示高风险，或用户要求处理、主动发现、审查非标准 data / 插件源码文本前 |
| 占位符收束 | agent-review-workflow.md、placeholder-rules.md、structured-placeholder-rules.md、translation-rule-examples.md、subagent-collaboration.md | 编写、审查、覆盖扫描或修复普通/结构化占位符规则前 |
| 正文翻译与手动修复 | cli-command-contract.md、failure-recovery.md、placeholder-rules.md、structured-placeholder-rules.md | 启动正文翻译、解释失败、导出修复表、导入手动译文或重置译文前 |
| 写进游戏文件 | cli-command-contract.md、failure-recovery.md、subagent-collaboration.md | 写进游戏文件、重建当前运行文件、术语专用写入或当前运行审计前 |
| 试玩反馈 | feedback-iteration.md、failure-recovery.md、subagent-collaboration.md | 用户反馈漏翻、误翻、显示异常或插件界面残留源语言文本时 |
不要把参考资料全文复制进模型 prompt、交付报告或子代理任务单；只读取当前阶段需要的小节，并继续以 CLI 输出和当前工作区文件为准。
| 阶段 | 目标 | 命令 | 必读参考 |
|---|---|---|---|
| 启动与注册 | 确认工具入口、游戏结构、工作区、源语言和模型配置可用 | doctor、probe-source-language、add-game、list、reset-game | cli-command-contract.md、workspace-schema.md |
| 工作区与基础候选 | 建立 Agent 分析边界并导出候选、草稿规则和术语上下文 | prepare-agent-workspace、validate-agent-workspace、cleanup-agent-workspace、export-plugins-json、export-event-commands-json | cli-command-contract.md、workspace-schema.md、agent-review-workflow.md、subtask-package-mode.md |
| MV 虚拟名字框 | 为 MV 游戏确认首行虚拟名字框规则 | export-mv-virtual-namebox-candidates、validate-mv-virtual-namebox-rules、import-mv-virtual-namebox-rules | agent-review-workflow.md、mv-virtual-namebox-rules.md、rpg-maker-mv-mz-world-knowledge.md |
| 术语工程 | 统一字段译名和正文术语，避免字段写回表与提示词术语表混用 | export-terminology、import-terminology | agent-review-workflow.md、terminology-workflow.md、translation-rule-examples.md、subagent-collaboration.md、subtask-package-mode.md |
| 外部文本规则 | 判断插件参数、事件指令参数和 Note 标签中的玩家可见文本 | validate-plugin-rules、import-plugin-rules、validate-event-command-rules、import-event-command-rules、export-note-tag-candidates、validate-note-tag-rules、import-note-tag-rules | agent-review-workflow.md、external-rules-workflow.md、plugin-rules-agent-task.md、event-command-rules-agent-task.md、note-tag-rules-agent-task.md、translation-rule-examples.md、subagent-collaboration.md、subtask-package-mode.md |
| 非标准 data 与插件源码支线 | 处理少见的非标准 data 文本和 js/plugins 源码硬编码显示文本 | scan-nonstandard-data、export-nonstandard-data-json、validate-nonstandard-data-rules、import-nonstandard-data-rules、scan-plugin-source-text、export-plugin-source-ast-map、validate-plugin-source-rules、import-plugin-source-rules | agent-review-workflow.md、nonstandard-data-agent-task.md、plugin-source-text-agent-task.md、workspace-schema.md、subagent-collaboration.md |
| 占位符收束 | 保护必须原样保留的控制符和协议片段，同时不吞掉玩家可见文本 | build-placeholder-rules、validate-placeholder-rules、scan-placeholder-candidates、import-placeholder-rules、validate-structured-placeholder-rules、scan-structured-placeholder-candidates、import-structured-placeholder-rules | agent-review-workflow.md、placeholder-rules.md、structured-placeholder-rules.md、translation-rule-examples.md、subagent-collaboration.md |
| 正文翻译与手动修复 | 用小批量发现严重风险，再靠全量多轮重试保存译文，最后小规模手动收尾 | rebuild-text-index、translate、translation-status、text-scope、audit-coverage、quality-report、export-quality-fix-template、export-pending-translations、import-manual-translations、reset-translations、validate-source-residual-rules、import-source-residual-rules、run-all | cli-command-contract.md、failure-recovery.md、placeholder-rules.md、structured-placeholder-rules.md |
| 写进游戏文件 | 生成可试玩汉化结果，并验收当前运行文件 | write-back、rebuild-active-runtime、write-terminology、restore-font、audit-active-runtime、diagnose-active-runtime、run-all | cli-command-contract.md、failure-recovery.md、subagent-collaboration.md |
| 试玩反馈 | 根据实际游玩反馈继续补规则、补译文或定位写入缺口 | verify-feedback-text、quality-report、audit-active-runtime、diagnose-active-runtime、write-back | feedback-iteration.md、failure-recovery.md、subagent-collaboration.md |
<发行版目录> 运行静态检查，确认 CLI 可启动；注册游戏前必须运行 probe-source-language --path <游戏目录>，只按玩家可见文本确认源语言。<工作区>，读取 manifest.json 判断引擎类型。impact_* 字段重建索引、重跑 doctor 或重做写回级检查。rebuild-text-index，再执行小批量翻译，并用 doctor --game <游戏标题> --no-check-llm 读取统一流程裁决；小批量只用于观察模型、规则和控制符风险，不以 0 失败作为指标。ready_to_translate 继续翻译，should_stop_retrying 先补规则或导出修复表，ready_for_manual_fix 进入精确手动修复，ready_to_write_back 再请求用户允许写回；只有需要用户承担额外成本、接受风险或选择完整重译时才询问用户。blocker、warning、info 分级反向审查，主代理写 review-decisions/<阶段ID>.json 后才允许 validate/import。<工作区>/agent-scratch/<阶段ID>/<任务ID>/scripts/，也可以运行只读、导出、扫描、诊断和 validate 类 CLI 命令；禁止任何 import、写回、重建、重置、数据库写入或游戏文件写入。references/subtask-package-mode.md，任务包不能替代审查子代理或主代理裁决。<发行版目录>、<工作区>、<游戏标题>、必要时的 <游戏目录>、输入文件、唯一可写文件和校验命令。selected、excluded、uncertain、active_discoveries、evidence、risk、needs_main_review、recommended_next_action，并列出读取文件、脚本、统计产物和 CLI 命令。findings，每条 finding 都有 severity、target、evidence、impact 和 recommended_resolution；未关闭 blocker 时主代理禁止导入。sleep 控制节奏；不得因短时间无输出就催促、打断、改用半成品裁决或反复读取未变化产物消耗上下文。references/agent-review-workflow.md 与 references/subagent-collaboration.md。<发行版目录> 写翻译临时脚本、中间 JSON、抽样报告或手动译文表。import app... 操作数据库或游戏数据。blocker 时 validate/import。import-*、write-back、rebuild-active-runtime、reset-game、reset-translations、run-all 或直接写数据库/游戏文件。data/*.json，或用空译文伪造重置。