WorkBuddy Skill 配置实操：自由翻译如何用「预制指令」省掉每天两小时废话

每次接新客户，都要把同一套话重说一遍：术语表用哪个版本、输出格式要 markdown 还是 txt、专有名词不要翻译、标点强制半角、中英文之间加空格…… 烦不烦？烦。说了三年，我决定用 WorkBuddy 的 Skill 一次性封死这个窟窿。

我的环境是 macOS + WorkBuddy 桌面版，不一定适用所有人，但逻辑通用。

现象：AI 对话的「重复劳动」比翻译本身还累

翻译行业有个怪圈：你花 10 分钟翻译一段话，花 5 分钟写指令告诉 AI 怎么改。下次换了个客户，又花 5 分钟重新写。一整天下来，真正在译的不到一半。问题不在 AI 不够聪明，在你每次都在造轮子。

原因：没把「规则」做成可复用的文件

WorkBuddy 的 Skill 本质上就是个文件夹，核心是 SKILL.md。我一开始跟大多数人一样，直接在对话框里写长指令，后来发现一旦关掉对话，上下文就丢了。第二天再问，AI 又忘了你是谁。

后来我照官方文档建了第一个 Skill，叫 trans-en-zh。

操作路径：打开 WorkBuddy → 点左侧「Skills」→ 点「新建」→ 输入名称 trans-en-zh → 系统自动生成 ~/.workbuddy/skills/trans-en-zh/ 文件夹。里面默认只有 SKILL.md。

SKILL.md 头部必须写 YAML 元数据：

---
name: 英译中_技术文档
description: 仅当用户明确说“翻译”且提到客户名称时激活
agent_created: true
---

description 我踩过坑，一开始写得太宽泛（比如“帮助用户翻译”），结果我问“这个 API 文档怎么看”，它也跑出来说“请提供文本”。后来改成精确匹配关键词，只对“翻译 XX 客户的文件”才触发。

然后写正文规则。我放了这些：

• 术语表路径：references/glossary.csv，每次翻译前自动加载
• 输出模板：templates/dual-column.html，中英对照，客户要求
• 格式规则：专有名词不译，保留原文用 * 标记
• 质量检查：调用 scripts/qa-check.py 查漏译和标点

落地配置方案：关键参数不是越多越好

我这套 Skill 里最核心的参数就三个：

• trigger_keywords 写在 YAML 的 description 里，我只写“翻译”和每个客户的简称，比如“客户A”“客户B”。这样日常问别的（比如“今天天气”）不会误触发。
• output_format 强制为 markdown，但模板里定义了 HTML 渲染，因为客户要直接复制到 Notion。我在 templates/ 下放了一个 final-output.md 作为中间格式，再通过 scripts/ 里的 md2html.sh 转换。这样 debug 时也能看原始 markdown。
• compliance 规则放在 COMPLIANCE.md：敏感词库（客户禁止的行业术语）、字数限制（每段不超过 200 字）。

权限/协作策略：一个人用，但也要防手滑

我只有一个人用，但 Skill 文件夹放在同步盘里，偶尔用 iPad 继续。我做了两件事：

• 所有 Skill 的 SKILL.md 设置 chmod 644，只读，防止误改。要改时手动 chmod 744。
• 不同客户用不同 Skill，命名规则 trans-客户名。description 里写清楚客户名，避免 AI 混淆。比如 trans-google 和 trans-ms 的术语表不同，输出格式也不同。

日常运维技巧：每周五花 10 分钟扫一遍

• 检查 references/glossary.csv 是否有新词未收录。我每周五过一遍上周翻译中遇到的生词，加进去。
• 检查 agents/ 下的子 Agent 配置。我设了一个 qa-agent，专门在输出前跑一遍拼写检查。如果它卡住了，看日志（~/.workbuddy/logs/）定位问题，通常是脚本路径写错了。

避坑经验：最蠢的坑是忘了加 agent_created: true

第一次建 Skill 时，这个字段没加，结果 WorkBuddy 根本不执行 Skill 内的任何规则，只当普通对话。查了两小时文档才发现。另一个坑：scripts/ 里的脚本必须用绝对路径，否则 WorkBuddy 找不到。我一开始用 ./qa-check.py，报错，改成 /Users/lin/.workbuddy/skills/trans-en-zh/scripts/qa-check.py 才跑通。

趋势：Skill 的复制成本趋近于零

现在接新客户，我只需复制一个 trans-模板 文件夹，改 description 和 glossary.csv，10 分钟搞定。以前要写 30 分钟指令，现在一句话：“翻译客户C的邮件，附件在桌面。”

一句话总结：WorkBuddy

原文链接：https://cloud.tencent.com/developer/article/2703186