| argument-hint | <article-url> |
| description | 抓取英文技术文章网页并翻译为中文 Markdown。输入一个 URL，自动完成： Playwright 抓取 → Readability 正文提取 → 图片下载 → 中文重写。 当用户提供英文文章链接、说"翻译这篇文章"、"把这个链接翻译成中文"、 "translate this article"、或者给出 medium.com / substack.com / x.com 等技术博客 URL 时，使用此 skill。即使用户只是贴了一个链接没有明确说 "翻译"，只要链接指向英文技术文章，也应主动建议使用此 skill。 |
| disable-model-invocation | true |
| name | translate-article |
总览
这个 skill 分两个阶段执行：
- 抓取阶段（脚本）：运行
fetch-article.js 脚本，用 Playwright 抓取网页、提取正文、下载图片
- 翻译阶段（你来做）：读取提取的英文 Markdown，按翻译提示词将其重写为中文
你就是翻译引擎——不需要调用任何外部 API。
第一步：运行抓取脚本
确保 Node.js 18+ 可用，然后运行抓取脚本：
export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" && nvm use 18 2>/dev/null; node ${CLAUDE_SKILL_DIR}/scripts/fetch-article.mjs $ARGUMENTS
这个脚本会：
- 用 Playwright headless Chromium 加载页面（处理 JS 渲染、懒加载、cookie 弹窗）
- 用 Readability 提取正文，用 Turndown 转为 Markdown
- 下载所有图片到
assets/ 目录，重写 Markdown 中的图片路径
- 输出到
article-zh/<slug>/ 目录
脚本运行结束后，会打印输出目录路径。记住这个路径。
如果脚本失败
- 依赖未安装：运行
cd <project-root>/article-zh-tool && npm install && npx playwright install chromium
- Node 版本过低：需要 Node.js 18+，用
nvm use 18 切换
- 页面抓取为空：部分重度 SPA 页面（如 openai.com）Readability 无法提取，告知用户手动复制正文到 Markdown 文件，然后用
--from-file 模式
第二步：读取翻译提示词
读取翻译提示词文件：
prompt1.md
这个文件定义了完整的翻译规范，包括：
- 角色定义（中文技术社区资深作者）
- 核心原则（技术准确 > 中文原创感 > 信息完整 > 不加私货）
- 术语处理三级规则
- 中文表达铁律（翻译腔识别与消除）
- 叙述视角规则
- 自审清单
你必须严格遵循这个提示词中的所有规则。
第三步：翻译
- 读取第一步输出的
article.md 文件
- 跳过文件开头的 metadata header（标题、作者、来源等
--- 分隔线之前的部分），只翻译正文
- 按照
prompt1.md 中的工作流程执行翻译：
- 通读原文，建立术语映射表、叙述视角判断、文章结构骨架
- 按中文逻辑重组结构
- 逐段用中文重写（不是逐句翻译）
- 自审并修正
- 图片引用路径保持不变（
assets/img-XXX.ext），不要修改
- 代码块、命令、变量名、URL 保持原样，不翻译
第四步：保存输出
将翻译结果保存到同一目录下的 article-zh.md：
article-zh/<slug>/article-zh.md
同时更新 metadata.json，将 "translated": false 改为 "translated": true。
第五步：确认
向用户报告：
- 输出目录路径
- 文章标题（中英文）
- 图片数量
- 翻译是否完成
注意事项
- 翻译时遇到超长文章（超过你的输出限制），按
## 标题分段翻译，每段写入后继续下一段
- 如果用户提供的不是 URL 而是本地文件路径，跳过第一步，直接读取文件进行翻译
- 翻译结果不要包含任何译者注、翻译说明或提示词痕迹
