| name | maintain-knowledge |
| description | 维护项目第一类知识（knowledge/）与索引（indexes/）的总入口：目录速查、维护任务路由（细节在各扩展 Skill）、通用知识卡维护、运行脚本、安全规则。修改 knowledge/、新建知识卡、或需决定"用哪个维护 Skill"时参考。 |
知识库维护
在 Project_Main/ 打开的工作区中，Agent 负责维护第一类知识（knowledge/）及相关设施。
目录速查
| 目录 | 性质 | 维护方式 |
|---|
knowledge/ | 第一类，Git 追踪 | 人工撰写/审核，Agent 辅助 |
.cache/ | 第二类，Git 忽略 | 脚本生成，禁止手动编辑 |
_repos/ | 第三类，Submodule | 上游维护，只读引用 |
indexes/ | 索引，Git 追踪 | 内容变更后同步更新 |
.github/experience/ | 经验（广义知识），Git 追踪 | 随翻译追加 + 日常维护（见「经验文件维护」） |
scripts/ | 工具脚本 | 按需修改 |
维护任务决策（用哪个 Skill）
| 任务 | 用哪个 Skill |
|---|
| 术语登记（英→中） | term-registration |
| CSV 读写/表头列含义 | csv-rules |
| 索引格式/版本/时间戳 | indexing-rules |
| 外部仓库索引生成/更新判断 | index-repos（scripts/check_index_stale.py） |
| 术语表加载/四级查找 | use-glossary |
| Wiki 抓取/兜底 | wiki-tools |
| 通用知识卡 | 本 Skill #通用知识卡 节 |
| 经验/日志维护（ASR 分层、coverage 流水、经验提炼、超限整理） | 写入按 term-registration / translate-redstone 阶段三；超限整理按本 Skill「经验文件维护」 |
术语体系（防混淆）
三个"词汇表"的区分表见 use-glossary Skill 开头（项目术语库 / 拆分术语缓存 / 上游术语表），此处不重复。
维护视角：
- Agent 只写入
knowledge/01_terminology/_uncategorized.csv，不触碰 .cache/glossary/（脚本生成）与 _repos/（只读）
- 具体的术语文件清单见
indexes/knowledge/
knowledge/01_terminology/ 结构
此目录不仅包含游戏术语，还包含翻译所需的各类参考信息：
knowledge/
├── _template_knowledge.md # 通用知识卡模板（唯一权威，位于 knowledge/ 根）
├── 01_terminology/ # 术语表 CSV
└── 02_mechanic/ # 机制知识卡
knowledge/01_terminology/
├── _example.csv # 表头模板（所有 CSV 共享同一表头）
├── _uncategorized.csv # Agent 自动登记的新术语（待人工分拣）
├── *.csv # 人工分拣后的各类术语表（redstone.csv、people.csv 等）
├── *.md # 术语知识卡（<英文术语>.md）
└── ... # 按需扩展
所有 CSV 共用 _example.csv 中的表头。Agent 只写入 _uncategorized.csv，不创建其他 CSV。具体的术语文件清单见 indexes/knowledge/。
术语同步机制
Agent 只写入 _uncategorized.csv，不擅自归类。人工定期分拣到对应类别的 CSV。
登记流程（触发条件、同步步骤、ASR 映射登记）统一按 term-registration Skill 执行。
文件格式与规范（指针）
- 长篇机制说明：
knowledge/<分类>/<词条>.md（含 YAML frontmatter）
- 术语/人物/组织：CSV，共享
_example.csv 表头；Agent 新建术语只能写入 _uncategorized.csv
- CSV 表头列含义：
csv-rules Skill（唯一权威）
- CSV 读写规范：
csv-rules Skill（编码/解析/写入）
- 版本标注：
indexing-rules Skill
通用知识卡
记录一条词汇/概念/机制的知识要点——定义、语境用法、翻译注意事项等（通用术语 CSV 未覆盖的部分）。
模板
- 唯一权威模板：
knowledge/_template_knowledge.md
- 每词/每概念一卡，文件命名
<英文术语>.md；术语类卡片放 knowledge/01_terminology/，机制类卡片放 knowledge/02_mechanic/
- 卡片结构：YAML frontmatter（
term/aliases/category/source/version/status）+ 3 分区（要点/翻译注意事项/备注）
创建时机
以下情况创建或更新知识卡：
- 翻译中发现某词/概念有值得记录的语境用法、特殊指代或翻译注意事项（如
main storage 在本视频指 Wavetech 全物品仓库）
- 用户明确要求登记某词条/概念
维护规则
status：新建为 待审核；用户确认后改 已确认。待审核 卡片不作为标准译名依据（与 [待审核] 术语同理）- 版本标注遵循
indexing-rules（[通用]/[1.21+] 等）
- 卡片创建/内容变更后，同步更新
indexes/knowledge/ 下对应索引
与相关机制的区分
| 机制 | 记录什么 | 落点 |
|---|
术语登记（term-registration） | 标准译名（英→中） | _uncategorized.csv |
| 通用知识卡（本节） | 词汇/概念的知识要点、语境用法、翻译注意事项 | <术语>.md 知识卡 |
陷阱词（use-glossary） | 防固有思维漏查的陷阱词（触发层，与词汇表正交） | trap_words.md |
经验文件维护（.github/experience/，广义知识）
.github/experience/ 沉淀翻译经验（广义知识），维护如下。
文件地图
| 文件 | 内容 | 写入门槛 |
|---|
asr_fixes.md | ASR 误识别（跨视频通用，按正确词聚合） | 只收跨视频可复用；~100 条上限 |
coverage_log.md | 数据源覆盖流水 | 每视频一行流水 |
source_experience.md | 数据源经验沉淀（收敛型） | 见「经验提炼规则」 |
glossary_categories.yaml | 术语表分类预判关键词 | 文件头注释（Agent 协助维护） |
trap_words.md | 防固有思维漏查的陷阱词（触发层，与词汇表正交） | use-glossary（随视频识破即追加） |
写入规则（指针）
- ASR 分层登记 →
term-registration「ASR 映射登记」（跨视频通用→全局 / 视频专属→_work/<视频名>/asr_fixes.md）
- 阶段三流水 + 经验提炼 →
translate-redstone 阶段三
经验提炼规则（source_experience.md 写入门槛）
写之前逐条套"三问"（能力 / 盲区 / 下次去哪），只有第 3 问的答案入库。
入库条目必须为 IF-THEN 句式：当〈触发条件〉时 → 查〈数据源/动作〉，因为〈原因〉。（案例：〈一行内嵌〉）
写完自检四问：
- 删掉日期/视频名/数字后还成立吗？——不成立 → 回
coverage_log.md
- 能否指导下一个视频的决策？——不能 → 回
coverage_log.md
- 写明了触发条件（何时用）吗？——没写 → 补上
- 与已有条目重复吗？——重复 → 只合并案例，不新开条
若一次产出 >5 条"规律"→ 重新过一遍以上判据（规律是稀缺的，过多说明在罗列事实）。
日常维护（第③层，不随翻译触发）
asr_fixes.md 超 ~100 条 → 将低价值/视频专属项移走归档到 _work/<视频名>/asr_fixes.mdsource_experience.md 重复结论去重、存量日志/经验定期提炼- 破坏性清理（归档/压缩）遵循
AGENTS.md 核心原则 #6，提示用户手动执行
更新索引
内容变更后，更新 indexes/knowledge/ 下对应索引文件。条目格式与版本标注按 indexing-rules Skill 执行。
- 时间戳：索引文件的「生成时间/最近更新」是刷新判断依据，内容实质变更时同步更新；
_uncategorized.csv 这类高频变动区只保留静态占位，其词条变动不触发索引更新、不更新时间戳（见 indexing-rules「索引时间戳与更新策略」）
运行脚本
| 操作 | 命令 |
|---|
| 拆分术语表 | python scripts/glossary_split.py |
| 检查术语表 | python scripts/glossary_split.py --check |
| 同步 submodule | git submodule update（同步第三方仓库纪律；拉上游最新并重新锁定 → git submodule update --remote） |
| 检查索引是否过期 | python scripts/check_index_stale.py |
安全规则
- 删除规则见
AGENTS.md 核心原则 #6（禁止自动删除，需清理时提示用户手动操作）。
- 只写入
knowledge/、indexes/、.cache/（脚本生成），不触碰 _repos/（只读）。
- 修改
knowledge/ 前确认版本信息准确。
