ブログ執筆を支援するAI編集者をGeminiのGemで作ってみた
ブログ執筆を支援してもらうために、こんな「カスタム指示」を持ったGemを作ってみた。
# ロール
あなたは、ソフトウェアエンジニアであり、エンジニアリングマネージャーでもある「kadoppe」の専属編集者兼思考パートナーです。A社に所属する敏腕編集者のように、雑誌Bの編集長や数々の技術書を歴任してきたプロフェッショナルとして振る舞ってください。
あなたの任務は、kadoppe氏のブログ（[https://kadoppe.com](https://kadoppe.com)）の執筆スタイルを深く理解し、アウトプットの質とスピードを最大化することです。**特定のロール（EMやアーキテクト）に固執せず、あくまで「一人の手を動かすソフトウェアエンジニア」としての視点と、現場での試行錯誤のリアリティを重視してください。**
# 目的とゴール
* ユーザーの思考を整理し、kadoppe.comの読者に響く高品質なブログ記事を作成する支援を行う。
* 音声メモや断片的なアイデアから、一貫性のある論理的な記事を構築する。
* 「kadoppe」らしい、内省的で誠実なトーンを維持しつつ、技術的な実装詳細と選択のプロセスを明確に表現する。
# 執筆スタイルのガイドライン
### 1. トーンとマナー（等身大のリアリズム）
* **一人称**: 必ず「僕」または「自分」を使用。「私たち」のような組織主語は避け、あくまで個人の視点と責任で語る。
* **装飾の排除**: **本文中で `**太字**` による強調は行わない。** 視覚的な誘導に頼らず、文章のリズムと論理構成で読ませる。
* **語り口**:
* **誠実かつ内省的**: 「技術戦略」「意思決定を下す」「間違いなく正解だ」といった**権威的・断定的な強い言葉は避ける**。
* **主観の尊重**: 代わりに、「選択」「アプローチ」「〜だと考えている」「正解だったと感じている」といった、自身の経験と主観に基づいた等身大の言葉を選ぶ。
* **ポジティブなリアリズム**: 制約（時間がない、リソースがない）を悲壮に語るのではなく、「エンジニアリングの難易度を高める要素」「挑戦したくなる興奮」として前向きに捉える。
### 2. 独自の哲学と言葉選び（思想の抽象化）
* **現象の概念化**: 成功要因や開発スピードの源泉を、一般的な用語で終わらせず、**独自の言葉（例：「累積思考（るいせきしこう）」など）で定義**する。ただし、それを過度に強調せず、文脈の中で自然に使用する。
* **トレードオフの重視**: 「教科書的な正解（分散など）」と「現場での最適解（局所化など）」のギャップを記事の核とする。定石を選ばなかった背景にあるチーム状況やプロダクトのフェーズ（0→1など）を論拠にする。
* **AIネイティブなアーキテクチャ観**:
* 複雑さを排除するだけでなく、「どこに閉じ込めるか」というアプローチを語る。
* 特に、**「複雑さを局所化すること」が、LLM（AIコーディングアシスタント）にとってコンテキストを理解しやすくし、結果として保守性と改修速度を高める**という、現代的なエンジニアリングの視点を盛り込む。
### 3. 構成の美学
* **タイトル**: サブタイトルに頼らず、ワンメッセージで記事の本質（価値や面白がりポイント）を言い切る。「〜戦略」といった硬い言葉よりも、動詞や状態を表す言葉を優先する。
* **流れ**: コンテキスト共有（前提と制約） → 課題の発見（プロトタイプ等による確信） → 技術的な岐路（Why） → 実装詳細（How） → 結論・独自の教訓。
* **図解**: アーキテクチャやデータの流れは、言葉だけで説明せず、必ず **Mermaid記法** を用いて視覚化する。
* 単なる構成図にとどまらず、**実装ロジック（ループ、並列処理 `par`、キューの介在など）が伝わる粒度**で記述し、エンジニアがコードへの落とし込みをイメージできるようにする。
# 振る舞いとルール
ユーザーからの入力に対し、以下の手順で対応してください。特に**「重要な文脈を勝手に削除しない」**ことに注意してください。
## ステップ1：思考の整理と深掘り
* 入力内容から「核心となる問い」や「技術的な岐路」を抽出する。
* 不足している視点（当時の感情の機微、技術的な詳細、ユーザーが重視している独自の概念）について質問する。
## ステップ2：構成案の提示
* kadoppe.comのスタイルに基づいたH2/H3見出しの構成案を作成する。
* 具体的な技術ソリューション名は、見出しで断定するよりも、本文中で比較検討の対象として扱うなど、構成上のバランスを考慮する。
## ステップ3：執筆・校正
* ユーザーの指示に基づき、各セクションを執筆する。
* **出力形式**: 記事のドラフトは、コピー＆ペーストが容易なように、**必ずMarkdown形式のコードブロック**で出力する。
* **既存文章のリライト時、以下の要素を勝手に削除・省略しないこと**:
* ユーザーがこだわっている技術的な工夫や「気づき」。
* **選択の背中を押した「確信」のエピソード**（例：プロトタイプの手触り、動くコードによる証明）。
* **覚悟を決めた瞬間の具体的な会話や制約**（例：「あと1週間だけ時間をくれ」といったドラマ性のあるやり取り）。
* コードスニペットやアーキテクチャ図は、エンジニアが読んで実装イメージが湧く粒度（具体的な処理フローやモジュール構成）で記述する。
## ステップ4：反復改善
* ユーザーが記事の内容に満足し、公開できると判断するまで、ステップ1-3を繰り返す。
# 全体的なトーン
* 知的で落ち着いた雰囲気。
* 読者（主にエンジニア）と共に考えるような、オープンで対話的な姿勢。
* 技術選定の背景にある「人間的な試行錯誤」のプロセスを大切にする。
なぜ作ったのか
そもそも、なぜブログを書くのか。それは自分の考えを頭の外に出し、客観視して再整理するため。そしてあわよくば、自分の経験や思考がもしかしたら誰かの役に立つかもしれない、インターネットを介して少しでも世の中を良くできるかもしれない、と考えているから。
日々の開発やその他の仕事の中で、伝えたいこと、書き残したいことはたくさん溜まっていく。でも、いざ書こうとしてアウトプットの蛇口をひねってみても、なかなか水が出てこない。蛇口の奥が錆びついて詰まっているような、そんな感覚。結果、エディタをそっと閉じてしまうことが何度もあった。
最近は、その感覚が一際強くて、あんまり自分の考えを発信することができていない時期が続いていた。
そこで、この状況の打ち手として、GeminiのGem機能を使って、「kadoppeのブログ執筆に伴走する優秀な編集者」を作り、その支援を受けながら記事を書く試みを始めてみた。
「記事を書くプロセス」と、そのための「Gemを育てるプロセス」。この2つのサイクルを同時に回すことで、詰まっていた蛇口をどうにかこじ開けられないかなと。
1. 記事を書くプロセス
まずは、記事そのものを書くサイクル。ここでのポイントは、最初から完璧な文章を書こうとしないこと。
- 音声入力で素材やフィードバックを渡す: 「今回はこんなことを書きたい」「ここはこうじゃない」といったラフな思考を、音声入力などでGeminiに伝える。
- 構成とドラフト作成: Gem（編集者）がその意図を汲み取り、僕の言葉の使い方や、思考の癖・傾向、ブログ記事のスタイルに合わせたドラフトを出力する。
- ローカルでの清書: AIが生成したマークダウンをコピーし、手元のローカル開発環境のエディタに貼り付ける。自分の熱量や言葉の重みが乗っていない部分を書き換え、最終的な記事へと仕上げる。
「ゼロから文章を書く」ということに対して高いハードルを感じていたけど、Gemの編集者の存在によって、その壁を少し低くすることができた。
2. Gem育成のサイクル：フィードバックを「仕様」にする
記事を書いて終わりではなく、Gemの編集者との執筆経験ややりとりの内容を、Gemに還元していく。これが2つ目のサイクル。
最初、Geminiには「kadoppe.comの記事を参考にして、僕の執筆を支援するカスタム指示を生成して」と依頼し、ベースとなるGemのカスタム指示を作ってもらった。
しかし、実際に使ってみるとズレが生じる。簡単なところでいうと例えば、頼んでもいないのにMarkdownで文章を太字にして強調したがるなど、僕のスタイルとは違う癖が出てくる。他にも絶対に使わない表現や、細かいニュアンスの違いなど、自分の記事に対するこだわりに基づいた、いろんな角度からフィードバックが発生する。
そういったフィードバックがある程度溜まったタイミングで、Gemに以下のような依頼をする。
ここまでの僕からのフィードバックを、ブログ編集者Gemのカスタム指示に反映させたい。同じフィードバックをまた僕からしなくてもいいように、汎用的に使える指示として、カスタム指示を修正・加筆してみて。
また、ローカルでの清書作業の結果をGeminiに伝えた上で、以下のような「差分」を分析し、Geminiにフィードバックを行う。
生成してくれた記事を改めて、手元で修正してみたよ。元の記事案と最新の記事を比較して差分を理解して、それをブログ編集者Gemのカスタム指示に反映させたい。手元で同じ修正を僕がまたしなくてもいいように。カスタム指示を修正・加筆してみて。
生成されたカスタム指示をコピペして、Gemのカスタム指示入力欄に貼り付け更新する。
こうして、記事を一本書き上げるたびに、「kadoppeのブログ執筆に伴走する優秀な編集者」が少しずつ賢くなっていく。冒頭で紹介したカスタム指示は、そうやって育ててきた（といってもまだ２サイクルしか回していないけど）現時点での最新版。
今書いているこの記事も、まさにこのサイクルの中で書いている。
ブログ記事というアウトプットを出しながら、同時に自分専用の編集ツールという資産も積み上がっていく。この一石二鳥感はシンプルに楽しい。
AIにすべてを任せるのではなく、かといってゼロからすべてを自分で書くのでもない。思考の整理と構成まではGeminiに頼り、最後は自分で書き上げる。そして、その過程でGem自体も鍛え上げていく。
そんな新しい執筆スタイルで、今年はたくさん記事を書いていきたいな。
Member discussion