mcpField
A
arabic-rtl-fixer-ai-skill

arabic-rtl-fixer-ai-skill

github.com/ibadwi文档处理4868 次安装8 周前更新
代码仓库

关于 arabic-rtl-fixer-ai-skill

arabic-rtl-fixer-ai-skill 为创建或修复文档及其他格式的技能提供阿拉伯语、Unicode、从右到左排版和兼容性指导。它强调保留内容并使用原生方向与布局功能,随附的 OOXML 工具将审计和修复分开处理。

主要功能

  1. 01按逻辑顺序处理阿拉伯语 Unicode
  2. 02原生 RTL 方向与对齐指导
  3. 03按格式分类的创作参考
  4. 04渲染及目标应用 QA 步骤
  5. 05只读审计与修复命令分离
  6. 06修复输出保留源文件

适用场景

  1. 01制作阿拉伯语优先或双语文档
  2. 02检查 RTL 文本和混合方向内容
  3. 03审计或修复 OOXML 文件
  4. 04在目标应用中验证阿拉伯语版面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ibadwi/arabic-rtl-fixer-ai-skill --skill arabic-rtl-fixer-ai-skill

安装后在 Claude Code 中输入/arabic-rtl-fixer-ai-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CONTRIBUTING.md
SECURITY.md
LICENSE
README.md
THIRD_PARTY_LICENSE.md
.github/ISSUE_TEMPLATE/
feature_request.yml
bug_report.yml
.github/workflows/
test.yml
agents/
openai.yaml
examples/
README.md
references/
documents-and-pdf.md
digital-formats.md
qa.md
presentations.md
unicode-and-writing.md
scripts/
generate_examples.py
arabic_docx.py
arabic_pptx.py
tests/
test_arabic_docx.py
test_arabic_pptx.py

详细介绍

阿拉伯语内容质量

将此技能用作请求输出格式技能之上的阿拉伯语、Unicode、RTL 和兼容性层。保留用户的内容、设计和目标格式。

核心约定

  • 以正常的逻辑 Unicode 顺序存储阿拉伯语。绝不反转字符、单词或行,也绝不将字母预先塑形成阿拉伯语展示形式。
  • 不要将不可见的双向控制字符(RLE、LRE、RLO、LRO、PDF、RLI、LRI、FSI、PDI、LRM、RLM 或 ALM)用作通用 RTL 修复方案。应使用原生段落、容器或文档方向设置。
  • 不要盲目删除 ZWJ 或 ZWNJ;它们可能具有语言学意义。标记意外出现的情况,并且仅在安全时移除。
  • 设置阿拉伯语语言元数据(除非请求了其他区域设置,否则使用 ar-SA)、原生 RTL 方向,并分别设置有意的对齐方式。
  • 在格式允许时,将较长的英文段落、URL、电子邮件地址、文件路径、引文、公式和代码放在单独的 LTR 容器中。
  • 选择包含阿拉伯语字形的字体。未经验证,不要声称字体已嵌入或具有可移植性。若需要固定外观,请提供 PDF。
  • 使用原生列表和编号功能。不要用空格或输入的符号来伪造项目符号、缩进、表格或阅读顺序。
  • 如果用户要求保留可编辑性,请保留可编辑的源文件;PDF 是固定输出的补充,不可替代源文件。

编写或修复阿拉伯语文本时,请阅读 references/unicode-and-writing.md。然后仅阅读与目标格式对应的参考资料:

工作流程

  1. 确定阿拉伯语区域设置、目标应用、可编辑的源格式,以及产物是以阿拉伯语为主还是双语。条件允许时,从请求中推断这些信息。
  2. 编写纯 Unicode 文本,通过原生格式属性应用 RTL,而不是使用不可见字符。
  3. 在段落、文本框、单元格或组件边界处分隔基础方向不兼容的内容。
  4. 验证结构,然后渲染完整产物,并检查阿拉伯语字形塑形、顺序、换行、标点、数字、项目符号、表格、溢出和字体替换。
  5. 条件允许时,在用户的目标应用中进行测试。不要将次级渲染器的结果视为 Microsoft PowerPoint、Word、浏览器或 Google 产品行为的证明。
  6. 分别报告结构 QA、视觉/布局 QA、目标应用 QA 和字体可移植性。未经测试,不要声称在所有应用中都完美兼容。

安全自动化边界

随附的 OOXML 工具分别提供 audit 和 repair 命令。审计为只读操作。修复必须写入不同的输出文件、保留源文件,并且除非用户明确提供 --force,否则不得覆盖已有输出文件。结构审计不能替代渲染 QA 或目标应用 QA。

来源说明

随附的 PPTX 修复/审计辅助工具源自 Sultan Alsafran 采用 MIT 许可证的 arabic-presentations 技能。分享或修改此技能时,请保留 THIRD_PARTY_LICENSE.md。

评论

支持 Markdown