Communitygithub.com

rtl-bidi

ペルシア語/アラビア語と英語の混在テキスト、数字、電話番号、メールアドレス、URL、コード、通貨をRTLインターフェース内で適切に処理します。テキストに両方のスクリプトが含まれる場合、出力がスクランブルされて数字や順序が誤って表示される場合、またはRTLページの入力、価格、コードブロックで使用します。双方向アルゴリズム、bdi要素、unicode-bidi CSS、よくあるスクランブルバグをカバーします。

rtl-bidi とは?

このスキルは、ペルシア語/アラビア語などの右横書き(RTL)と英語などの左横書き(LTR)が混在するテキストにおいて、Unicode BiDi(双方向)アルゴリズムの動作を理解し、正しく表示するための知識と実践的なコードを提供します。主にクロードコード、カーソル、CodexなどのAIエージェント向けに設計されており、開発者がRTL対応のUIやテキスト処理を行う際に生じる一般的な問題(電話番号や価格のスクランブル、IDコードの文字順序の逆転など)を診断・修正する方法を学べます。このスキルは、HTMLの`<bdi>`要素や`dir`属性、CSSの`unicode-bidi`プロパティ、そして制御文字RLM/LRMの使い分けを中心に構成されており、フォーム入力、ユーザー生成コンテンツ、APIペイロードなど様々なコンテキストで適用可能です。スキルマークダウンには、メンタルモデルの解説、介入ツールの一覧、具体例(電話番号、価格、メール、コード、製品ID、ユーザー生成コンテンツなど)、デバッグチェックリスト、およびタイトルやメタデータの注意点が含まれています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-bidi

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

BiDi: ペルシア語/英語の混在コンテンツ

Unicode BiDiアルゴリズムは、混在方向のテキストを自動的に並べ替えますが、時には誤った順序になります。このスキルは、いつ介入すべきか、そして正確にどのようにするかを教えます。

1. メンタルモデル

  • ベース方向は、最も近い祖先の dir(ページ: RTL)から決定されます。
  • 強いLTRコンテンツ(ラテン文字)の連続は埋め込まれ、内部ではLTRで流れます。
  • 中立文字(句読点、数字に隣接する記号 + - / $ % など)は周囲の方向を取ります。これがスクランブルの原因です。

2. 介入ツールボックス

ツール使用場面例
<bdi> 要素ペルシア語テキスト内のインラインの外部要素、方向が不明な場合«فایل report_final.pdf را ببینید»
<span dir="ltr">既知のLTR要素で、内部でも左揃えにしたい場合<span dir="ltr">+98 912 345 6789</span>
dir="auto"ユーザー生成または予測不可能なコンテンツチャットバブル、コメント、ファイル名
CSS unicode-bidi: plaintextスタイル付きspanで dir="auto" と同様の動作.user-content { unicode-bidi: plaintext; }
isolate(bdiのデフォルト)要素が隣接要素の並べ替えを防ぐ<bdi> のデフォルト動作

3. 標準的なケース

電話番号

ペルシア語テキスト内の +98 912 は、+ が間違った側に表示されることがよくあります。

تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>

外国通貨の価格

RTLテキスト内の $99 は 99$ になります。

اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان

メール、URL、ハンドル

به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>

文中のラテンブランド名

通常はプレーンテキストで問題ありませんが、ペルシア語の接尾辞が付くと壊れます。 「نسخه‌ی جدید Node.js」— 「Node.js」は安全です。「های Node.js」の場合、ラテン文字列の周りに <bdi> が必要です: <bdi>Node.js</bdi>های は間違い — 「افزونه‌های Node.js」のように言い換えてください。

コードとコマンド — 常にLTRブロック

<pre dir="ltr" style="text-align: left;">npm install raast</pre>

ペルシア語の散文内のインラインコマンド: <code dir="ltr">npx create-next-app</code>。

混在アイテムのリスト

アイテムマーカー(۱ ۲ ۳)はRTLの流れの中にあります。長いLTRアイテムは各アイテムごとに分離されたままです — ラテン文字/数字で始まるアイテムには <bdi> を配置してください。

製品識別子、シリアル番号、技術ID

最もスクランブルされやすいカテゴリ — 文字、数字、ダッシュが混在します:

شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>

ルール:

  • 識別子はコピーされたときにバイト完全でなければなりません。分離はレンダリングのみを変更し、文字列は決して変更しません。
  • RTL文内の末尾のダッシュ/数字の連続は、<bdi> なしでは並べ替えられます(例: 88451-B → B-88451)。
  • JSで構築されたデータベースルックアップ: 論理文字列を保持し、「表示用に事前反転」しないでください。
  • テーブルのID列には、等幅フォント + dir="ltr" + text-align: start を使用します。

ユーザー生成コンテンツ(チャット、コメント、ファイル名)

  • コンテナ: dir="auto" + CSS unicode-bidi: plaintext — 各メッセージは最初の強い文字によって方向付けされます。
  • ペルシア語ユーザーが英語のテキストを貼り付ける場合、またはその逆の場合でも、手動で dir を切り替えることなく正しく読める必要があります。
  • dir="rtl" + text-align: start だけでは、ページの方向をUGCに強制しないでください。plaintext の要点は最初の強い文字ルールです。
  • ファイル名/ダウンロード: 拡張子(.pdf、.zip)が分離しないように <bdi> でレンダリングします。

4. フォーム入力

  • dir="auto": 入力は最初の強い文字の方向を採用します — 名前/メッセージフィールドに適しています。
  • 明示的な dir="ltr": メール、電話、ユーザー名、カード番号、URL、価格(text-align: end を使用するとRTLユーザーにとってカーソルが右から始まります...実際にはLTR入力では text-align: start のままにし、カーソルの動作をテストしてください)。

5. スクランブル出力のデバッグ — チェックリスト

  1. 要素はラップ/分離されていますか?(bdi / span dir=ltr)
  2. 中立文字(+ - / . , ( ))が方向の境界に隣接していますか? 分離またはRLM(\u200F)/LRM(\u200E)マークを追加してください。
  3. LTR要素の末尾の句読点が間違った端にジャンプしていますか? → 分離内に末尾のスペースを含めてください。
  4. JSで構築された文字列ですか? BiDiはレンダリングの問題です — コード内で並べ替えを行わず、DOM/CSSを修正してください。
  5. 不可視文字のダンプ: BiDiインスペクターに貼り付けるか、JSON.stringify() でテキストを出力してU+200E/Fの配置を確認してください。

6. RLM/LRM — メス

&rlm; (U+200F) / &lrm; (U+200E) は、分離が不可能な場合(プレーンテキストメール、CSVセルなど)に中立文字を片側に強制します:

متن فارسی‎ +98‎  -> + を数字に付けたままにする

控えめに使用してください — 一部のフォントで可視の文字化けが発生します。ウェブでは構造的分離を優先してください。

7. タイトル、メタ、単一行コンテキスト

  • スクリプトが混在する <title>: ブラウザはタブ内でBiDiを適切にレンダリングしますが、ページの言語で始めてください: «raast — مهارت‌های RTL» 対 «مهارت‌های RTL — raast»: ページ言語の強いスクリプトを先頭に配置します。
  • aria-label 文字列も同じルールに従います。スクリーンリーダーはUnicode BiDiマークを処理するため、マークを保持してください。
  • JSON/APIペイロード: 常に論理順序で保存し、表示用に事前反転しないでください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル