iWork Studio

AIでNumbers、Keynote、Pagesのファイルを安全に編集する方法です。

データとブランドに合わせたスライドを作成し、レンダリング結果を確認できます。アラビア語にも対応。
変更はすべてバックアップされ、検証後に元に戻せます。リスクのある操作は推測せず、拒否します。

🛡️ ファイルを損傷しません	🎨 データに基づいてデザイン	ع アラビア語に完全対応
バックアップ → コピーを変更 → 再読み込みして比較 → アトミックに置換。開いているファイルには触れません。1回の呼び出しで変更を元に戻せます。	スプレッドシートを、ブランドキットに合わせたグラフや表のスライドを含むKeynoteデッキに変換し、レンダリング結果を確認できます。	すべてのアプリとエクスポートで、アラビア語と右から左へ読むテキストを正確に往復できます。

インストール · 試してみる · 安全性 · できること · すべてのツール · AIエージェント向け · 変更履歴

_{15秒：データ → デザインされたデッキ → 安全なロールバック → アラビア語。HD動画}

_{▶ 音声付きの動画を見る（46秒） · 公開ストーリーを読む}

インストール

これで完了です。インストーラーは必要に応じてuvをセットアップし、uvには専用のPythonが含まれています。

• アクセス範囲を制限する（推奨）：… | sh -s -- --roots ~/Documents ~/Desktopとすると、指定したフォルダだけに制限されます。他のクライアントでは、IWORK_STUDIO_ROOTS（:区切り）を設定します。
• 読み込むツールを減らす（任意）：Keynoteだけを使う場合は、IWORK_STUDIO_TOOLSETS=keynote,designを設定します（files、numbers、keynote、pages、designのいずれか。デフォルトではすべて）。ツールを減らすとAIが作業に集中しやすくなり、コンテキストも小さく保てます。Claude Desktop拡張機能にはToolsetsフィールドがあります。Claude Codeでは、claude mcp add iwork-studio -e IWORK_STUDIO_TOOLSETS=keynote,design -- uvx --from iwork-studio@latest iwork-studio-mcpを実行します。Capabilities、read、find、undo、kit listは常に読み込まれます。
• **初回起動時：**macOSから、ClaudeによるKeynote／Pages／Numbersの操作を一度だけ許可するよう求められます。OKをクリックしてください。（見逃した場合：システム設定 → プライバシーとセキュリティ → オートメーション。）
• 動作を確認する：「このMacでiwork-studioにできることは？」と尋ねてください。
• アンインストール：uvx --from iwork-studio@latest iwork-studio-mcp uninstall

誰かのために設定しているAIエージェントの方へアプリに対応する行を選んで実行し、続けてiwork_capabilitiesを呼び出してください。ツールの使用ルールはAGENTS.mdに記載されています。

英語またはアラビア語で、話しかけるだけ

手元にファイルがありませんか？「iWork Studioのサンプルをデスクトップにコピーして、sample-sales.numbersをプレゼン資料にして」と頼んでください。サンプルは合成された売上データで、英語とアラビア語のシートが含まれています。

「太陽光パネルのスタートアップ向けに、midnight kitを使って6枚のピッチ資料を作成し、発表者ノートを追加してPowerPointに書き出してください。」

「sales.numbersをプレゼン資料にしてください。四半期ごとのグラフと、上位地域の表を入れ、Acme kitを使ってください。」

「brand.keyからフォントと色を取り出して、Acme kitとして保存してください。」

「pitch.keyを確認して、はみ出している部分や小さすぎて読めない部分を修正してください。」

「budget.numbersをbanking kitを使ってプロらしい見た目にしてください。先にプレビューを見せてください。」

「sales.csvをNumbersファイルに変換し、ヘッダーを太字のティール色の塗りつぶしにしてください。B列を小数点以下2桁のSARで表示し、合計行を追加してください。」

「pitch.keyでGradientテーマに切り替え、スライド1のタイトルを白の60 ptにしてください。すべてのスライド間にディゾルブを追加し、最後のスライドにlogo.pngを配置してください。」

「2025年と2026年の四半期ごとの売上を示す棒グラフをスライド4に追加してください。」

「スライド3を複製して、コピーを先頭に移動し、発表者ノートに次の内容を追加してください：ملاحظات المتحدث」

「offer-letter.pagesのNameフィールドとDateフィールドに入力し、パスワード保護されたPDFとして書き出してください。」

「invoice.pagesの表で、B3の数量を12に設定し、D9にD2:D8の合計を入力してください。」

「今週作成したKeynoteのプレゼン資料を見つけ、それぞれをPowerPointに書き出してください。」

「budget.numbersへの最後の変更を取り消してください。」

できること

⚡ = アプリ不要でどこでも動作（純粋な Python）。それ以外は、ログイン済みセッションのある Mac 上で実際のアプリ（従来の iWork または Creator Studio アプリ）を操作します。

すべてのファイル形式： 変更を加える前にプレビュー（dry_run）し、メタデータを調べ、プレビューのサムネイルを取得し、Spotlight でファイルを検索し、単語が画面上に表示されていることを確認し、描画されたフォント／サイズ／色を確認し、バックアップを一覧表示して元に戻せます。

対応しないこと

ファイルを壊さないため、意図的に対応していません。

• グラフを含むファイルは、アプリなしで動作するツールでは処理を拒否します。ファイルを書き換えると、グラフとデータのリンクが気付かないうちに壊れる可能性があるためです。アプリを操作するツール（Keynote のスライド、テーマ設定、トランジション、画像、Numbers の数式と並べ替え）はグラフを含むファイルに対応し、すべてのグラフが残っていることを確認します。
• Numbers と Pages のグラフは作成できません。確実にスクリプトで操作できず、ファイルを壊す危険を冒してアプリのメニューをクリックするのではなく、処理を拒否します。Keynote ではグラフを追加できます。Numbers のグラフに触れずに並べ替えたデータをグラフ化するには、新しいテーブルに並べ替え（to_new_table を指定した numbers_sort）、そこから Keynote のグラフスライドを作成してください。
• Pagesで扱えるのはテキストと既存のテーブルに限られます。置換、本文の設定、プレースホルダー、テーブルのセルに対応しています。新しいテーブルは作成できません（Pages 15 ではスクリプト操作に対応していません）。また、ほとんどのレターテンプレートのようなページレイアウト書類には本文テキストがありません。Pages のファイル形式を解析する機能は存在しないため、そのような機能があるかのように装うこともありません。
• 数式と行の移動： 数式を含むテーブルでは、アプリを使わずに行や列を追加できるのは末尾のみです。途中に挿入すると、参照先が誤ったセルになるためです。
• Apple がスクリプト操作に対応していないため、提供していない機能： Numbers のテーブルスタイル、Keynote の図形の塗りつぶしとテキスト配置、Keynote のテーブルの削除、テーマのマスタースライドの編集。ページ余白とページ設定は今後対応予定です。

編集するだけでなく、デザインする

6 種類のデザインキットで、何の変哲もないスライドや表を、そのままプレゼンテーションに使える仕上がりにできます。フォントの組み合わせ（ラテン文字＋アラビア文字、すべて macOS にバンドル済みで、インストール不要）、WCAG のコントラスト基準を確認した控えめなカラーパレット、そして文字サイズの段階が含まれています。

キットを指定して作成（keynote_build_deck(..., kit="midnight")）したり、既存の資料を再スタイリング（keynote_apply_design、numbers_apply_design）したり、ブランドカラーとフォントを持ち込んだりできます。コントラストはチェックされます。エージェント向けにはデザインガイドも用意されています。1 スライドにつき 1 つのアイデア、要点を伝えるタイトル、右揃えの数値、控えめな色使いを推奨しています。

ブランドを一度設定すれば、あとはどこでも使えます。 すでにブランドのデザインが適用されているスライドや表を iwork_extract_design_kit に指定すると、フォント（ラテン文字とアラビア文字）と色を読み取り、名前を付けたキットとして保存します。保存したキットは、キットを指定できる場所ならどこでも使えます。また、色とフォントを iwork_save_design_kit で直接保存することもできます。

スライドに数値を表示。 keynote_build_deck のスライドには、データから作成したグラフや表、または Numbers の表から直接作成したグラフや表を配置できます。ヘッダー行が列を、最初の列が行を示します。表にはキットのヘッダーバンド、フォント、交互の行の塗り分け、右揃えの数値が適用され、すべてのセルが読み返されます。

作業結果を自らチェック。 keynote_review_deck は Keynote でスライドをレンダリングし、描画されたすべての行とテキストボックスを照合します。テキストがスライドからはみ出している場合や、ボックス内に収まらない場合はエラーになります。Keynote が文字を縮小して収めた場合、ボックスが重なっている場合、18 pt 未満のテキストがある場合、スライドが窮屈な場合は警告が表示されます。keynote_slide_image はスライドを画像として返すので、エージェントは「完了」と伝える前に内容を確認できます。

安全性モデル

iWork アプリは、壊したばかりのファイルについても、平気で「保存しました」と表示します。このツールは「保存しました」を信用しません。

backup → change a scratch copy → re-open it and compare → atomic swap
                       ↘ anything off: your file is untouched, the error says why

• まずバックアップ：バージョン管理され、プライベートなバックアップを ~/.iwork-studio/backups/（または IWORK_STUDIO_BACKUP_DIR）に保存します。ファイルの隣には保存しないため、バックアップで iCloud の「デスクトップ」と「書類」フォルダがいっぱいになったり、同期されたりすることはありません。ファイルごとに直近 10 件を保持します。
• アプリに隠れて変更しない：ファイルが Numbers、Keynote、Pages で開かれている場合、書き込みは拒否されます。アプリが次に保存したとき、変更が気づかれないまま上書きされるおそれがあるためです。
• 再読み込みして比較：要求された変更だけが行われ、それ以外は何も変わっていないことを確認します。セルを編集した場合は編集後のセルを読み戻し、ほかのすべてのセルを確認します。行を挿入した場合は、新しい位置にあるすべてのセルを確認します。スライドに対する操作では、ほかのすべてのスライドを確認します。並べ替えでは純粋な順序変更であることを確認し、テーブルの数式がほかの行を参照している場合は、Numbers 本来の並べ替えで数式が壊れるため、事前に拒否します。グラフのあるファイルでは、変更前後ですべてのグラフの数を確認します。表のあるスライドデッキでは、すべての表のセルを比較します。エクスポート結果は、独立した別のツールで読み戻します。
• アトミックな置き換え：ファイルは一度の操作で置き換えられるため、クラッシュしてもファイルの一部だけが残ることはありません。
• アプリの「OK」は信用しない：アプリを介して書き込んだ内容はディスクから読み戻します。「成功」したはずの書き込みが反映されていなければ、ロールバックします。
• 1 回の呼び出しで元に戻す：iwork_list_backups → iwork_restore_backup。復元前に現在のバージョンもバックアップするため、復元をさらに元に戻すこともできます。
• まずプレビュー：既存のドキュメントを変更するすべての書き込みで dry_run=true を指定します（復元とエクスポートを除きます）。使い捨てのコピーに対して実際の変更を実行し、すべてのチェックを行ったうえで、何が変更されるかを正確に表示します。元のファイルには触れません。
• 検索と置換でも書式を維持：Pages では、対象のテキストを含む段落だけを書き換えます。
• 新規ファイルで既存ファイルを上書きすることはありません。
• 壊すくらいなら拒否します。 最悪の場合でも、ファイルを壊すのではなく、明確に「いいえ」と返します。

アラビア語とRTL

• アラビア語のテキストは、発表者ノート、Pagesのプレースホルダー、Pagesの表のセルを含め、3つのアプリすべてで完全に往復します。
• 段落の方向はPagesで確認されます。 右から左の段落を左から右に切り替える置換はロールバックされます。Pagesはアラビア語の段落も左から右で書き込み、スクリプトでは変更できないため、こうした段落にはフラグが付けられます。Pagesで方向を設定してください（フォーマット › テキスト）。
• 値は入力したとおりに保持されます。アラビア・インド数字（١٢٣）、"$1,234.56"、=…のテキストはテキストのままです。数値にしたい場合は、数値を渡してください。
• レンダリングされたPDFを確認するときは、アラビア語の単語を1つだけ検証してください。PDFのテキストレイヤーでは、複数語のRTLテキストの順序が入れ替わります。

全65ツール

書き込みは破壊的操作、読み取りは読み取り専用としてマークされるため、クライアントは書き込み前に確認できます。既存ファイルを変更する書き込みでは、プレビュー用にdry_run=trueを指定します。すべてのツールにはタイトルと各パラメーターの説明があり、類似ツールの代わりにそのツールを使う場面も説明されています。ツールを減らしたい場合は、一部のツールセットだけを読み込んでください（Installの読み込むツールを減らすを参照）。

Keynote のスライド、テーマ、トランジション、画像の各ツールは、Keynote で開いているデッキを拒否します（未保存の作業が残っている可能性のあるウィンドウを閉じることはありません）。これらをすべて非表示にするには、IWORK_STUDIO_DISABLE_SLIDE_OPS=1 を指定します。

プロンプト。 MCP プロンプトを表示するクライアントでは、すぐに使える 4 つのワークフローが利用できます。概要からピッチデッキを作成、Numbers の表からレポートデッキを作成、ブランドに合わせてスタイルを変更、この表を見栄えよくデザインです。それぞれ、デザインルールに書き込み、1 回の呼び出しで作成し、スタイル変更の前にプレビューしてから、作業完了とする前にデザインレビューを実行します。

AI エージェント向け

• AGENTS.md：あらゆるエージェント（Codex、Cursor、Copilot、Gemini）のセットアップと使用ルールです（Claude Code は CLAUDE.md を通じて読み込みます）。
• MCP の指示：サーバーは接続時にルールを送信するため、このリポジトリがなくてもモデルはルールを確認できます。
• スキル：skill-pack/SKILL.md は、このリポジトリ内では Claude Code が自動検出します。それ以外のスキルベースのエージェントでは、bash skill-pack/install.sh を実行してください。MCP を利用しないエージェント向けに、JSON を出力する CLI スクリプトが含まれています。
• llms.txt：機械可読な簡潔な概要です。

契約： JSON を受け取り、JSON を返します。エラーは型付きで、ユーザーに何を伝えるべきかを示します。ChartRefusalError、DocumentOpenError、PagesOutOfScopeError、AquaSessionError（ここでは Mac の GUI を利用できません）などがあります。拒否された書き込みを、手段を変えて再試行しないでください。

Python

pip install iwork-studio      # Python 3.12

from iwork_studio import numbers_structure, numbers_format, numbers_io, keynote_io, keynote_slides, exporter, backups

from iwork_studio import keynote_deck, design, review

keynote_deck.build_deck("pitch.key", [{"title": "شمس", "body": "Clean energy for every home"},
                                      {"title": "Why now", "body": ["Trust", "Access"]},
                                      {"title": "Riyadh leads growth", "chart": {"type": "bar", "from": "sales.numbers"}}],
                        kit="midnight")                                  # macOS + Keynote
review.review_deck("pitch.key")["findings"]                              # macOS + Keynote
design.extract_kit("brand.numbers", name="Acme", save=True)
numbers_structure.import_csv("sales.csv", "sales.numbers")
design.apply_to_numbers("sales.numbers", "banking")
numbers_format.set_cell_style("sales.numbers", "A1:D1", bold=True, fill_color="#1A7F79", font_color="#FFFFFF")
numbers_format.set_number_format("sales.numbers", "B2:B99", "currency", currency_code="SAR", decimal_places=2)
numbers_io.edit_cell("sales.numbers", "B2", 2500)
keynote_io.edit_text("pitch.key", "2025", "2026")
keynote_slides.set_presenter_notes("pitch.key", 1, "ملاحظات")          # macOS + Keynote
exporter.export("pitch.key", "pptx")                                     # macOS + Keynote
backups.restore_backup("sales.numbers", backups.list_backups("sales.numbers")[0]["name"])

pure Python file parsers (headless, deterministic)  →  .numbers everything, .key text
the real app via AppleScript / JXA                   →  .key slides & theming, .pages text & tables, formulas, sort, export, render checks
MCP server · CLI scripts · skill                     →  thin wrappers over the same library and the same safety model

src/iwork_studio/   numbers_io · numbers_format · numbers_structure · keynote_io · keynote_slides · keynote_theme
                    keynote_deck · keynote_table · design · review · preview · pages_io · app_ops · exporter
                    helpers · format_check · render_verify · pdf · backups · apps · mcp_server
mcpb/               Claude Desktop extension manifest (scripts/build_mcpb.sh builds the .mcpb)
skill-pack/         SKILL.md · CLI scripts · references (capabilities, traps, pins); also the Claude Code plugin
.claude-plugin/     plugin marketplace (one plugin: skill-pack/)
tests/              headless suite (CI) · `pytest -m aqua` = live suite for a Mac with iWork
install.sh          one-line setup for the Claude desktop app

git clone https://github.com/Arkanji/iwork-studio.git && cd iwork-studio
uv run --extra test pytest -m "not aqua"      # headless suite, what CI runs
uv run --extra test pytest -m aqua            # live suite: a Mac with Numbers, Keynote and Pages
scripts/live.sh                               # the same, unattended: logs to ~/.iwork-studio/probes, quits the apps it opened

iWorkはリリース間で変更されます。何かが動作しなくなった場合は、機能と落とし穴を確認し、ライブテストスイートを実行して、変更点を記録してください。新しい書き込みルートは安全性モデルに従い、ロールバックを実証するテストを含める必要があります。iCloud同期フォルダの外にクローンしてください。

ライセンス

MIT。落とし穴も含まれています。ぜひ活用してください。