mcpField
A
arabic-presentations

arabic-presentations

github.com/sultanalsafranドキュメント4122 回インストール16 週間前に更新
リポジトリ

arabic-presentations について

Presentationsスキルでアラビア語または二言語のPowerPoint資料を作成するための、テキスト処理、正規化、QAルールを提供するスキルです。ネイティブのRTL属性、PPTX構造監査、PowerPointでの目視確認を重視します。

主な機能

  1. 01アラビア語段落の方向設定
  2. 02言語と複合スクリプトのフォント情報設定
  3. 03双方向制御文字の除去と箇条書き変換
  4. 04PPTXパッケージ構造の監査
  5. 05レイアウトとPowerPoint表示の確認

活用シーン

  1. 01アラビア語のPowerPoint資料作成
  2. 02既存資料のRTL属性の修正
  3. 03アラビア語とラテン文字の混在表示の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sultanalsafran/agent-skills --skill arabic-presentations

インストール後、Claude Code で/arabic-presentationsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
authoring.md
qa.md
scripts/
arabic_pptx.py

詳細

Arabic Presentations

Presentations:Presentations を使ってデッキを作成してください。アラビア語のテキストと互換性に関する、より厳格なレイヤーとしてこのスキルを使用してください。Presentations スキルのコンテンツ、デザイン、ワークスペース、実装、ビジュアル QA に関するすべてのルールに従ってください。アラビア語テキストの処理やレンダラーの信頼性が異なる場合は、このスキルに従ってください。

このパブリックリリースは Codex を対象としています。Codex にバンドルされた Presentations スキルと Python 3 が必要です。

信頼性に関する要件

編集可能な PPTX をソース成果物として扱い、PowerPoint デスクトップ版を標準のビューアーとします。

  • テキストは通常の論理的な Unicode 順序で保存してください。アラビア語の文字、単語、行を逆順にしてはいけません。
  • アラビア語やラテン文字のトークンを、RLE/PDF、RLI/PDI、LRI/PDI、LRM、RLM などの Unicode 双方向制御文字で囲んではいけません。
  • アラビア語の各段落に、ネイティブの DrawingML 方向指定 <a:pPr rtl="1"> を設定してください。
  • アラビア語の各テキスト本文に、ネイティブのテキスト本文方向指定 <a:bodyPr rtlCol="1"> を設定してください。
  • アラビア語の本文テキストは明示的に右揃えにしてください。意図的な中央揃えまたは両端揃えは維持してください。
  • アラビア語の実行範囲には、通常 ar-SA の言語メタデータと、書体が明示されている場合は複雑な文字体系用のフォントスロットを設定してください。
  • PowerPoint のネイティブ箇条書きを使用してください。段落の先頭に • を直接入力した状態で納品してはいけません。
  • 各段落の基本方向は 1 つにしてください。長い英語の文章、URL、引用、コードは、別の LTR テキストボックスに入れてください。
  • コンピューター間でフォントが同一になることを保証してはいけません。アラビア語に対応したフォントを使い、該当する場合は代替フォントに置き換わる可能性を明示してください。表示を固定する必要がある場合は PDF も提供してください。

アラビア語またはアラビア語と他言語の併記を作成する前に、references/authoring.md を読んでください。最終 QA の前、またはアプリケーション間の差異を調査する際は、references/qa.md を読んでください。

ワークフロー

1. Presentations スキルで作成する

Presentations:Presentations と @oai/artifact-tool を使ってデッキを作成または編集してください。双方向制御で囲まずにプレーンな文字列を記述してください。改行によって複数の PowerPoint 段落が作成される場合があります。正規化の手順で、各段落を個別に修正する必要があります。

アラビア語と英語で意味上の役割が異なる場合は、テキストボックスを分けることを推奨します。短い混在フレーズでは、次の例のように意図した論理順序を維持してください。

بلغ النمو 25% في Q4 2026.
C4ISR يربط القيادة بالاستطلاع.

リストには、利用可能な場合はエンジンのネイティブリスト API を使用してください。エンジンが箇条書き文字を直接出力する場合は、未加工のドラフトではその使用を許容し、正規化時に変換してください。

2. 未加工のドラフトをエクスポートする

$TMP_DIR/deck.raw.pptx などの一時ファイルにエクスポートしてください。要求された最終ファイル名は、正規化後のファイル用に確保してください。

3. PPTX を正規化する

次を実行してください。

ARABIC_SKILL="${ARABIC_PRESENTATIONS_SKILL_DIR:-$HOME/.agents/skills/arabic-presentations}"

python3 "$ARABIC_SKILL/scripts/arabic_pptx.py" repair \
  "$TMP_DIR/deck.raw.pptx" \
  "$FINAL_PPTX" \
  --lang ar-SA \
  --convert-bullets

ユーザーまたはデッキでフォントが指定されている場合に限り、--font "<Arabic-capable family>" を追加してください。これは複雑な文字体系用のフォントスロットを書き込みますが、フォントを埋め込みません。

アラビア語を優先するデッキには --presentation-rtl を追加してください。英語を優先するデッキ、または意図的に中立にしたアラビア語と英語の併記デッキでは省略してください。プレゼンテーションの読み順はデッキ全体の設定であり、アラビア語の段落に必須の RTL プロパティとは別のものです。

修復コマンドでは、未加工のドラフトを保持し、手動で挿入された双方向制御文字を削除して、ネイティブの段落およびテキスト本文方向を適用し、言語メタデータを追加してください。また、可能な場合は選択した書体から複雑な文字体系用のフォントスロットを設定し、直接入力された箇条書き文字をネイティブの箇条書きに変換してください。

4. 構造 QA を実行する

その後に編集またはエクスポートを行うたびに、厳格な監査を実行してください。

python3 "$ARABIC_SKILL/scripts/arabic_pptx.py" audit "$FINAL_PPTX" --strict

アラビア語を優先するデッキの場合は、監査コマンドに --expect-presentation-rtl を追加してください。

エラーまたは厳格な警告は、いずれも納品を妨げる問題です。デッキを再度開いて修復するか、再生成してください。監査の失敗を正当化してはいけません。

監査によって確認できるのは、パッケージ構造とアラビア語テキストのメタデータです。各アプリケーションでの表示順や、フォントがインストールされているかどうかは確認できません。

5. ビジュアル QA とアプリケーション QA を実施する

レイアウト、はみ出し、折り返し、コントラスト、重なりを確認するには、Presentations スキルのレンダリングと検査のループを使用してください。アラビア語の文字や単語の順序について、Codex/LibreOffice のレンダラーを正しい表示の基準にしないでください。有効な PPTX の双方向テキストが正しく描画されないことがあります。

Codex Desktop で Presentations スキルの Python コンテナツールを使用する場合は、load_workspace_dependencies が返すバンドル済み Python を使用してください。システム Python には pdf2image やその他のレンダリング依存関係が含まれていない場合があります。

PowerPoint デスクトップが利用可能な場合は、最終的に正規化された PPTX を開き、references/qa.md にある混在テキストコーパスに加え、数字、ラテン文字の頭字語、括弧、パーセント、URL、箇条書きが含まれるすべてのスライドを確認してください。「PowerPoint で検証済み」と報告するには、PowerPoint でのビジュアル QA が必須です。

Keynote と Google Slides は、互換性を確認するための補助としてのみ使用してください。PowerPoint と異なる場合は、構造的に正しい PPTX を保持し、アプリケーション固有の差異を報告してください。Google Slides では、利用できないローカルフォントが代替フォントに置き換えられることを想定してください。

6. 正直に報告する

以下はそれぞれ個別に報告してください。

  • Structural Arabic QA: PASS/FAIL
  • Layout QA: PASS/FAIL
  • PowerPoint visual QA: PASS/NOT RUN
  • Keynote/Google Slides compatibility: PASS/NOT RUN/DIFFERS
  • Font portability: installed-font dependent または PDF supplied

実際にアプリケーションを開いて確認していない限り、「すべての環境で完璧」や「複数アプリで検証済み」とは言わないでください。

特殊なケース

  • **既存のスライドデッキの修復：**ユーザーがインプレースでの置換を明示的に許可していない限り、入力ファイルを保持し、別の正規化済み PPTX を書き出してください。
  • **アラビア語のグラフ：**PowerPoint でのビジュアル QA が可能でない限り、グラフ内部の数値やラテン文字はそのままにし、アラビア語のタイトルとラベルは別個の RTL テキストボックスとして配置してください。同梱の監査ツールでは、ネイティブグラフの双方向テキストが完全には検証されていません。
  • **表：**セル内の段落に RTL を設定してください。表の意味上の読み順がアラビア語の場合に限り、列の順序を反転してください。装飾的なレイアウトを自動的に反転しないでください。
  • **発表者ノート：**アラビア語のノートも正規化してください。修復スクリプトは、PPTX パッケージ内の DrawingML の段落をすべてスキャンします。
  • **PDF：**PDF は配布形式として使用し、要求された編集可能な PPTX の代わりにしないでください。

コメント

Markdown 対応