菜单
翻译 Markdown 文档为中文，并格式化为 Obsidian 兼容的 Markdown。用户指定文件或目录路径，翻译 front matter（title 简化翻译、description 翻译）和正文内容，使用 Obsidian Callout 等语法美化输出。触发词：翻译文档、translate、翻译 markdown、doc translate、翻译文件、translate doc。即使用户只说"翻译这个文件"或"把这个翻译一下"也应该触发此 skill。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/luguosong/knowledge-base-lgs --skill doc-translate命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | doc-translate |
| description | 翻译 Markdown 文档为中文，并格式化为 Obsidian 兼容的 Markdown。用户指定文件或目录路径，翻译 front matter（title 简化翻译、description 翻译）和正文内容，使用 Obsidian Callout 等语法美化输出。触发词：翻译文档、translate、翻译 markdown、doc translate、翻译文件、translate doc。即使用户只说"翻译这个文件"或"把这个翻译一下"也应该触发此 skill。 |
将英文 Markdown 文档翻译为中文，同时将输出格式化为 Obsidian 兼容的 Markdown 文档。
这个 skill 做且只做一件事：原地翻译指定的 Markdown 文件。
AskUserQuestion 主动询问。.md 文件，逐个翻译。文件大小 > 30KB 时，必须使用 general-purpose subagent 执行翻译。
原因：大文件翻译需要多次分段读取和多次 edit，容易填满主会话 context；会话压缩后需要重建翻译状态，效率低且容易出错。
操作方式：
Get-Item <path> | Select-Object -ExpandProperty Length）general-purpose subagent，将完整翻译任务（含文件路径、翻译规范、术语约定）作为 prompt 传入用 Read 工具读取源文件内容。
分析文档顶部的 YAML front matter（--- 包裹的部分）：
| 字段 | 处理规则 |
|---|---|
title | 简化并翻译为中文。如果原标题冗长，提取核心含义。如果不存在 title 字段，从文档第一个 H1 标题提取并创建 |
description | 翻译为中文。如果不存在则忽略，不创建 |
| 其他字段 | 保留原样，不做修改 |
title 简化原则：去掉冗余修饰词，保留核心主题。例如 "Getting Started with Spring Security Authentication" → "Spring Security 认证入门"。
目标是产出自然流畅的中文，读起来像是由母语工程师撰写的——而非机器翻译的逐字对应。
术语处理是翻译质量的核心分界线。分四种情况：
情况 1：行业通用英文术语——保持英文，不加注解
在中文技术写作中广泛使用的术语应保持英文原样，不要强行翻译，也不需要附加中文注解：
Spring Boot、Bean、Controller、Handler、Provider、Service、Repository、Promise、Hook、middleware、payload、token、socket、pipeline、callback、namespace、runtime、mock、stub、framework、plugin、schema、endpoint、request、response、session、cookie、header 等。
正确示例：Controller 负责处理 HTTP 请求。
错误示例：Controller（控制器）负责处理 HTTP 请求。
错误示例：控制器负责处理 HTTP 请求。
情况 2：英文术语+首次出现附中文注解
当保留英文术语有助于精确性或符合标准实践时，保留英文，首次出现时在括号中附加简短中文注解：
Interceptor（拦截器）、Circuit Breaker（熔断器）、Service Mesh（服务网格）、Dead Letter Queue（死信队列）
注解只在术语首次出现时添加，后续出现保持纯英文。
情况 3：中文术语+附英文原文
对于翻译成中文的术语，在括号中附加英文原文：依赖注入 (Dependency Injection)、消息队列 (Message Queue)、反向代理 (Reverse Proxy)。
情况 4：纯中文通用术语
如果术语本身已经是中文技术写作中的通用表达（如"数据库"、"服务器"、"线程"、"接口"），直接使用中文，不需要附加英文。
将翻译后的内容按照 Obsidian 兼容的 Markdown 语法进行格式化。
根据原文内容语义，适当添加 Obsidian Callout 提升可读性：
> [!note] 标题
> 内容
> [!tip] 标题
> 内容
> [!warning] 标题
> 警告内容
> [!info] 标题
> 补充说明
适用场景：
note：一般性备注info：补充说明、背景知识tip：实用技巧、最佳实践warning：注意事项、潜在问题danger：严重警告、可能导致数据丢失等example：示例说明abstract：摘要、总结question：常见问题bug：已知问题Callout 语法规则：
> 引用块语法，[!type] 后跟标题> 开头> 前加 > 表示嵌套层级使用标准 Markdown 代码块，Obsidian 原生支持语言标识符高亮：
```java
// 代码内容
```
如果需要标注代码来源文件，在代码块上方用普通文本说明，不使用特殊属性语法。
翻译过程中遇到原文的交叉引用时：
[[页面名]] 双链语法保留原有的 Markdown 表格和列表格式，内容翻译为中文。
依赖注入 (Dependency Injection)** 加粗正文文本完成翻译后，对照以下清单自检：
> [!type] 标题 + > 前缀内容）基于 SOC 职业分类
