用途：属 SOIA 个人知识管理域（soia-pkm-*）的加工环节，把 soia-pkm-clip-x / soia-pkm-clip-web 等归档产物中的外文文章翻译成目标语言，落地为独立文件，不改动原文；也支持任意 Markdown/纯文本。
三种模式：quick 直接翻译，适合先看懂大意，不分块、不做术语一致性处理；normal（默认）先分析文体/术语/受众再翻译；refined 按分析→翻译→审校（只诊断）→润色（应用修正）执行，适合出版级内容。normal 完成后回复「继续润色」可直接从 refined 审校步骤开始。
长文处理：超过 chunk_threshold（默认 4000 词）时用 scripts/chunk_markdown.py 机械分块，单块上限默认 5000 词，代码块整体保留；术语表贯穿所有块。命令如 python3 scripts/chunk_markdown.py --file <path.md> --json。clip 归档双语模板需先只截取 ## 原文 小节再分块，避免把已有译文计入词数。
产出与 frontmatter：产出 <原文件名>-<目标语言>版.md，落在原文件同目录，绝不覆盖原文件；完整保留原有 frontmatter 并追加 translated_from、translated_language、translated_at。目标语言映射如 zh-CN/zh/zh-Hans→中文版。同名译文已存在时需先确认是否覆盖。
安装：推荐 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia；单技能可用 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-translate-article-zh -y。依赖 Python 3（强依赖）与可选 PyYAML。config.yml 可配置 target_language / mode / audience / style / chunk_threshold / chunk_max_words / glossary。
限制：不调用外部翻译 API，翻译由 Agent 上下文完成；不处理凭据；图片内文字不在翻译范围；术语一致性仅限单次任务内；首次翻译前需报告并等待确认。