AgentSkillsCN

markdown-segment-translator

长文档Markdown分段翻译技能（Agent自己翻译）

中文原作
SKILL.md
--- frontmatter
name: markdown-segment-translator
description: 长文档Markdown分段翻译技能（Agent自己翻译）
allowed-tools: ["Bash", "Read", "Write"]
triggers:
  - type: keyword
    keywords:
      - "分段翻译"
      - "markdown翻译"
      - "接力翻译"
      - "长文档翻译"
      - "完整翻译"
      - "段落翻译"
      - "分段处理翻译"
      - "逐段翻译"
      - "论文翻译"

Markdown分段翻译技能

⚠️ 强制执行要求 - 3步翻译流程 ⚠️

当用户要求翻译markdown文件时，你必须严格按照以下3个步骤完成，不要跳过任何步骤！

📋 第1步: 文档分段

工具: Bash
命令格式:

bash
python3 workspace/skills/markdown-segment-translator/scripts/segment_tool.py segment --input [输入文件] --segment-size 1000 --max-segments 3

作用:

  • •将大文档分成多个小段落
  • •段落文件保存在 output/segments/segment_1.md, segment_2.md...
  • •元数据保存在 output/metadata/segments_info.json

示例:

bash
python3 workspace/skills/markdown-segment-translator/scripts/segment_tool.py segment --input workspace/2407.14333v5.md --segment-size 1000 --max-segments 3

📋 第2步: 翻译每个段落

工具: Read + 你自己的LLM能力 + Write

重要: 你要自己翻译，不要调用任何外部API！

流程:

对于每个分段文件：

  1. •读取段落: 使用 Read 读取 output/segments/segment_1.md
  2. •你自己翻译: 使用你自己的语言能力将内容从英文翻译为中文
  3. •保存翻译: 使用 Write 保存到 output/translations/translated_segment_1.md
  4. •重复: 处理 segment_2.md, segment_3.md...

翻译要求:

  • •保持所有Markdown格式（标题、列表、代码块、表格等）
  • •准确翻译学术术语
  • •保持专业性和流畅性
  • •不要翻译代码、公式、URL
  • •保持段落结构

翻译提示词模板:

code
请将以下Markdown内容从英文翻译为中文：
- 保持所有Markdown格式标记
- 准确翻译学术术语
- 不要翻译代码块、数学公式、URL链接
- 保持专业性

[段落内容]

📋 第3步: 合并翻译结果

工具: Bash
命令:

bash
python3 workspace/skills/markdown-segment-translator/scripts/segment_tool.py merge

作用:

  • •将所有翻译段落合并成完整文件
  • •最终文件位于: output/final/complete_translated_[原文件名].md

✅ 完整示例

code
用户请求: 请翻译2407.14333v5.md文件

你的执行步骤:

【第1步 - 分段】
Bash: python3 workspace/skills/markdown-segment-translator/scripts/segment_tool.py segment --input workspace/2407.14333v5.md --segment-size 1000 --max-segments 3

输出: 创建 segment_1.md (1000行), segment_2.md (1000行), segment_3.md (700行)

【第2步 - 翻译】
循环处理每个段落:

Segment 1:
  Read: output/segments/segment_1.md
  [你自己翻译这段内容为中文]
  Write: output/translations/translated_segment_1.md (写入你的翻译)

Segment 2:
  Read: output/segments/segment_2.md
  [你自己翻译这段内容为中文]
  Write: output/translations/translated_segment_2.md

Segment 3:
  Read: output/segments/segment_3.md
  [你自己翻译这段内容为中文]
  Write: output/translations/translated_segment_3.md

【第3步 - 合并】
Bash: python3 workspace/skills/markdown-segment-translator/scripts/segment_tool.py merge

输出: output/final/complete_translated_2407.14333v5.md

【完成】
使用 Read 读取最终文件并向用户报告

❌ 严格禁止的操作

  • •❌ 不要使用旧的 segment_translator.py 脚本（那个会自己调用API）
  • •❌ 不要让Python脚本调用翻译API
  • •❌ 不要跳过分段或合并步骤
  • •❌ 不要尝试一次性翻译整个文档
  • •❌ 不要在第2步使用Bash调用外部翻译程序

✅ 正确的工具调用序列

code
第1步: Bash (分段工具)
第2步: Read → [你自己翻译] → Write (循环N次)
第3步: Bash (合并工具)
第4步: Read (读取最终结果)

🎯 为什么要这样设计？

  1. •分段: 避免token限制，确保完整翻译
  2. •Agent翻译: 利用你的LLM能力，无需额外API调用
  3. •逐段处理: 保证质量和准确性
  4. •合并: 生成完整统一的翻译文档

技能功能概述

本技能专门解决长文档翻译中的token限制问题，通过智能分段和Agent自主翻译机制，确保100%完整翻译。

核心优势:

  • •🔧 纯工具化分段/合并
  • •🧠 Agent主导翻译
  • •📊 完整性保证
  • •🎨 格式保持
  • •📝 术语一致性