PPT ライティングスキル

4つの機能を備えています：生成、テンプレート模倣、既存 PPT の編集、およびローカルファイル操作。

---

前提条件

API キー設定（必須・最初に行うこと）

このスキルを使用するには、OpenClaw で SKYWORK_API_KEY を設定する必要があります。

まだ API キーをお持ちでない場合は、以下をご覧ください： https://skywork.ai

詳細なセットアップ手順については、以下を参照してください： references/apikey-fetch.md

---

プライバシーとリモート呼び出し（使用前にお読みください）

• リモートアップロードと処理：レイヤー 1/2/4 はローカルファイルをアップロードし、ユーザーのクエリ全体を Skywork サービスに送信します。リモートサービスとそのデータ処理ポリシーを信頼していない限り、機密コンテンツや機密情報は避けてください。
• ローカルのみの操作：レイヤー 3（ローカル操作）はデバイス上で完全に実行され、リモートゲートウェイを呼び出しません。厳密なローカル処理が必要な場合はレイヤー 3 を使用してください。
• ポーリング動作：生成/編集ワークフローには、バックエンドジョブの完了を待つ際に定期的なステータスポーリング（約 5 秒ごと）が含まれます。これは正常な動作です。

---

ルーティング — ユーザーの意図を最初に確認してください

ユーザーの意図	どのパスを使用
トピック、要件のセット、または参照ファイルから新しい PPT を生成	レイヤー 1 — 生成
既存の .pptx をレイアウト/スタイルテンプレートとして使用して新しいプレゼンテーションを作成	レイヤー 2 — 模倣
既存の PPT を編集：スライド修正、スライド追加、スタイル変更、分割/結合	レイヤー 4 — 編集
ローカルファイル内のスライドの削除/並び替え/抽出/結合（バックエンドなし）	レイヤー 3 — ローカル操作

---

環境チェック（常に最初に実行してください）

このスキルには Python 3（>=3.8）が必要です。スクリプトを実行する前に、以下を実行して有効な Python バイナリを見つけ、依存関係をインストールしてください。

PYTHON_CMD=""
for cmd in python3 python python3.13 python3.12 python3.11 python3.10 python3.9 python3.8; do
  if command -v "$cmd" &>/dev/null && "$cmd" -c "import sys; exit(0 if sys.version_info >= (3,8) else 1)" 2>/dev/null; then
    PYTHON_CMD="$cmd"
    break
  fi
done

if [ -z "$PYTHON_CMD" ]; then
  echo "ERROR: Python 3.8+ not found."
  echo "Install on macOS: brew install python3  or visit https://www.python.org/downloads/"
  exit 1
fi

echo "Found Python: $PYTHON_CMD ($($PYTHON_CMD --version))"

$PYTHON_CMD -m pip install -q --break-system-packages python-pptx
echo "Dependencies ready."

このチェック後、後続のすべてのコマンドで python を検出された $PYTHON_CMD（例：python3）に置き換えてください。

---

レイヤー 1 — PPT 生成

ステップ

0. 必須の最初のステップ — workflow_generate.md を今すぐ読んでください。他の操作を行う前に読む必要があります。読了後、正確に以下を出力してください：✅ workflow_generate.md loaded.—その後、次に進みます。
1. 環境チェック — 上記のチェックを実行して $PYTHON_CMD を取得します。
2. 参照ファイルをアップロード（ユーザーがコンテンツソースとしてローカルファイルを提供する場合）— script/parse_file.py のツールを使用してファイルを解析し、結果を --files に渡します。下の --files に関する注記を参照してください。
3. ウェブ検索（会話にまだ関連するコンテンツがない場合は必須）— script のツールで web_search を呼び出してトピックを検索し、結果を 2000 文字以下の reference-file ファイルに要約します。
4. スクリプトを実行します：

   重要：exec ツール yieldMs を 600000（10 分）に設定します。

5. 提供 — 絶対 .pptx パスとダウンロード URL を提供します。

---

レイヤー 2 — PPT 模倣（テンプレートベースの生成）

ステップ

0. 必須の最初のステップ - workflow_imitate.md を実行する前のアクションの直前に読んでください！
1. 環境チェック — 上記のチェックを実行して $PYTHON_CMD を取得します。
2. テンプレートを見つける — ユーザーのメッセージからローカル .pptx の絶対パスを抽出します。不明な場合はユーザーに確認してください。
3. テンプレートをアップロード — アップロードして出力から TEMPLATE_URL を抽出します。
4. 参照ファイルをアップロード（ユーザーがコンテンツソースとして追加のローカルファイルを提供する場合）— script/parse_file.py のツールを使用してファイルを解析し、結果を --files に渡します。--files に関する注記を参照してください。
5. ウェブ検索（会話にまだ関連するコンテンツがない場合は必須）— script のツールで web_search を呼び出して新しいトピックを検索し、結果を 2000 文字以下の reference-file ファイルに要約します。
6. スクリプトを実行します：

   重要：exec ツール yieldMs を 600000（10 分）に設定します。

7. 提供 — 絶対 .pptx パス、ダウンロード URL、および使用されたテンプレートファイル名を提供します。

---

レイヤー 4 — PPT 編集（AI を使用した修正）

ユーザーが自然言語を使用して既存の PPT を修正したい場合は、このレイヤーを使用します。PPTX の OSS/CDN URL が必要です（前のジェネレーションまたはアップロードから）。

ステップ

0. 詳細なワークフロー - workflow_edit.md を実行する前のアクションの直前に読んでください！
1. 環境チェック — 上記のチェックを実行して $PYTHON_CMD を取得します。
2. PPTX URL を取得 — ユーザーのメッセージから取得するか、最初にローカルファイルをアップロードします。
3. --pptx-url でスクリプトを実行します：

   $PYTHON_CMD scripts/run_ppt_write.py "edit instruction" \
     --language Chinese \
     --pptx-url "https://cdn.example.com/file.pptx" \
     -o /absolute/path/output.pptx
   

   重要：exec ツール yieldMs を 600000（10 分）に設定します。

4. 提供 — ダウンロードリンク、ローカルパス、および変更内容のサマリーを提供します。

---

レイヤー 3 — ローカルファイル操作

# スライド数とタイトルを検査
$PYTHON_CMD scripts/local_pptx_ops.py info --file my.pptx

# スライドを削除（1 ベースのインデックス；3,5,7-9 などの範囲をサポート；-o を省略するとその場で上書き）
$PYTHON_CMD scripts/local_pptx_ops.py delete --file my.pptx --slides 3,5,7-9 -o trimmed.pptx

# スライドの順序を変更（すべてのスライドをリストする必要があり、省略不可）
$PYTHON_CMD scripts/local_pptx_ops.py reorder --file my.pptx --order 2,1,4,3,5

# スライドのサブセットを新しいファイルに抽出
$PYTHON_CMD scripts/local_pptx_ops.py extract --file my.pptx --slides 1-3 -o subset.pptx

# 複数のファイルを結合
$PYTHON_CMD scripts/local_pptx_ops.py merge --files a.pptx b.pptx -o merged.pptx

workflow_local.md を実行する前のアクションの直前に読んでください！

---

エラー処理

• 不十分な利点：スクリプト（生成、模倣、編集）を呼び出すときに、スクリプトまたはログに Insufficient benefit. Please upgrade your account at {url} というメッセージが表示される場合があります。これは、ユーザーの利点レベルがこのスキルの要件を満たしていないことを意味します。

利点が不足している場合の返答方法

上記を検出した場合、ユーザーの現在の言語で返答します— 英語メッセージをそのまま繰り返さないでください。このパターンを使用してください：

• 伝える内容：「申し訳ございません。PPT 生成が失敗しました。このスキルを使用するには Skywork メンバーシップのアップグレードが必要です。」その後、単一の行動喚起リンク。
• 形式：ユーザーの言語での短い 1 文 + [今すぐアップグレード →](url) または同等の言語のリンク。
• URL：ログ/スクリプト出力からアップグレード URL を抽出します（例：at https://... の部分）。

注：エラーが Insufficient benefit の場合にのみアップグレードを提案してください。NO_TOKEN / INVALID_TOKEN / 401 / "invalid API key" などの認証エラーの場合は、エラーコード/メッセージを保持し、ユーザーに SKYWORK_API_KEY を更新するよう案内してください。メンバーシップのアップグレードを提案しないでください。

---

依存関係

• Python 3.8+（必須）— python3 / python は PATH にある必要があります
• レイヤー 3 ローカル操作：pip install python-pptx --break-system-packages

（環境チェックステップはすべての必須依存関係を自動的にインストールします。）

---

どのレイヤーをトリガーするか？

シナリオ	使用
トピックまたは既存の参照ファイルから PPT を生成	レイヤー 1
既存の .pptx のレイアウト/スタイルを模倣	レイヤー 2
既存の PPT を自然言語で編集/修正	レイヤー 4
ローカル .pptx ファイル内のスライドを削除/並び替え/抽出/結合（バックエンドなし）	レイヤー 3