AI と一緒に個人サイトを作るときの進め方と注意点
私は個人サイトのコードや記事の下書きを、AI(Claude)に手伝ってもらいながら作っています。AI に任せる部分と自分で決める部分の分け方、確認のしかた、気をつけている点をまとめます。
私と AI の役割分担
私は会社員として、システム開発の PM(プロジェクトの管理)や SE(システムの設計・開発)の仕事をしています。個人サイトでも、その経験を生かして、AI と役割を分けて進めています。
基本の考え方は、「AI は下書きと相談の相手、決めるのと確認するのは自分」です。AI はコードや文章を速く書いてくれますが、間違いを含むこともあります。公開するかどうか、何を書くかは、私が確認してから決めています。
用語の説明
- 生成 AI:質問や指示に応じて、文章やコードを作る AI のこと
- プロンプト:AI に渡す指示や質問の文章
- 下書き:そのまま使うのではなく、確認して直す前提の文章やコード
- ビルド:作ったプログラムを、公開できる形のファイルにまとめる作業
進め方の流れ
1つの機能や記事を作るときは、次の順で進めています。
- 何を作りたいか、何をしないかを、自分の言葉で短く書く
- AI に、作り方の案や下書きを出してもらう
- 出てきたコードを、自分のパソコンで実際に動かしてみる
- 動きや表示を自分の目で確認し、おかしな点を AI に伝えて直してもらう
- ビルドが通ることを確かめてから公開する
AI に任せやすいこと
- 画面の部品や、決まった形のコードの下書き
- エラーの文章の意味を調べること
- 記事の構成案や、下書きの文章
- 作ったコードの見直し(読みにくい所や、抜けている所の指摘)
自分で決める・確認すること
- サイトの目的と、誰に向けて書くか
- 記事に書く自分の経験(AI に経験を作らせない)
- サービスの規約・料金・上限などの事実(公式の情報で確かめる)
- 公開してよいかどうかの最終判断
- API トークンやパスワードなど、秘密の情報の扱い
記事の下書きで気をつけていること
AI に記事の下書きを頼むと、それらしい数字や体験談が入ってくることがあります。私は、自分が実際に経験していないことは書かないようにしています。
また、サービスの画面や規約について書くときは、必ず公式の情報を確かめ、確かめられないことは「執筆時点では」と書いて、読者にも公式の確認をお願いするようにしています。断定してよいか迷うことは、断定しないのが安全です。
よくあるつまずき
- AI が書いたコードを、動かして確かめずに公開してしまう
- 一度にたくさんの変更を頼み、どこで壊れたのか分からなくなる
- AI の説明をうのみにして、古い情報や存在しない設定を使ってしまう
- 秘密の情報を、そのまま AI への質問に貼り付けてしまう
- AI が出した文章を、自分の言葉に直さずにそのまま記事にしてしまう
確認のチェックリスト
公開する前に、次の点を確認しています。
- ビルドが通り、手元で表示を確認したか
- スマートフォンでも表示を確認したか
- 記事の中の事実を、公式の情報で確かめたか
- 自分が経験していないことを、経験のように書いていないか
- 秘密の情報がコードや記事に入っていないか
私の場合
このサイトを含め、私が運営しているサイトはすべて、AI に手伝ってもらいながら作りました。事前レンダリングの仕組みや、数字を自動で集めるアプリも、AI と相談しながら形にしました。
一方で、Vercel の規約を読んでサイトを移すと決めたことや、審査の結果を受けて何を直すかを決めたことは、自分の判断です。AI のおかげで作業はかなり速くなりましたが、確認の手間は省かないようにしています。
頼み方の工夫
AI に頼むときは、一度に大きな変更をまとめて頼まず、小さく区切るようにしています。例えば「記事のページの見た目を直す」「サイトマップに新しい記事を足す」のように、1回の依頼で1つのことだけを頼みます。
また、今のコードや設定の一部と、「何が起きていて、どうなってほしいか」を具体的に伝えます。エラーが出たときは、エラーの文章をそのまま見せると、原因を一緒に考えやすくなります。うまくいかないときは、前の状態に戻せるように、変更の前にファイルを残しておくと安心です。
次にやること
これから AI と一緒にサイトを作る場合は、まず小さなページを1つ作り、公開までの流れを一通り試してみるのがおすすめです。流れが分かると、どこを AI に頼み、どこを自分で確認すればよいかが見えてきます。
※AI の機能や利用条件は、サービスによって違い、変わることもあります。使う前に各サービスの公式の情報をご確認ください。