关于 arabic-rtl-fixer-ai-skill
arabic-rtl-fixer-ai-skill 为创建或修复文档及其他格式的技能提供阿拉伯语、Unicode、从右到左排版和兼容性指导。它强调保留内容并使用原生方向与布局功能,随附的 OOXML 工具将审计和修复分开处理。
主要功能
- 01按逻辑顺序处理阿拉伯语 Unicode
- 02原生 RTL 方向与对齐指导
- 03按格式分类的创作参考
- 04渲染及目标应用 QA 步骤
- 05只读审计与修复命令分离
- 06修复输出保留源文件
适用场景
- 01制作阿拉伯语优先或双语文档
- 02检查 RTL 文本和混合方向内容
- 03审计或修复 OOXML 文件
- 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.mdSECURITY.mdLICENSEREADME.mdTHIRD_PARTY_LICENSE.md.github/ISSUE_TEMPLATE/feature_request.ymlbug_report.yml.github/workflows/test.ymlagents/openai.yamlexamples/README.mdreferences/documents-and-pdf.mddigital-formats.mdqa.mdpresentations.mdunicode-and-writing.mdscripts/generate_examples.pyarabic_docx.pyarabic_pptx.pytests/test_arabic_docx.pytest_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。然后仅阅读与目标格式对应的参考资料:
- PowerPoint:references/presentations.md,包括随附的 PPTX 审计/修复工具。
- Word/PDF:references/documents-and-pdf.md,包括随附的 DOCX 审计/修复工具。
- Web/UI/电子表格/图像:references/digital-formats.md
- 最终验证:references/qa.md
工作流程
- 确定阿拉伯语区域设置、目标应用、可编辑的源格式,以及产物是以阿拉伯语为主还是双语。条件允许时,从请求中推断这些信息。
- 编写纯 Unicode 文本,通过原生格式属性应用 RTL,而不是使用不可见字符。
- 在段落、文本框、单元格或组件边界处分隔基础方向不兼容的内容。
- 验证结构,然后渲染完整产物,并检查阿拉伯语字形塑形、顺序、换行、标点、数字、项目符号、表格、溢出和字体替换。
- 条件允许时,在用户的目标应用中进行测试。不要将次级渲染器的结果视为 Microsoft PowerPoint、Word、浏览器或 Google 产品行为的证明。
- 分别报告结构 QA、视觉/布局 QA、目标应用 QA 和字体可移植性。未经测试,不要声称在所有应用中都完美兼容。
安全自动化边界
随附的 OOXML 工具分别提供 audit 和 repair 命令。审计为只读操作。修复必须写入不同的输出文件、保留源文件,并且除非用户明确提供 --force,否则不得覆盖已有输出文件。结构审计不能替代渲染 QA 或目标应用 QA。
来源说明
随附的 PPTX 修复/审计辅助工具源自 Sultan Alsafran 采用 MIT 许可证的 arabic-presentations 技能。分享或修改此技能时,请保留 THIRD_PARTY_LICENSE.md。
评论
支持 Markdown