# Claude Code 子代理教程：分工审校中英界面词条与占位符

## 身份和范围

本站原创 fixture 与人工参考；实际运行：六项真实结构审校结果。目标代理模型、账号会话、付费 API、第三方 PR、推送和发布均未执行。公开包不含 .env；需要时仅在自己的临时练习目录从文本模板创建。

## 本地命令

```sh
python3 verify.py
```

## 七步原生操作

### 1. 读入两份界面词条而不是商品描述

先比较 locales/zh-CN.json 的 48 键与 en.json 的 47 键，定位 welcome、files、checkout 等真实输入。glossary.json 固定 Checkout/Save 术语；不要先自动补齐，保留漏键和孤立键作为审校真值。

### 2. 创建三个只读子代理

将 .claude/agents/keys.md、variables.md、terms.md 放进练习项目。每个 frontmatter 的 tools 仅列 Read, Glob, Grep，分别负责键集合、插值/复数、术语。启动后通过 /agents 检查代理可见性，避免给审校代理 Edit/Write。

### 3. 分别提交有边界的审校任务

让 keys 对比两侧 key，variables 比较 {name}/{user} 与 plural other 分支，terms 按术语表检查既有英文。要求每条返回 key、语言、原片段、问题类别和不确定性；不要让三个代理重复翻译整份文件。

### 4. 按 key 合并证据并去掉重复项

主会话收集子代理结果，按 key+类别合并；missing_en 与 glossary_review 是不同类型。遇到代理只说“翻译不自然”却不给原片段，退回补证据，不能把主观判断写成语法错误。

### 5. 运行有限的确定性结构审计

执行 python3 verify.py，读取 result.json 的六项问题：两个漏键、一个孤立键、一个变量不一致、一个缺 other、一个术语待审。检查器是有限模式审计，不是完整 ICU parser；完整语法与语义仍需对应运行库检查。

### 6. 把模型发现逐项定位回文件

逐项核对 welcome 的变量名和 files 的 other 分支，观察 checkout 的 Submit 是否符合团队术语。保留“已结构证实”和“人工语言待审”两列；禁止仅凭模型总分认定所有界面可发布。

### 7. 留下可交接的审校清单

输出实际 i18n-audit.json，并保存代理分工和完整输入版本。修复翻译是后续独立动作；这次先冻结原文件、问题清单及人工确认者，便于换译者继续处理。

## 验收产物

三个只读审校代理配置；按 key、语言、问题类型、原始片段、建议处理汇总的 i18n-audit.json 与人工审校清单

## 门槛

- 子代理依托 Claude Code 账号与模型额度；并行审校会增加 token 消耗。
- 配置可用工具为 Read/Glob/Grep；不让代理编辑翻译文件。
- ICU 语义与文案自然度保留人工复核，不把无报错视为正确翻译。

## 官方来源

- https://code.claude.com/docs/en/sub-agents

静态配图冻结于本次输入。修改输入需重新运行并自行重渲染；不把旧截图当新结果。