Skill文档中译助手

要解决什么问题

Skill 的正文基本是英文写的：SKILL.md 的正文、description 字段、触发条件说明、示例输出，全是英文。团队里负责维护的同事要确认某个技能「到底什么时候该触发」「参数怎么传」，只能硬着头皮读英文，或者干脆不看，导致技能接了但不会用。手工翻译更坑：复制一段改一段，--- 分隔符容易丢，代码块里的内容被顺手「优化」了，最后这份中文文档和原始技能已经对不上。

技能如何工作

@user_0e283c8b/skill-translator-zh 把这件事做成一条固定流水线：

• 确定翻译目标：先问清楚是单个技能、多个技能还是指定文件；没指定就列出当前已安装的技能让对方挑。
• 读取并分析源文件：定位 YAML frontmatter 的边界（--- 包裹），识别所有代码块，解析标题层级和列表结构。
• 翻译正文，跳过不可动部分：代码块完全不译，行内代码、URL 链接、文件路径（如 scripts/init_skill.py、~/.workbuddy/skills/）、命令行示例、YAML/JSON 配置示例一律原样保留。
• 术语分层处理：API、SDK、YAML、frontmatter 这类公认术语保留英文；首次出现的词采用中英对照，比如 frontmatter（前置元数据）、skill（技能）；普通字段直接翻译，description → 描述、usage → 用法。
• 写回结果：默认覆盖写入原路径，保持文件结构不变。

需要注意的边界

• 覆盖写入是不可逆操作，动手前最好确认目标路径没指向只读目录。
• name 字段值通常保留英文原名，别为了好看把技能标识符也译了，会让调用链断裂。
• 术语对照只在首次出现时标注，同一个文档里反复中英夹注会很啰嗦。
• 本技能只处理文档翻译，不会去改脚本或配置的实现逻辑，也不负责批量同步已安装技能的缓存。