メインコンテンツへスキップ
見出し画像

AI同士に設計レビューさせて翻訳サイトを作ってみた


    Aozora Daily Translations

    最近、AIを使った自動出版の仕組みを実験しています。

    その実験として作ったのが Aozora Daily Translations です。

    画像

    https://garyohosu.github.io/AozoraDailyTranslations/

    このサイトは、青空文庫の作品をAIで英訳し、GitHub Pagesで公開するプロジェクトです。
    日本文学を英語で読める形にしながら、AIエージェントによる自動出版の仕組みを検証しています。


    プロジェクトの目的

    青空文庫には、日本の文学作品が大量に公開されています。
    多くが著作権切れであり、パブリックドメインとして自由に利用できます。

    つまり

    ・翻訳
    ・公開
    ・再利用

    が可能です。

    そこで考えたのが「AIで毎日1作品ずつ英訳して公開するサイトを作れないか」というアイデアでした。


    サイト

    Aozora Daily Translations

    https://garyohosu.github.io/AozoraDailyTranslations/

    例:

    https://garyohosu.github.io/AozoraDailyTranslations/works/2026-03-06-no-4872/index.html

    このように、青空文庫の作品をAIで英訳して公開しています。


    画像

    普通のAIプロジェクトと違うところ

    このプロジェクトの特徴は実装前にかなり厳密な設計を行ったことです。

    しかもレビューは人間ではなく

    ・Claude Code
    ・Codex CLI

    の 2つのAI に行わせました。


    画像

    設計ドキュメント

    最初に作ったのは次の設計ドキュメントです。

    SPEC
    USECASE
    SEQUENCE
    CLASS
    QA

    それぞれ役割があります。

    SPEC
    仕様定義
    https://github.com/garyohosu/AozoraDailyTranslations/blob/main/SPEC.md

    USECASE
    システムの利用シナリオ

    画像

    https://github.com/garyohosu/AozoraDailyTranslations/blob/main/USECASE.md


    SEQUENCE
    処理フロー

    画像


    https://github.com/garyohosu/AozoraDailyTranslations/blob/main/SEQUENCE.md


    CLASS
    データ構造

    画像


    https://github.com/garyohosu/AozoraDailyTranslations/blob/main/CLASS.md

    QA
    AIからの質問と回答
    https://github.com/garyohosu/AozoraDailyTranslations/blob/main/QA.md


    AIレビュー

    設計ドキュメントが完成した後、

    Claude Code
    ↓
    Codex CLI
    ↓
    Claude Code

    という形でレビューを行いました。

    AI同士のレビューによって

    ・状態管理の矛盾
    ・仕様の曖昧さ
    ・例外処理の抜け

    などが見つかりました。

    人間だけで設計していたら気づかなかった点も多かったです。


    一番大変だったのはQ&A

    このプロジェクトで一番苦労したのはQA.mdです。

    ここでのQAはQuality AssuranceではなくQuestion & Answerです。

    つまりAIが設計に質問するドキュメントです。


    AIの質問

    AIが引っかかったポイントは主に3つありました。

    1 OpenClawとは何か

    AIが最初に理解できなかったのがOpenClawとはどんなサービスかという点でした。

    人間にとっては簡単ですが、AIは

    ・SaaSなのか
    ・CLIツールなのか
    ・APIなのか

    を区別できません。

    つまり実行環境の前提が分からないという状態になります。


    2 翻訳エンジン

    次に質問されたのが翻訳APIは何を使うのかという点です。

    AIにとっては

    DeepL
    Google Translate
    OpenAI API
    ローカルLLM

    など複数の可能性があります。

    つまり翻訳エンジンを明示しないと設計が確定しないという問題です。
    Codex CLIの定額プラン(ChatGPT Plus)を使用しました。


    3 Codex CLIの動作モード

    もう一つ質問されたのがCodex CLIの実行方法です。

    Codex CLIには

    対話型
    バッチ型

    という使い方があります。

    対話型
    → 人間が操作

    バッチ型
    → 自動実行

    この違いによってシステム設計が変わるため、AIはここを確認してきました。


    AIが苦手なもの

    今回のプロジェクトで分かったことがあります。

    AIが苦手なのは

    コードではなく前提条件です。

    例えば

    ・ツールの役割
    ・実行環境
    ・運用方法

    こういう部分が曖昧だとAIは理解できません。


    AI開発の本質

    AIを使った開発ではコードを書くことより仕様を書くことが重要になります。

    つまり

    ・前提を書く
    ・状態を書く
    ・曖昧さを消す

    という作業です。


    実装

    設計が固まった後に実装しました。

    完成したサイトはこちらです。

    https://garyohosu.github.io/AozoraDailyTranslations/

    青空文庫の作品をAIで英訳して公開しています。
    ただのプログラムと違うのはOpenClawが毎日AIエージェントのバーチャル社員を働かせて一日1作品ずつ翻訳してデジタルコンテンツを増やしていることです。見かけ上ただのプログラムですが、これは「AIエージェントが働くバーチャルカンパニー」なのです。人が関与せずにデジタルコンテンツが生まれるのです。


    AI出版社の実験

    このサイトは単なる翻訳サイトではありません。

    これはAI出版社の実験です。

    AIが

    翻訳
    編集
    公開

    まで行う仕組みです。


    AI時代の出版

    AIが進化すると

    翻訳コスト
    出版コスト
    配信コスト

    はほぼゼロになります。

    つまり

    世界中の文学が自動翻訳される

    未来が来ると思っています。

    青空文庫はその実験としてとても良い素材です。


    リポジトリ

    https://github.com/garyohosu/AozoraDailyTranslations

    設計ドキュメントもすべて公開しています。

     
     
    猫好きプログラマ。半導体会社の技術者 Q&AサイトのQuoraでフォロワー数6000人の「ChatGPT情報交換所」を主宰する程生成AI好き ポートフォリオ https://hantani-portfolio.pages.dev/

    あなたへのおすすめ