Claude Code × Google Slides API： スライドを自動生成する仕組み

AIスライド自動生成の仕組みを作りました。

「自分が狙うゴールの状態を最短距離で生成する設計」ー この重要性を再認識しました。設計プロセスを順に書き留めます。

検証工程を捨てる

仕組みを考えていくなか、「品質チェック」の工程を最初に落としました。

生成したスライドをLibreOfficeで開き、目視で破綻を確認する。品質担保には正しい工程ですが、トークンをかなり消費していました。丁寧であることと、割に合うことは別です。品質保証の工程であっても、コストに見合わなければ落とします。

守るために増やした工程が、本体を圧迫してしまうようなことは避けなければなりません。

文章"量"もデザインだ

次にぶつかったのは「型があっても崩れる」という問題。

いくら型を精緻に用意しても、そこに流し込む文章の量が長過ぎたり短過ぎたりすれば、レイアウトは崩れます。器を磨いても、中身の量が揃わなければ意味がない。

であれば、内容を変えない範囲で文章量を整理する作業は、デザイン全体のバランスを決める工程として必要です。文章量を整えることを、レイアウトを整えることと同位置に置きました。

編集工程を挟む

最初の入り口は複数パターンに対応します。テキストが提供される場合もあれば、他者が作った骨子をアップデートする場合もあります。

問題は、骨子がある程度形になっている場合です。そのラフを"用意した型"に当てはめようとすれば、当然崩れます。型に沿った編集工程を無視しているからです。

よって、間に"編集"を挟むことにしました。まずラフを「テキスト情報」に変換する（還す）。そのうえで、テキストを型にはめ込む。

形式を捨て、情報だけを取り出す。 他者が制作した成果物の見た目に引きずられず、中身だけを受け取り、型に入れ直す。「入力を整えてから型に入れる」という構えです。

用意されたゴールを、疑う

ここは、今回最も大きな転換でした。

当初のゴールは「ppt形式で出力する」でした。Claude DesignやClaude Codeがpptを出すので、ゴールもpptである。そう思い込んでいました。もちろんHTMLもPDFも選べるのですが、用意された選択肢の中から選ぶ、という発想から出られていなかった。

しかし、実際の運用を考えると、全社で最終的に運用される形式はGoogle Slideです。私は「pptを手動でGoogle Slideに変換すればいい」と無意識に思い込んでいたのです。

ゴールは"綺麗なスライド"ではなく、"Google Slideで共有される状態"こそがゴールである。

Google Slides APIを活用し、直接生成する方向に切り替えました。実装して生成が成功したとき、文字サイズ・行間・レイアウトの細部がページごとに揃っていました。

"自分が狙うゴールの状態から逆算して、そこへ最短距離で届く設計を組む" という思考の重要性。そして、"ツールが差し出す答えを疑う重要性"を、心に刻みました。

事故を防ぐこと・事故に気づくこと、2つを共存させる

型を整える作業には、定常のサイクルがありました。正典（型のカタログ）を手で微調整し、その値をコードに反映し、コードから正典へ書き戻して整合をとる。

この「書き戻す」工程が、一度事故を起こしました。書き戻すと正典の全ページが置き換わってしまった。使っていた仕組みが、ページ単位ではなくファイルまるごとを差し替える仕様だったからです。

そのときAIは「書き戻すのをやめましょう」と提案してきました。正典は手元の編集物のまま置き、コードはそれを実測して追従するだけにする。安全という一点では、正しい提案でした。

しかし、私は以下のように返答しました。

書き戻しは、事故を起こす工程であると同時に、事故を発見する唯一の工程でもありました。AIの提案は前者しか見ておらず、後者ごと捨てるものだった。事故を防ぐことだけを見て、気づく側を潰していたのです。

危険な工程は、たいてい検知の工程でもある。だとすれば、問うべきは「やめるか、続けるか」ではありません。危険な部分だけを、どこに逃がすか。

着地した答えは、書き込み先を変えることでした。正典そのものではなく、失っても困らない別ファイルに書き戻す。理想の型は「編集用」に、実装された型は「書き戻し用」に分ける。両者を突き合わせれば、コードが正典からズレた瞬間に検知できます。

「指示されたページだけ触る」というルールは作れていた。しかし、守れたかを確かめる手段が無かった場合、破っても誰も気づけない。ルールを作った際に用意すべきは、それが守られたかを機械で確かめる手段でした。

いくつもの判断がありました。そのなかでも今回は「目の前の枠組みを、そのまま受け取らないこと」この大切さを再認識しました。

用意された枠組みを一度疑い、本当に叶えたい状態から逆算する。その姿勢でこれからも、"何が理想なのか"を常に考え続けたいと思います。