良いプロンプトの作り方

架空のエンジニア向け眼鏡店「視力C++」の通販サイトを、要件定義は Copilot、実装は Claude に分担して構築した記録。ハンバーガーメニュー、パンくずリスト、カルーセル、FAQ アコーディオン、トースト通知の5つのコンポーネントの配置意図と、別の AI に伝わる要件定義書の書き方を解説。React / TypeScript による非エンジニア視点の AI 開発事例で、要件定義書の全文を付録に収録。

技術記事の執筆プロセスを Claude に GitHub 連携で全て委譲し、チャットだけで記事作成から予約投稿まで実現した事例。Zenn の GitHub 連携機能と Claude の Cowork 機能を組み合わせることで、編集画面へのコピペが不要になり、文体の一貫性確保や git による履歴管理が可能になった。投稿上限への対応やセカンドレビュー活用など、実運用での工夫も紹介。

著者が2か月間Claude の下書きに加えた215か所の修正を分類したところ、「断定を緩める」が最多で、次いで「自分の語へ」「感情表現を足す」が続く。yomiyasu と同じ下書きを比べると、著者の直しはAIっぽさの除外より「言い切りの強さ調整」に重点があり、文の組み立てレイヤーと内容判断レイヤーで異なる直しをしていることが判明した。

Zenn CLI で管理する GitHub リポジトリを Claude Code Desktop で開き、普段の開発と同じフローで記事を執筆する方法を紹介。ネタ探しから下書き・修正まで Claude に任せ、プレビュー機能で公開時の見た目を確認しながら改善できる。設定済みテンプレートリポジトリも公開。