Claude Codeでブログを作り直す:AI量産記事の失敗から、調査・設計・ツール作りまで

AI・自動化・技術

Claude Codeでブログを作り直す:AI量産記事の失敗から、調査・設計・ツール作りまで

このブログ「フリーランスエンジニア研究所」は、いま全面的に作り直している途中です。作り直しには、AnthropicのClaude Code(Proプラン)を使っています。
この記事では、なぜ作り直すことにしたのか、Claude Codeに何を任せて何を任せなかったのかを、実際の進め方とあわせてまとめます。

きっかけ:AIで量産した記事に、事実と違う経歴が混ざっていた

以前は、Geminiに記事を書かせて、そのまま投稿していました。
作り直しにあたって、Claude Codeで公開中の記事を全件読み込んで点検したところ、記事ごとに私の経歴が食い違っていることが分かりました。たとえば、

  • ある記事では「文系出身」(実際は理系で、組込み系から始めています)
  • ある記事では「フリーランス10年目」(実際は2019年に独立して8年目です)
  • ある記事では「週5日常駐」(実際はほぼ週5日リモートです)
  • 「トップクラスのWebマーケター」という、名乗ったことのない肩書

AIは、それらしい人物像を記事ごとに作ってしまいます。確認せずに投稿していたので、事実ではない話が積み重なっていました。文章も一般論が多く、読み返すと人間味がありませんでした。

これは読者に対して不誠実ですし、Googleも、生成AIで価値を加えずに大量のページを作ることはスパムポリシーに当たりうるとしています(Google 検索セントラル:生成AIコンテンツに関するガイダンス)。そこで、記事は基本的に1から作り直すことにしました。

進め方:毎日1〜2時間、Claude Codeと壁打ち

作業は、毎日1〜2時間ずつClaude Codeと対話しながら進めています。自分一人でやっていたら、途方もない時間がかかったと思います。

いちばん助かったのは、いきなり作業させず、計画を練ってから段階を踏んで進められることです。Claude Codeには、実装に入る前に調査と計画だけを行うモードがあり、次の順番で進めました。

  1. 既存のサイトと開発環境を調査する
  2. 問題点と、作り直しの方針を整理する
  3. 設計文書を作る(サイト構成、相談ページ、セキュリティ、法令の確認事項など)
  4. 必要なツールだけを作り、テストする
  5. 記事を1本ずつ作り直す

AIに本番サイトを触らせない設定

一方で困ったのは、ルールをしっかり定義しておかないと、誤った操作をする危険があることです。AIは指示されたことを素早く実行しますが、本番のサイトで間違えると取り返しがつきません。
そこで、次のように「できないこと」を先に決めました。

決めたこと方法
本番のWordPressには書き込ませないログイン情報(Application Password)をそもそも発行しない。公開されているREST APIを読むだけにする
反映は自分でやるClaude Codeは本文やファイルを作るところまで。WordPressへの反映は私が手作業で行う
見せたくないファイルは読ませない個人情報や記事のバックアップを置くフォルダを、Claude Codeの設定で読み取り禁止にする
接続先を絞るサンドボックス(隔離された実行環境)を有効にし、許可していない通信は止まるようにする
ルールを文書にするプロジェクトのルールを CLAUDE.md に書き、作業の引き継ぎメモをセッション開始時に自動で読み込ませる

文書に「やらないで」と書くだけでは不十分なので、設定やツールの作りでも制限をかけています。

事実と違う記述を防ぐ:「事実の基準」と取材シート

経歴の食い違いを繰り返さないために、私について書いてよい事実を1つのファイル(profile-facts.md)にまとめました。記事で私の経験に触れるときは、このファイルの内容だけを使うルールです。
そのうえで、記事は次の流れで作っています。

  1. Claude Codeが、記事の設計と私への質問(取材シート)を作る
  2. 私が質問に答える(箇条書きで十分)
  3. Claude Codeが下書きを作り、品質を100点満点で採点する
  4. 私が事実関係を確認して、WordPressに反映する

AIに考えさせるのは構成や文章で、経験の中身は私が出す、という分担です。

AIの間違いを見つけた例

この流れでも、AIの出力をそのまま信じないことが大事でした。
独立準備の記事を作っていたとき、Claude Codeは最初、開業届の提出期限を「事業を始めた日から1か月以内」と書きました。民間の解説サイトを根拠にしたものです。その後、国税庁のページを直接確認したところ、記載は「事業を始めた年分の確定申告書の提出期限まで」となっていて、下書きを直しました。
制度や数値は、必ず公式の情報で確かめる。これを編集のルールにしています。

作ったツール:記事を全件保存するPythonスクリプト

作り直す前に、公開中の記事をすべて手元に保存するツールをClaude Codeに作ってもらいました。WordPressの公開REST APIから記事を読み、Markdownと元のHTMLで保存します。
読み取り専用のツールですが、安全のために次のような作りにしています。

  • 接続してよいのは、このサイトのHTTPSだけ
  • リダイレクトで別のサイトに飛ばされても追いかけない
  • タイムアウトを設け、失敗したときの再試行は回数を決めて行う
  • 投稿者の情報は取得しない
  • 保存先が既にあれば止まる(上書きしない)

たとえば、接続先をチェックする部分はこうなっています。

def check_url(url):
    parts = urlsplit(url)
    if parts.scheme != "https" or parts.hostname != ALLOWED_HOST or parts.username or parts.password:
        raise ExportError(f"許可されていないURLです: {parts.scheme}://{parts.hostname}{parts.path}")
    return url

通信が失敗したときは、サーバーが混んでいる場合(429や503など)だけ、少し待ってから再試行します。

for attempt in range(1, MAX_ATTEMPTS + 1):
    try:
        with opener(request, timeout=TIMEOUT) as response:
            return response.read(), response.headers
    except urllib.error.HTTPError as e:
        if e.code not in RETRY_STATUSES or attempt == MAX_ATTEMPTS:
            raise ExportError(f"HTTP {e.code}: {urlsplit(url).path}") from None
        wait = _retry_after(e.headers) or 2 ** attempt
    ...
    sleep(min(wait, 60))

テストも一緒に作ってもらいました。実際のサイトには接続せず、通信部分を偽物に差し替えて、「別のサイトのURLは拒否する」「再試行は決めた回数で止まる」「保存先を上書きしない」といった動きを確認しています。

やってみて分かったこと

  • 計画を先に作ると、AIの作業がぶれにくい。 調査と設計を文書にしておくと、後の作業でAIが方針から外れたときに気付けます。
  • 「やらないこと」は設定で縛る。 文書のルールだけでは足りません。権限や接続先を絞っておくと、安心して任せられます。
  • 経験はAIに作らせない。 構成や文章はAIに任せても、経験や数値は人が出し、公式の情報で確かめる必要があります。

作り直しはまだ途中です。進んだら、また記録していきます。

コメント

タイトルとURLをコピーしました