EMP Tech BlogPublicationへの投稿
🚀

Gemini CLIとZenn CLIによる爆速記事生成‼️

take6
に公開
AI
Zenn
CLI
workflow
Gemini
tech

tl;dr

  • Gemini CLI (AI) に記事の構成案やドラフトを生成させることができる
  • Zenn CLI で記事プレビューしながら 人間 が編集・追記・ファクトチェックを行う

導入

Googleの強力な生成AI「Gemini」をコマンドラインで扱える Gemini CLI と、エンジニア向けプラットフォームZennの執筆ツール Zenn CLI。この2つのCLIツールを組み合わせることで、技術記事の作成プロセスを劇的に効率化できます。アイデアの創出から構成案の策定、本文やコードのドラフト作成までをAIに任せ、人間はより創造的な編集や品質向上に集中する。

本記事では、その具体的な手法や技術的な背景、実践的なコツまでを詳細に解説します。AIの力を借りて、執筆の初速と品質を両立させたいすべてのコンテンツクリエイターにとって、この記事が新たな武器となることを目指します。

  • ポイント:
    • Gemini CLIとZenn CLIを連携させた効率的な記事作成ワークフローを提案する。
    • AIによるドラフト生成と人間による編集・品質管理の分業に焦点を当てる。
    • 具体的な手順から応用例、実践的なTipsまでを網羅的に解説する。

読書対象者

  • 効率的に技術記事を執筆したいと考えているエンジニアやコンテンツクリエイター
  • AI（特にGemini）を自身のワークフローに組み込むことに関心がある方
  • Zennで毎週技術記事を執筆している方
  • CLIツールの操作に抵抗がない方

事前準備

背景・基礎知識

本フローの中核をなす2つのCLIツールについて解説します。

Gemini CLI

Googleが開発した大規模言語モデル（LLM）「Gemini」ファミリーを、ターミナル上から対話的に利用するためのツールです。単なるチャットボットに留まらず、ファイルの読み込み、コマンド実行の提案、コード生成など、開発者の生産性を向上させるための機能が豊富に搭載されています。ローカルのファイルやコンテキストを理解した上で応答を生成できるため、プロジェクトに特化した質問や作業依頼が可能です。

Zenn CLI

技術情報共有サービス「Zenn」の記事や本を、ローカル環境で作成・管理・プレビューするための公式CLIツールです。npx zenn new:article のような簡単なコマンドで記事の雛形を作成でき、npx zenn preview を実行すれば、ブラウザでリアルタイムに表示を確認しながらMarkdownで執筆を進められます。GitHubリポジトリと連携することで、git push するだけで記事が公開されるシームレスな体験を提供します。

  • ポイント:
    • Gemini CLIはローカルコンテキストを理解できる対話型AIツールである。
    • Zenn CLIはMarkdownでの執筆とリアルタイムプレビュー、GitHub連携による公開をサポートする。

本論：爆速記事作成フローの仕組み

ここで提案するワークフローは、AIと人間の協業を前提として設計されています。各ステップでの役割分担を明確にすることで、プロセス全体がスムーズに流れます。

[爆速記事作成フロー]

  1. アイデア創出 (AI + 人間): Gemini CLIにテーマを投げかけ、記事の切り口や構成案のブレインストーミングを行う。
  2. 記事ファイル生成 (人間): Zenn CLIを使い、記事のslug（URLになる部分）を指定してMarkdownファイルを生成する。
  3. コンテンツドラフト生成 (AI): Gemini CLIに構成案とコンテキスト（参考資料など）を与え、記事全体のドラフトをMarkdown形式で生成させる。
  4. 編集・追記 (人間): 生成されたドラフトをベースに、Zenn CLIのプレビュー機能で表示を確認しながら、自身の知見や表現を追加・修正する。ファクトチェックもこの段階で厳密に行う。
  5. 公開 (人間 + Zenn): 完成した記事をGitHubリポジトリにプッシュする。Zennが自動的にデプロイを行い、Web上に記事が公開される。
  • ポイント:
    • AIはアイデア出しとドラフト作成（発散・生成フェーズ）を担当する。
    • 人間は編集、ファクトチェック、品質向上（収束・洗練フェーズ）を担当する。
    • Zenn CLIとGitHub連携が、執筆から公開までのサイクルをシームレスに繋ぐ。

具体例・コード例

実際にフローを体験してみましょう。

Step 1: 記事ファイルの作成

まず、Zenn CLIで新しい記事ファイルを作成します。

# slug名を指定して新しい記事を作成
npx zenn new:article --slug gemini-zenn-flow-final

articles/gemini-zenn-flow-final.md というファイルが生成されます。

Step 2: Gemini CLIによるコンテンツ生成

次に、Gemini CLIに記事のドラフト作成を依頼します。ここでは、テンプレートファイルと参考記事をコンテキストとして与えるのがポイントです。

# @<ファイル名> でコンテキストを渡せる
gemini "この記事のテーマは「Gemini CLIとZenn CLIによる記事生成環境の構築」です。@templates/gemini-article-template.md の構成案と @original/gemini-zenn-flow-example.md @rules/zenn-writing-rules.mdの内容を参考にして、詳細な解説記事を生成してください。"

元ネタ（geminiで生成）

@original/gemini-zenn-flow-example.md

Gemini CLIとZenn CLIで爆速記事作成フロー

この記事では、GoogleのGemini CLIとZenn CLIを組み合わせて、Zennの記事作成を効率化するワークフローを紹介します。

登場人物

  • Gemini CLI : Googleの生成AIモデル「Gemini」をコマンドラインから対話的に利用できるツール。コード生成、文章作成、アイデア出しなど、さまざまなタスクを支援してくれます。
  • Zenn CLI : Zennのコンテンツ（記事、本）をローカル環境で作成・プレビューするための公式ツール。Markdownでの執筆をサポートし、GitHubと連携することでスムーズな公開が可能です。

なぜこの組み合わせなのか？

  • 執筆速度の向上: Gemini CLIが記事のドラフト、構成案、さらにはコードスニペットまで生成してくれるため、執筆の初速が格段に上がります。
  • 品質の担保: 生成された内容をベースに、自身の知見を加えて修正・追記することで、質の高い記事を効率的に作成できます。
  • シームレスなプレビュー: Zenn CLIの zenn preview コマンドを使えば、ローカルでリアルタイムに表示を確認しながら編集作業を進められます。

実践！記事作成フロー

  1. ネタ出し: Gemini CLIに「〇〇についての記事を書きたいんだけど、面白い切り口ある？」のように相談し、アイデアを膨らませます。

  2. 記事ファイルの作成: Zenn CLIで新しい記事ファイルを作成します。

    npx zenn new:article --slug new-awesome-article

  3. コンテンツ生成: Gemini CLIに具体的なお題を与えて、Markdownのコンテンツを生成させます。

    @gemini Zenn記事を書いて。テーマは「...」、構成は「...」で。

  4. ファイルへの書き込み: 生成されたコンテンツを、作成したMarkdownファイルに貼り付けます。

  5. プレビューと編集: zenn preview を実行し、ブラウザで表示を確認しながら、内容のファクトチェックや追記、修正を行います。

  6. 公開: 内容が完成したら、GitHubリポジトリにプッシュします。Zennが自動でデプロイし、記事が公開されます。

まとめ

Gemini CLIとZenn CLIの連携は、アイデアの着想から公開まで、コンテンツ制作のあらゆるフェーズを強力にサポートしてくれます。ぜひこの爆速ワークフローを試してみてください。

構成案

@templates/gemini-article-template.md

title: "〇〇の詳細解説"
emoji: "📚"
type: "tech"
topics: ["deepdive", "tech"]
published: false

tl;dr

  • （要約ポイント1）
  • （要約ポイント2）
  • （要約ポイント3）

導入

（テーマの概要や重要性、背景と動機を300文字以上で詳述）

  • ポイント:
    • （主要ポイントを箇条書きで整理）

##　事前準備

（この記事を読むにあたって必要な知識や環境などを記載）

  • 必要な知識:
    • （例：基本的なJavaScriptの知識）
  • 環境:
    • （例：Node.js v18以上）

背景・基礎知識

（必要な前提知識や歴史、用語定義などを記述。図解も活用）

  • ポイント:
    • （主要ポイントを箇条書きで整理）

本論

（技術的な詳細や仕組み、手順を解説。コードフローやアーキテクチャ図も言及）

  • ポイント:
    • （主要ポイントを箇条書きで整理）

具体例・コード例

（実行可能なフルコードを含め、手順も詳しく説明）

# コマンド例

// コード例
  • ポイント:
    • （主要ポイントを箇条書きで整理）

応用・発展

（より高度な使い方や関連分野への応用例を示す）

  • ポイント:
    • （主要ポイントを箇条書きで整理）

まとめ・今後の展望

（実装上の注意点や次のステップを提示）

  • ポイント:
    • （主要ポイントを箇条書きで整理）

Tips & Best Practices

  1. （Tips 1）: （詳細解説）
  2. （Tips 2）: （詳細解説）
  3. （Tips 3）: （詳細解説）
  4. （Tips 4）: （詳細解説）
  5. （Tips 5）: （詳細解説）

参考リンク

Zenn執筆ルール

@rules/zenn-writing-rules.md

Zenn 執筆ガイドライン

この記事は、Zennで質の高い記事を執筆するためのガイドラインです。

執筆の心構え

  • 読者ファースト: 常に読者の視点に立ち、何が最も価値ある情報かを考えます。
  • 正確性: 技術的な情報やデータは、信頼できる情報源に基づいて正確に記述します。
  • 独自性: 自身の経験や考察に基づいた、オリジナリティのある内容を目指します。

コンテンツ全般

  • 平易な言葉遣い: 専門用語を多用せず、初学者にも理解しやすい言葉で説明します。やむを得ず使用する場合は、注釈や簡単な解説を加えます。
  • 図や画像の活用: 複雑な概念や手順を説明する際は、図、スクリーンショット、フローチャートなどを積極的に活用し、視覚的な理解を助けます。
  • ソースコードの提示:
    • コードを引用する際は、言語を明記してシンタックスハイライトを有効にします。（例: ```python）
    • コードには、その役割や重要なポイントを説明するコメントや解説を添えます。

タイトル

  • 具体性: 記事の内容が一目でわかる、具体的で明確なタイトルをつけます。（例: 「〇〇で△△を実装する方法」）
  • 魅力: 読者の興味を引き、クリックしたくなるような魅力的なタイトルを心がけます。（例: 「もう〇〇で悩まない！△△をマスターする3つのステップ」）

タグ

  • 適切なタグ選定: 記事の内容に密接に関連するタグを3〜5個設定します。
  • タグの組み合わせ: 広い概念を示すタグ（例: JavaScript）と、より具体的な技術やテーマを示すタグ（例: React, Next.js）をバランス良く組み合わせます。

公開前のチェックリスト

  • 誤字脱字はないか（校正ツールなどの利用を推奨）
  • リンク切れはないか
  • 画像に代替テキスト（alt属性）は設定されているか
  • コードのインデントやフォーマットは正しいか
  • 全体を通して、読者が理解しやすい構成になっているか

生成された記事

gemini-zenn-flow-final.md

tl;dr

  • Gemini CLI (AI) に記事の構成案やドラフトを生成させる
  • Zenn CLI でプレビューしながら 人間 が編集・追記・ファクトチェックを行う
  • AIと人間の協業により、高品質な記事を高速で作成するワークフロー
  • AIの生成物は鵜呑みにせず、最終的な品質担保は人間の責任

導入

Googleの強力な生成AI「Gemini」をコマンドラインで扱える Gemini CLI と、エンジニア向けプラットフォームZennの執筆ツール Zenn CLI。この2つのCLIツールを組み合わせることで、技術記事の作成プロセスを劇的に効率化できます。アイデアの創出から構成案の策定、本文やコードのドラフト作成までをAIに任せ、人間はより創造的な編集や品質向上に集中する。本記事では、この次世代のワークフローを「爆速記事作成フロー」と名付け、その具体的な手法や技術的な背景、実践的なコツまでを詳細に解説します。AIの力を借りて、執筆の初速と品質を両立させたいすべてのコンテンツクリエイターにとって、この記事が新たな武器となることを目指します。

  • ポイント:
    • Gemini CLIとZenn CLIを連携させた効率的な記事作成ワークフローを提案する。
    • AIによるドラフト生成と人間による編集・品質管理の分業に焦点を当てる。
    • 具体的な手順から応用例、実践的なTipsまでを網羅的に解説する。

背景・基礎知識

本フローの中核をなす2つのCLIツールについて解説します。

Gemini CLI

Googleが開発した大規模言語モデル（LLM）「Gemini」ファミリーを、ターミナル上から対話的に利用するためのツールです。単なるチャットボットに留まらず、ファイルの読み込み、コマンド実行の提案、コード生成など、開発者の生産性を向上させるための機能が豊富に搭載されています。ローカルのファイルやコンテキストを理解した上で応答を生成できるため、プロジェクトに特化した質問や作業依頼が可能です。

Zenn CLI

技術情報共有サービス「Zenn」の記事や本を、ローカル環境で作成・管理・プレビューするための公式CLIツールです。npx zenn new:article のような簡単なコマンドで記事の雛形を作成でき、npx zenn preview を実行すれば、ブラウザでリアルタイムに表示を確認しながらMarkdownで執筆を進められます。GitHubリポジトリと連携することで、git push するだけで記事が公開されるシームレスな体験を提供します。

  • ポイント:
    • Gemini CLIはローカルコンテキストを理解できる対話型AIツールである。
    • Zenn CLIはMarkdownでの執筆とリアルタイムプレビュー、GitHub連携による公開をサポートする。

本論：爆速記事作成フローの仕組み

ここで提案するワークフローは、AIと人間の協業を前提として設計されています。各ステップでの役割分担を明確にすることで、プロセス全体がスムーズに流れます。

[爆速記事作成フロー]

  1. ① アイデア創出 (AI + 人間): Gemini CLIにテーマを投げかけ、記事の切り口や構成案のブレインストーミングを行う。
  2. ② 記事ファイル生成 (人間): Zenn CLIを使い、記事のslug（URLになる部分）を指定してMarkdownファイルを生成する。
  3. ③ コンテンツドラフト生成 (AI): Gemini CLIに構成案とコンテキスト（参考資料など）を与え、記事全体のドラフトをMarkdown形式で生成させる。
  4. ④ 編集・追記 (人間): 生成されたドラフトをベースに、Zenn CLIのプレビュー機能で表示を確認しながら、自身の知見や表現を追加・修正する。ファクトチェックもこの段階で厳密に行う。
  5. ⑤ 公開 (人間 + Zenn): 完成した記事をGitHubリポジトリにプッシュする。Zennが自動的にデプロイを行い、Web上に記事が公開される。
  • ポイント:
    • AIはアイデア出しとドラフト作成（発散・生成フェーズ）を担当する。
    • 人間は編集、ファクトチェック、品質向上（収束・洗練フェーズ）を担当する。
    • Zenn CLIとGitHub連携が、執筆から公開までのサイクルをシームレスに繋ぐ。

具体例・コード例

実際にフローを体験してみましょう。

Step 1: 記事ファイルの作成

まず、Zenn CLIで新しい記事ファイルを作成します。

# slug名を指定して新しい記事を作成
npx zenn new:article --slug gemini-zenn-workflow

articles/gemini-zenn-workflow.md というファイルが生成されます。

Step 2: Gemini CLIによるコンテンツ生成

次に、Gemini CLIに記事のドラフト作成を依頼します。ここでは、テンプレートファイルと参考記事をコンテキストとして与えるのがポイントです。

# @<ファイル名> でコンテキストを渡せる
gemini "この記事のテーマは「Gemini CLIとZenn CLIの連携」です。@templates/gemini-article-template.md の構成案と @original/gemini-zenn-flow-example.md の内容を参考にして、詳細な解説記事を生成してください。"

Step 3: プレビューと編集

生成された内容を articles/gemini-zenn-workflow.md にコピー＆ペーストし、Zenn CLIでプレビューを開始します。

# プレビューサーバーを起動
npx zenn preview

ブラウザで http://localhost:8000 を開き、表示を確認しながら内容をブラッシュアップしていきます。

  • ポイント:
    • Zenn CLIのコマンドは npx を付けることでローカルインストール不要で実行できる。
    • Gemini CLIでは @ プレフィックスでファイルをコンテキストとして参照させることができる。

応用・発展

この基本フローはさらに発展させることが可能です。

  • プロンプトのテンプレート化: Gemini CLIへの指示（プロンプト）自体をテンプレートファイルとして保存しておけば、毎回同じ品質のドラフトを安定して生成できます。

  • GitHub Actionsによる自動化: 特定のブランチにプッシュされたら、自動でGemini CLIを実行して記事のドラフトを生成し、プルリクエストを作成するようなCI/CDパイプラインを組むことも理論上可能です。

  • マルチモーダル入力の活用: Geminiはテキストだけでなく画像も理解できます。記事で使いたい図やスクリーンショットを先に用意し、それをコンテキストとして与えて解説文を生成させる、といった使い方も考えられます。

  • ポイント:

    • 定型作業はプロンプトのテンプレート化でさらに効率化できる。
    • CI/CDツールと連携することで、執筆フローの一部自動化も視野に入る。

まとめ・今後の展望

本記事では、Gemini CLIとZenn CLIを組み合わせた「爆速記事作成フロー」を解説しました。AIを単なる「文章作成ツール」ではなく「思考のパートナー」として活用することで、コンテンツ制作の生産性は飛躍的に向上します。

ただし、AIが生成したコンテンツには、事実誤認（ハルシネーション）や不自然な表現が含まれる可能性が常に伴います。最終的な品質担保の責任は執筆者自身にあることを忘れてはいけません。AIの力を最大限に引き出しつつ、人間ならではの創造性や批判的思考を融合させることが、これからのコンテンツ制作において重要なスキルとなるでしょう。

  • ポイント:
    • AIは思考のパートナーであり、最終的な品質責任は人間が負う。
    • AIの生成物を鵜呑みにせず、必ずファクトチェックと編集を行う必要がある。

Tips & Best Practices

  1. 明確な役割分担を意識する: Geminiはアイデア出しと7割程度のドラフト作成、人間は残りの3割の仕上げと品質管理、と割り切るとスムーズです。
  2. プロンプトは具体的に: 「〇〇についての記事を書いて」より「〇〇について、こういう読者層を対象に、この構成案で、こういう視点を含めて書いて」と具体的に指示する方が、質の高い出力が得られます。
  3. コンテキストが鍵: 記事のテンプレートや関連資料、参考URLなどを @ やプロンプトに含めることで、AIの理解度が深まり、より文脈に沿った内容を生成してくれます。
  4. プレビューを頻繁に確認する: Zenn CLIのプレビューは非常に高速です。少し編集しては保存し、表示を確認するサイクルを回すことで、手戻りを最小限に抑えられます。
  5. AIの生成物は「素材」と心得る: 生成された文章やコードは、あくまで料理における「素材」です。そのまま出すのではなく、自分の言葉やスタイルで「調理」する一手間が、記事の質を大きく左右します。

参考リンク

Step 3: プレビューと編集

生成された記事をZenn CLIでプレビューを開始します。

# プレビューサーバーを起動
npx zenn preview

ブラウザで http://localhost:8000 を開き、表示を確認しながら内容をブラッシュアップしていきます。

  • ポイント:
    • Zenn CLIのコマンドは npx を付けることでローカルインストール不要で実行できる。
    • Gemini CLIでは @ プレフィックスでファイルをコンテキストとして参照させることができる。

応用・発展

この基本フローはさらに発展させることが可能です。

  • プロンプトのテンプレート化: Gemini CLIへの指示（プロンプト）自体をテンプレートファイルとして保存しておけば、毎回同じ品質のドラフトを安定して生成できます。

  • GitHub Actionsによる自動化: 特定のブランチにプッシュされたら、自動でGemini CLIを実行して記事のドラフトを生成し、プルリクエストを作成するようなCI/CDパイプラインを組むことも理論上可能です。

  • マルチモーダル入力の活用: Geminiはテキストだけでなく画像も理解できます。記事で使いたい図やスクリーンショットを先に用意し、それをコンテキストとして与えて解説文を生成させる、といった使い方も考えられます。

  • ポイント:

    • 定型作業はプロンプトのテンプレート化でさらに効率化できる。
    • CI/CDツールと連携することで、執筆フローの一部自動化も視野に入る。

まとめ・今後の展望

本記事では、Gemini CLIとZenn CLIを組み合わせた「爆速記事作成フロー」を解説しました。AIを単なる「文章作成ツール」ではなく「思考のパートナー」として活用することで、コンテンツ制作の生産性は飛躍的に向上します。

ただし、AIが生成したコンテンツには、事実誤認（ハルシネーション）や不自然な表現が含まれる可能性が常に伴います。最終的な品質担保の責任は執筆者自身にあることを忘れてはいけません。AIの力を最大限に引き出しつつ、人間ならではの創造性や批判的思考を融合させることが、これからのコンテンツ制作において重要なスキルとなるでしょう。

  • ポイント:
    • AIは思考のパートナーであり、最終的な品質責任は人間が負う。
    • AIの生成物を鵜呑みにせず、必ずファクトチェックと編集を行う必要がある。

Tips & Best Practices

  1. 明確な役割分担を意識する: Geminiはアイデア出しと7割程度のドラフト作成、人間は残りの3割の仕上げと品質管理、と割り切るとスムーズです。
  2. プロンプトは具体的に: 「〇〇についての記事を書いて」より「〇〇について、こういう読者層を対象に、この構成案で、こういう視点を含めて書いて」と具体的に指示する方が、質の高い出力が得られます。
  3. コンテキストが鍵: 記事のテンプレートや関連資料、参考URLなどを @ やプロンプトに含めることで、AIの理解度が深まり、より文脈に沿った内容を生成してくれます。
  4. プレビューを頻繁に確認する: Zenn CLIのプレビューは非常に高速です。少し編集しては保存し、表示を確認するサイクルを回すことで、手戻りを最小限に抑えられます。
  5. AIの生成物は「素材」と心得る: 生成された文章やコードは、あくまで料理における「素材」です。そのまま出すのではなく、自分の言葉やスタイルで「調理」する一手間が、記事の質を大きく左右します。

参考リンク

EMP Tech Blog
EMP Tech BlogPublication

インフラをメインに、IoTやAI、自動化などの最先端分野のプロジェクトに取り組む少数精鋭エンジニア集団、株式会社EmpireのTech Blogです！

Discussion