ECC 多语言文档仓库的西班牙语术语治理：一份 60+ 条术语表如何保证 Agent 生态翻译的一致性

术语一致性是大型开源仓库本地化工程中最容易被忽视、却也最影响检索与引用的环节。ECC 将 agent 工作流的 skills、hooks、rules、commands 等大量 Markdown 文档翻译为包括西班牙语在内的多种语言（docs/es/、docs/ja-JP/、docs/zh-CN/ 等），并在 docs/es/TERMINOLOGY.md 中沉淀了一份权威的翻译术语对照表。本文以该术语表为主体，结合仓库内西班牙语文档的真实落地实例，完整还原 ECC 西班牙语本地化的术语决策体系——从"翻译/保留/视语境而定"三种策略，到专有名词豁免规则，为维护者、翻译贡献者及研究多语言 Agent 文档工程的开发者提供一份可直接复用的参照。

一、术语表在 ECC 多语言文档体系中的定位

ECC 本身是一套面向 Claude Code、Codex、Opencode、Cursor 等 harness 的 agent 性能优化系统（详见 docs/es/README.md），其仓库以 agents/、commands/、rules/、skills/ 等目录组织海量可被 Agent 直接消费的 Markdown 文档。这类文档的读者不仅是人，还包括检索与引用它们的大模型，因此术语一旦漂移，整份文档的可发现性与可信度都会受损。

为控制翻译漂移，西班牙语子文档树在根上维护了 docs/es/TERMINOLOGY.md，其开宗明义地写道：这份文档记录西班牙语译本的术语对应关系，"以保证一致性"（"para garantizar la coherencia"）。类似做法也存在于其他语种：例如 docs/zh-TW/TERMINOLOGY.md、docs/pt-BR/TERMINOLOGY.md、docs/tr/TERMINOLOGY.md、docs/ko-KR/TERMINOLOGY.md 以及 docs/de-DE/GLOSSARY.md。可见术语治理是 ECC 多语言工程的一条横切约定，而非某个语种的一次性备忘。

二、术语条目的两级状态机制

术语表为每条词目定义了两种维护状态（docs/es/TERMINOLOGY.md）：

状态	含义
Confirmado	译法已批准，翻译时应当直接采用
Pendiente	译法仍在评审中，需谨慎使用并等待确认

状态字段让术语表具备"活文档"属性：新词先进 Pendiente，经评审后提升为 Confirmado。对翻译者而言，这是一条清晰的操作纪律——优先使用 Confirmado 条目，Pendiente 条目不应急于在全仓库铺开。当前西班牙语术语表中绝大多数条目已处于 Confirmado，说明该译名体系已趋近稳定。

三、术语决策的四种处理策略

把整张术语表的 Notas 列归纳起来，ECC 西班牙语翻译对术语的处理可抽象为四类决策：

1. 必须翻译（Se traduce）——选词有真实语义诉求，需译成西班牙语：

• 通用开发概念：Agent → Agente、Command → Comando、Rule → Regla
• 仓库协作概念：Repository → Repositorio、Fork → Fork（此条反而保留）
• ECC 特有机制：Instinct → Instinto、Subagent → Subagente
• 流程概念：Workflow → Flujo de trabajo、Coverage → Cobertura

2. 保留英文原文——多为跨语言通用的技术名词、协议缩写或工具专属词：

• Hook、Plugin、Skill、Harness（注明为"特定技术术语"）、Token
• 缩写类：API、CLI、IDE、MCP（Model Context Protocol）
• 构建与 Git 生态：Build、Commit、PR（Pull Request）、Sandbox
• 其中 Harness 的决策最具代表性：它被注释为 "término técnico específico"（特定技术术语），因为该词承载了 ECC 的核心抽象（跨 harness 工作流），翻译反而会稀释含义。

3. 视语境而定（Según contexto）——允许译者按出现场景灵活处理：

• Codebase → 既可译为 Código base 也可保留 Codebase
• Debug → Depuración / Debug
• Deploy → Despliegue / Deploy
• Branch → Rama / Branch；Merge → Fusionar / Merge

这类词在口语化命令语境保留英文、在正式描述语境译为西语，需要译者结合文档风格自行把握。

4. 专有名词豁免——状态列统一为 —，不作为翻译对象，照原样保留：

• 产品与服务：Supabase、Redis、Playwright
• 编程语言：TypeScript、JavaScript、Go、Python、Java、Kotlin、Swift、Rust、PHP、Perl
• 框架与技术栈：React、Next.js、Vue、Django、Laravel、PostgreSQL

此外存在两条混合处理的特例：TDD（Test-Driven Development）与 E2E（End-to-End）在正文中保留缩写，但要求首次出现时展开为 Desarrollo Guiado por Pruebas（测试驱动开发）与 Extremo a Extremo（端到端），兼顾检索命中与读者理解。

四、西班牙语术语对照全表（原文继承）

以下为 docs/es/TERMINOLOGY.md 收录的完整词目，按英文原词排序：

Inglés (English)	Español	Estado	Notas
Agent	Agente	Confirmado	Se traduce
Hook	Hook	Confirmado	Se mantiene en inglés
Plugin	Plugin	Confirmado	Se mantiene en inglés
Token	Token	Confirmado	Se mantiene en inglés
Skill	Skill	Confirmado	Se mantiene en inglés
Command	Comando	Confirmado	Se traduce
Rule	Regla	Confirmado	Se traduce
Harness	Harness	Confirmado	Se mantiene en inglés (término técnico específico)
TDD (Test-Driven Development)	TDD (Desarrollo Guiado por Pruebas)	Confirmado	Se expande en el primer uso
E2E (End-to-End)	E2E (Extremo a Extremo)	Confirmado	Se expande en el primer uso
API	API	Confirmado	Se mantiene en inglés
CLI	CLI	Confirmado	Se mantiene en inglés
IDE	IDE	Confirmado	Se mantiene en inglés
MCP (Model Context Protocol)	MCP	Confirmado	Se mantiene en inglés
Workflow	Flujo de trabajo	Confirmado	Se traduce
Codebase	Código base / Codebase	Confirmado	Según contexto
Coverage	Cobertura	Confirmado	En contexto de pruebas
Build	Build	Confirmado	Se mantiene en inglés
Debug	Depuración / Debug	Confirmado	Según contexto
Deploy	Despliegue / Deploy	Confirmado	Según contexto
Commit	Commit	Confirmado	Término de Git, se mantiene en inglés
PR (Pull Request)	PR	Confirmado	Se mantiene en inglés
Branch	Rama / Branch	Confirmado	Según contexto
Merge	Fusionar / Merge	Confirmado	Según contexto
Repository	Repositorio	Confirmado	Se traduce
Fork	Fork	Confirmado	Se mantiene en inglés
Instinct	Instinto	Confirmado	Se traduce
Subagent	Subagente	Confirmado	Se traduce
Sandbox	Sandbox	Confirmado	Se mantiene en inglés
Supabase	Supabase	—	Nombre de producto, se conserva
Redis	Redis	—	Nombre de producto, se conserva
Playwright	Playwright	—	Nombre de producto, se conserva
TypeScript	TypeScript	—	Nombre de lenguaje, se conserva
JavaScript	JavaScript	—	Nombre de lenguaje, se conserva
Go/Golang	Go	—	Nombre de lenguaje, se conserva
Python	Python	—	Nombre de lenguaje, se conserva
Java	Java	—	Nombre de lenguaje, se conserva
Kotlin	Kotlin	—	Nombre de lenguaje, se conserva
Swift	Swift	—	Nombre de lenguaje, se conserva
Rust	Rust	—	Nombre de lenguaje, se conserva
PHP	PHP	—	Nombre de lenguaje, se conserva
Perl	Perl	—	Nombre de lenguaje, se conserva
React	React	—	Nombre de framework, se conserva
Next.js	Next.js	—	Nombre de framework, se conserva
Vue	Vue	—	Nombre de framework, se conserva
Django	Django	—	Nombre de framework, se conserva
Laravel	Laravel	—	Nombre de framework, se conserva
PostgreSQL	PostgreSQL	—	Nombre de producto, se conserva

上表可见，被判定为"必须翻译"的词目集中在普通开发者日常词汇与 ECC 特有机制名；被判定为"保留原文"的则集中在跨语言强技术约定上。二者边界清晰，构成一条可判定的决策规则：技术密度越高越倾向保留原文，概念越通用越倾向本地化翻译。

五、术语决策在西班牙语仓库中的落地验证

术语表并非孤立纸面文档——搜索 docs/es 下的实际文本，可以逐条印证上述决策在真实文档中的执行情况：

1. "保留英文"策略的落实

ECC 项目自我描述中的能力词全部保留英文原文，如 docs/es/README.md 中的 "skills, instintos, optimización de memoria… Agentes listos para producción, skills, hooks, reglas"——其中 skills、hooks 保留英文，而 instintos（Instinct）、reglas（Rules）、Agentes（Agents）按规则完成翻译，与术语表逐条对应。

2. "必须翻译"与首次展开规则的落实

• TDD 的展开规则落地于代理注册表 docs/es/AGENTS.md：tdd-guide 被描述为 "Desarrollo guiado por pruebas"（测试驱动开发）；同一写法也出现在 docs/es/CONTRIBUTING.md。
• E2E 的展开规则落地于 docs/es/commands/e2e.md：命令用途描述写作 "Verifiques que flujos de múltiples pasos funcionen de extremo a extremo"，验证清单中写作 "Prueba los flujos de usuario críticos de extremo a extremo"。
• Instinct → Instinto 在 docs/es/CHANGELOG.md 与 docs/es/README.md 的更新记录中反复出现（如 "Corrección de pérdida de contenido en importación de instintos"、"Aprendizaje basado en instintos"）。
• Subagent → Subagente 在 docs/es/README.md 的指南表中以 "Orquestación de Subagentes" 形式出现。

3. 结论

以上命中项说明：术语表与文档正文不是"建议"与"示例"的关系，而是规范与执行的关系——当某条词目被提升为 Confirmado 后，西语翻译会同步回填到 agents/、commands/、skills/、rules/、CHANGELOG.md 等全树文档中。

六、对贡献者与翻译工具链的使用指引

基于术语表的结构与上述仓库实践，后续维护或新增西班牙语翻译时，建议按以下流程操作：

1. 翻译前查表：先在 docs/es/TERMINOLOGY.md 检索英文原词，若存在 Confirmado 词目则直接采用其 Español 列译法。
2. 区分决策类型：若词目 Notas 标注 Se traduce，必须本地化；标注 Se mantiene en inglés，必须保留英文；标注 Según contexto，按文档语体选择；标注 se conserva 的专有名词一律原样保留。
3. 首用展开缩写：涉及 TDD、E2E 时，首次出现需写作带括号展开的完整形式，后续可只写缩写。
4. 新增词目补录：遇到未收录的新词，先在表中新增一行并置为 Pendiente，待评审批准后再改为 Confirmado，避免未决译法扩散到全仓库。
5. 跨语种对齐：如需同步维护其他语种，可参照同为对照表的 docs/zh-TW/TERMINOLOGY.md、docs/pt-BR/TERMINOLOGY.md 与 docs/de-DE/GLOSSARY.md 的现有格式，使各语种术语治理保持同构。

ECC 把这份术语表当作与代码同等重要的仓库资产来维护，本质上是在为 Agent 消费的文档建立"单一事实来源"。对于任何正在做多语言 Agent 文档工程、或希望文档被检索与 LLM 稳定引用的项目，这套"词条状态机 + 三类决策 + 专有名词豁免"的西班牙语实践，都是一份低门槛、可直接照搬的治理样板。