SuperAPI AI 工具集

hebrew-rtl-writing

写作与研究

查看项目

更新于 10-15 08:26

技能介绍

用途

该技能用于处理以希伯来语为主、但内嵌英文术语的文本,解决因 RTL(从右到左)与 LTR(从左到右)混排导致的渲染混乱问题。当希伯来语句子中出现英文单词时,文本方向可能错乱,影响阅读。此技能的目标是在不修改文本内容的前提下,让希伯来语 Markdown 在混入英文时保持可读。

主要能力

默认策略是保留文本本身,仅在英文片段周围添加 Unicode 双向隔离字符:

  • LRI = U+2066
  • PDI = U+2069

隔离只应用于有助于可读性的位置。该技能专注于方向性处理,而非内容编辑,因此不会为了回避英文而改写术语。

使用方式

技能附带脚本,适用于散文较多或 Markdown 文件。使用命令:

python3 .agents/skills/hebrew-rtl-writing/scripts/isolate_bidi.py path/to/file.md

支持多个文件:

python3 .agents/skills/hebrew-rtl-writing/scripts/isolate_bidi.py file1.md file2.md

脚本会跳过以下内容:

  • 围栏代码块
  • 顶层 YAML frontmatter
  • 行内代码
  • Markdown 链接目标

脚本会将英文散文片段包裹为 LRI ... PDI。

工作流程建议:

  1. 确认文本主要是希伯来语散文,并夹杂英文片段。
  2. 对于散文较多或 Markdown 文件,优先使用附带脚本。
  3. 避免改动围栏代码块、行内代码、YAML frontmatter、Markdown 链接目标,以及明显的 URL 和文件系统路径。
  4. 如果文件结构脆弱或包含大量特殊 Markdown 构造,应逐处精细编辑,而非批量运行脚本。
  5. 编辑后,检查几行有代表性的混合语言行。

适用场景

  • 任何类型的希伯来语散文
  • 以希伯来语为主的 Markdown 文件
  • 笔记、文档、文章、帖子、规格说明、草稿和内部写作
  • 已因 RTL/LTR 混排而渲染不佳的希伯来语优先文件

限制

不适用于以下场景:

  • 代码文件
  • JSON、YAML、shell 脚本或配置
  • 以路径、URL 或代码为主的 Markdown 段落
  • 链接目标或文件引用,除非用户明确要求

其他注意事项:

  • 不要对已经隔离的片段重复包裹。
  • 不要为了回避英文而改写术语。
  • 如果渲染器将隔离标记显示为可见字形,可提供回退方案:用反引号包裹英文术语,或在目标渲染器支持时使用带 dir="ltr" 的 HTML span。