用途
该技能用于处理以希伯来语为主、但内嵌英文术语的文本,解决因 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。
工作流程建议:
- 确认文本主要是希伯来语散文,并夹杂英文片段。
- 对于散文较多或 Markdown 文件,优先使用附带脚本。
- 避免改动围栏代码块、行内代码、YAML frontmatter、Markdown 链接目标,以及明显的 URL 和文件系统路径。
- 如果文件结构脆弱或包含大量特殊 Markdown 构造,应逐处精细编辑,而非批量运行脚本。
- 编辑后,检查几行有代表性的混合语言行。
适用场景
- 任何类型的希伯来语散文
- 以希伯来语为主的 Markdown 文件
- 笔记、文档、文章、帖子、规格说明、草稿和内部写作
- 已因 RTL/LTR 混排而渲染不佳的希伯来语优先文件
限制
不适用于以下场景:
- 代码文件
- JSON、YAML、shell 脚本或配置
- 以路径、URL 或代码为主的 Markdown 段落
- 链接目标或文件引用,除非用户明确要求
其他注意事项:
- 不要对已经隔离的片段重复包裹。
- 不要为了回避英文而改写术语。
- 如果渲染器将隔离标记显示为可见字形,可提供回退方案:用反引号包裹英文术语,或在目标渲染器支持时使用带 dir="ltr" 的 HTML span。