arabic-rtl-fixer-ai-skill

アラビア語コンテンツの品質

このスキルは、要求された出力形式に対応するスキルに加えて、アラビア語、Unicode、RTL、互換性のためのレイヤーとして使用してください。ユーザーのコンテンツ、デザイン、対象形式を維持してください。

基本契約

• アラビア語は通常の論理的な Unicode 順序で保存してください。文字、単語、行を逆順にしたり、アラビア文字をアラビア語プレゼンテーション形式に事前変換したりしないでください。
• 一般的な RTL 対策として、不可視の双方向制御文字（RLE、LRE、RLO、LRO、PDF、RLI、LRI、FSI、PDI、LRM、RLM、ALM）を追加しないでください。ネイティブの段落、コンテナー、またはドキュメントの方向設定を使用してください。
• 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

ワークフロー

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 を保持してください。