---
name: shared-vocab-rules
description: 团队共用的词库读写规则。被 role-ux、role-translator 引用，也被 tvu-design-mockup 的 Bridge step 引用处理 UI 文案。不单独触发。
---

# 公共词库规则

适用于 UX 设计师、翻译助手两个角色，以及 mockup 设计时的 UI 文案处理。各角色 Skill 中标注了各自的术语提取范围。

## 词库文件位置（plugin 化后）

**SoT**：`${CLAUDE_PLUGIN_ROOT}/skills/shared-vocab-rules/vocabulary.md`

- 团队共享，跟 plugin 一起 git 跟踪
- 更新机制：直接编辑该文件 → commit + push 到 plugin repo → 团队成员 `claude plugin update tvu` 拿到最新
- 写入操作（角色自动追加新词条时）写入同一路径——commit 由 plugin 维护者周期性整理

## 术语一致性规则

- 激活角色时读取词库 SoT，将其中已有词条作为本次对话的**用词/翻译基准**
- 后续回答中优先复用词库中已确认的专有名词和操作名称，保持跨产品、跨对话、跨团队成员的表达统一
- 若用户使用了与词库不一致的表达，轻提醒并使用已确认的版本（如："这里建议统一用 'user flow'，和之前保持一致"）
- 本次对话中新确认的术语，同步写入词库，供后续对话复用
- 使用词库词条时，同步检查其**语法准确性**和**当前通用程度**；若发现已有更主流、更符合当前语境的表达，**补充新词条**而非替换旧词条，并在回答中说明两者差异
- 对于热点、新兴词汇（如 AI 相关、直播行业新术语），更新频繁，优先补充最新表达，保留旧词供参考

## 词库录入规则

每次回答/翻译后自动执行：

1. 从回答中提取角色对应范围的**专业术语和搭配短语**，排除过于基础的通用词
2. 每次回复后直接写入词库；写入规则：
   - **替换**：用户在当前对话中对同一概念给出更好的表达（优化同一词条）
   - **补充**：已有词条随时间变得过时或发现更主流的替代表达（保留旧词，新增新词并在备注中标注关联）
3. 检查词库 SoT，跳过已存在的词条（去重）
4. 将新词条追加写入词库 SoT，首次学习日期填当天，下次复习日期为 +1 天，复习次数为 0，状态为"学习中"
5. 无需用户确认，静默完成写入