markdown-segment-translator

用途

本技能用于翻译较长的 Markdown 文档，解决长文档翻译时受 token 限制、难以一次性完整翻译的问题。它通过分段处理与 Agent 自主翻译相结合的方式，确保文档被完整翻译。

主要能力

• 文档分段：将大文档切分为多个小段落文件，并生成元数据。
• Agent 自主翻译：由 Agent 使用自身语言能力逐段翻译，不调用外部翻译 API。
• 结果合并：将所有翻译段落合并为完整的最终文件。
• 格式保持：翻译时保留标题、列表、代码块、表格等 Markdown 格式，不翻译代码、公式和 URL。
• 术语一致性：要求准确翻译学术术语并保持专业性。

使用方式

技能要求严格按三步执行，不得跳过任何步骤。

第 1 步：文档分段

使用 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。

示例：

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

第 2 步：翻译每个段落

使用 Read 读取段落，由 Agent 自己翻译，再用 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；保持段落结构。

翻译提示词模板：

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

[段落内容]

第 3 步：合并翻译结果

使用 Bash 运行合并脚本：

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

最终文件位于 output/final/complete_translated_[原文件名].md。

完整示例

用户请求：请翻译 2407.14333v5.md 文件。

执行步骤：

第 1 步 - 分段：

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 步 - 合并：

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 调用外部翻译程序。

正确的工具调用序列

1. Bash（分段工具）
2. Read → 自己翻译 → Write（循环 N 次）
3. Bash（合并工具）
4. Read（读取最终结果）

设计原因

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

适用场景

适用于需要将较长的 Markdown 文档（如学术论文、技术文档等）从英文翻译为中文，且希望保持格式完整、避免 token 限制的场景。

限制

• 翻译由 Agent 自身完成，不调用外部 API。
• 必须严格遵循三步流程，不能跳过分段或合并。
• 关于收费、价格、平台支持等信息，资料中暂未提供。