挨拶
ども!6/25にGemini CLIがリリースされて、7月に入ってから気づいて出遅れてしまった龍ちゃんです。Xでだいぶ話題になっていますね。noteの「プログラミング1ミリも分からない人がGemini CLI始めるまでの全手順(Win篇)」を見て、Gemini CLIがリリースを知りました。まぁ私はエンジニアなので、エンジニア目線で使い方を模索していこうと思っています。Gemini CLIだと、いろいろとカスタマイズができそうってことで、入門していきます。
弊社では、Geminiをワークスペースで契約をしているので普段から使えています。(生成AIサービスも福利厚生という時代になりましたね…)
今回は「DevContianerでGemini CLIを使うことができる環境をセットアップし、システムプロンプトを設定してURLからXの投稿文を生成」を目標として環境構築からセットアップまで行っていきます。
それでは始めましょう。
1. はじめに – なぜDevContainer × Gemini CLIなのか
皆さんは、AI開発環境の「汚染問題」に悩まされていませんか?
今回DevContainer×Gemini CLIの環境を構築した背景は、チーム開発での環境差異を根本的に解決したいからです。個人利用なら全く問題ないのですが、チーム開発となると話は別ですよね。
グローバルインストールでホスト側に設定ファイルをゴリゴリ書き込んでいると、「なんで俺のGeminiとお前のGeminiは違うんや!」という環境差異が必ず発生します。開発者は自由に自分の環境を作ってしまう自由人ですからね。新卒や別担当者が参画した際に「あれ?このコマンド入ってない」で一日潰れる光景、想像に難くないでしょう。
そこで注目したいのが、2025年6月にGoogle公式リリースされたGemini CLIです。無料枠が1日1000回と太っ腹で、実用性は十分。DevContainerと組み合わせることで、安全で再現可能な開発環境が実現できます。
実践的な検証として、普段Claude Projectで使用しているプロンプトを使って「雑プロンプト」「Claude Project」「Gemini CLI」の3パターンで品質比較も行います。
今回の記事で学べること:
- DevContainerでGemini CLIを安全に動かす設定方法
- GEMINI.mdによるプロジェクト固有カスタマイズ
- システムプロンプトの効果的な設定テクニック
- 実践:URLからテック系ブログのX投稿文を生成してdocs配下に自動保存
それでは、チーム開発を前提とした「Geminiの回答品質担保」環境を一緒に構築していきましょう!
2. Gemini CLIとDevContainerの基礎知識(800文字)
2.1 Gemini CLIとは
Gemini CLIは、2025年6月にGoogleが公式リリースしたオープンソースAIエージェントです。Apache 2.0ライセンスで提供されており、企業利用も安心ですね。
主要機能として以下が挙げられます:
- ファイル操作: プロジェクトファイルの読み書き・編集
- コマンド実行: シェルコマンドの実行とレスポンス取得
- Web検索: リアルタイム情報収集
- MCP対応: Model Context Protocolによる拡張性
特に注目したいのがサンドボックス機能です。これは、AI実行環境を隔離することで、予期しないシステム変更を防ぐGemini CLI独自の安全機能となります。
2.2 DevContainerとは
DevContainerは、VS Code DevContainersの略称で、コンテナベースの開発環境を提供する技術です。従来の「俺の環境では動くんだけどなあ」問題を根本的に解決してくれます。
AI開発における特有のメリットとして、環境破壊防止が挙げられます。AIエージェントが予期しないパッケージインストールやシステム変更を行っても、ホスト環境は完全に保護されるわけです。
コンテナ化により、チームメンバー全員が同一の実行環境を共有できるため、「なんで俺の環境だと動かないんだ」という状況を回避できます。これは、特に新卒研修や外部パートナーとの協業において威力を発揮しますね。
2.3 組み合わせの利点
DevContainer × Gemini CLIの組み合わせには、4つの主要メリットがあります。
安全性: Gemini CLIのサンドボックス機能とDevContainerの隔離環境により、二重の安全保障が実現されます。AIが暴走してもホスト環境への影響は皆無です。
再現性: 環境設定が.devcontainer/devcontainer.json
としてコード化されるため、誰でも同じ環境を瞬時に再現できます。チーム間での環境差異によるトラブルが根絶されますね。
拡張性: MCP対応により、プロジェクト固有の機能追加が容易です。継続的な改善と標準化が可能で、組織全体での知見蓄積に貢献します。
コスト効率: Google Workspace統合により、既存の企業インフラとシームレスに連携できます。新たなライセンス購入や複雑な導入プロセスが不要で、企業導入のハードルが格段に下がります。
実際のプロジェクトでどちらを選ぶべきか、迷うところですが、チーム開発を前提とするなら、この組み合わせが現時点での個人的ベストプラクティスと言えるでしょう。
3. 環境準備と前提条件
3.1 必要なツール
今回の検証はGoogle Workspace環境で行っています。@google.comではなく@<自社ドメイン>.comアカウントでの検証ですが、認証方法が若干異なるだけなので、あまり気にしなくて大丈夫です。
Docker環境については、今回WSL2にDocker Engineを直接インストールして検証しています。ただし、個人利用の方はMicrosoft公式が推奨しているDocker Desktopの構築をお勧めします。
企業でお使いの方、特に新人・若手の皆さんへ: Docker Desktopには商用利用時のライセンス制約があります。必ず上長または情報システム部門(最低でも同僚)に確認を取ってください。ライセンス問題は最悪の場合、訴訟に発展するリスクがあるため、慎重に対応しましょう。
3.2 Google Workspace環境の設定
Google Workspace環境では、Gemini for Google Cloud APIが有効化されたプロジェクトが必要になります。このAPIが有効になっていない場合、Gemini CLIの認証段階でエラーが発生します。
Google Cloud Consoleでプロジェクトを作成し、以下の手順でAPIを有効化してください:
- Google Cloud Console → APIとサービス → ライブラリ
- “Gemini API”で検索
- Gemini for Google Cloud APIを選択して「有効にする」
3.3 DevContainer環境の準備
DevContainerを使用するため、以下のツールが必要です:
- VS Code: 最新版を推奨
- DevContainers拡張機能: Microsoft公式の拡張機能
- Docker環境: Docker DesktopまたはDocker Engine
VS Codeの拡張機能タブで「DevContainers」を検索してインストールしてください。この拡張機能により、コンテナ内での開発が可能になります。
3.4 事前確認チェックリスト
作業を始める前に、以下の項目を確認してください:
- Docker環境の動作確認:
docker --version
でバージョンが表示される - VS Code + DevContainers拡張機能: 正常にインストール済み
- Google Workspace アカウント: 組織アカウントでのログインが可能
- Google Cloud プロジェクト: Gemini APIが有効化済み
- ネットワーク環境: Google APIsへのアクセスが可能(企業ファイアウォール確認)
これらの準備が整ったら、実際の環境構築に進むことができます。次のセクションでは、DevContainerの設定ファイル作成から始めていきましょう!
4. DevContainer設定
4.1 プロジェクト構造の作成
それでは、今回作成するプロジェクトのディレクトリ構成から見ていきます。
.
├── .devcontainer
│ └── devcontainer.json # DevContainer設定の心臓部
├── docs # 作業結果を保存するディレクトリ
├── .gemini # Gemini CLI設定ディレクトリ
│ └── settings.json # API Key等の設定
├── GEMINI.md # システムプロンプト設定ファイル
├── .gitignore
└── README.md
ここがポイント! 特に注目していただきたいのが**GEMINI.md
**です。このファイルがシステムプロンプトを保存する重要な役割を担います。作業ディレクトリ内に配置することで、Gemini CLIが自動的に検出してシステムプロンプトを読み込んでくれる仕組みになっています。
docs
ディレクトリは、Gemini CLIが生成した成果物を整理して保存するためのディレクトリです。チーム開発では、生成された結果を適切に管理することで、ナレッジの蓄積と共有が可能になります。これは、私の検証環境でも非常に重宝している構成ですね。
4.2 devcontainer.jsonの詳細設定
続いて、DevContainerの設定で最も重要なdevcontainer.json
の内容を詳しく見ていきます。WSL環境での動作を想定した設定になっています。設定項目は公式リファレンスにまとまっています。
{
"name": "Gemini CLI Development (DinD)",
"image": "mcr.microsoft.com/devcontainers/javascript-node:1-20-bullseye",
"features": {},
"postCreateCommand": "npm install -g npm@11.4.2 @google/gemini-cli ",
"workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
"remoteUser": "node",
"customizations": {
"vscode": {
"extensions": [
"ms-vscode-remote.remote-containers",
"ms-vscode-remote.remote-wsl"
],
"settings": {
"terminal.integrated.defaultProfile.linux": "bash"
}
}
}
}
4.3 設定項目の詳細解説
ベースイメージの選択理由
Microsoft公式のjavascript-node
イメージを採用した理由は、DevContainer環境に最適化されており、セットアップが簡単だからです。このイメージではUID:1000
がnode
ユーザーとして事前設定されており、権限管理がスムーズに行えます。
他のDevContainerイメージではvscode
ユーザーが使われることが多いですが、Node.js環境ではnode
ユーザーが標準的です。これは、npmのグローバルインストール時の権限問題を回避するためでもあります。
拡張機能について
DevContainer環境では、リモート開発に必要な拡張機能を事前にインストールしておくと作業効率が向上します。特にremote-containers
とremote-wsl
は、環境切り替えやデバッグ作業で重宝します。
皆さんも、普段使っている拡張機能がある場合は、ここに追加しておくと良いでしょう。
postCreateCommand
こちらでGemini CLIのインストールを行っています。インストール方法に関しては公式リファレンスの情報を参考に行っています。
4.4 環境起動と動作確認
この設定により、チーム全体で一貫したGemini CLI開発環境を構築できます。実際にこの環境を起動して動作確認を行っていきます!
起動手順
- Windows環境の場合:
F1
を押してコマンドパレットを開く - 「DevContainers: Reopen in Container」を選択
- コンテナのビルドが開始されます
4.5 Sandbox環境を使わない設計判断
Gemini CLIにはSandboxという便利機能が目玉の一つとしてあります。こちらは、ファイルに直接変更を加える前にDocker内のSandboxでプレビューとして変更をシミュレートしてくれる便利機能です。
今回は生成をメインに扱うので、そもそもファイル新規作成が目的なため、軽量化とDevContainerの複雑な設定を回避するために使わないと判断しました。
シンプル構成を選択した背景:
- 新規生成がメイン: 既存ファイル変更ではなく新規作成が目的
- 環境構築の簡素化: DonDやDinDの複雑な設定を回避
- 軽量化: 不要な機能を削ることでセットアップを高速化
必要な場合はDooDかDinD(DevContainer内でDockerを使用する)で組み込んで使用できますが、そこまで本格的に使うなら、WSLにNode.jsを直接インストールする方が簡単かもしれませんね。そこはプロジェクトの要件に応じて判断していただければと思います。
5. Gemini CLI基本セットアップ
まず初めにGemini CLIのトラブルシューティングのリンクを載せておきます。
5.1 認証設定
それでは、ターミナルを開いて以下のコマンドを実行してください。
# Google Cloud プロジェクトIDの設定(必須)
export GOOGLE_CLOUD_PROJECT=your-project-id
# Gemini CLI初回実行
gemini
おそらくですが、以下のような画面が出てきて設定が始まります。

選択すると次は認証方式の設定ですね。

初回実行の場合は、認証方式を聞かれます。
- Login with Google
- Gemini API Key (AI Studio)
- Vertex AI
多くの方は「Login with Google」を選択して、よく見慣れたGoogle認証画面でログインするでしょう。
設定項目をつらつらと答えていけば、認証設定は完了です。
5.2 基本設定ファイル(settings.json)
{
"sandbox": false,
"theme": "GitHub",
"model": "gemini-2.0-flash-exp",
"contextFileName": [
"GEMINI.md"
]
}
次に設定ファイルです。プロジェクトルートに.gemini
ディレクトリを作成してsettings.json
ファイルを作成してください。
今回はsandbox
を使わないためfalseに設定しています。もしここをtrueにすると、Dockerコマンドが使えないとのことでエラーが発生します。theme
に関しては初回に答えた内容ですね。Gemini CLIのコード部分の装飾に関わります。model
はデフォルトで選択するモデルですね。最後にcontextFileName
はシステムプロンプトとして認識するファイル名になります。この配列に追加していくと好きなファイルをシステムプロンプトとしてぶち込むことが可能になります。
設定の反映には一度Gemini CLIを抜けて再度入りなおす必要があります。自動反映はしてくれないですね。
動作的にまだ安定していない部分もありますが、その辺はこれからってところですね。
💡 モデル設定のトラブルシューティング
モデル設定が無視される場合(GitHub Issue #2205):
export GEMINI_MODEL="gemini-2.0-flash-exp" gemini --model gemini-2.0-flash-exp
5.3 動作確認
設定が完了したら、適当に質問してみてください。
# 基本的な動作確認
現在のプロジェクト構造を教えてください
# ファイル操作の確認
docs/test.md に今日の日付と動作確認結果を記録してください
普段のGeminiとあんまり使用感は変わらないですね。ローディングがGUIと違ってプログラミングチックで見慣れた光景だなって感じです。
正常に動作していれば、質問に対する回答が返ってきて、docs
ディレクトリにファイルが作成されるはずです。これで基本的なセットアップは完了です!
6. GEMINI.mdによるプロジェクト固有設定
6.1 GEMINI.mdの役割と重要性
待望のシステムプロンプトを設定していきましょう!これは先ほどのCLI設定ファイルで指定したファイル名「GEMINI.md」をプロジェクトルートに作成すればOKです。
このファイルの面白いところは、階層構造に応じた柔軟なプロンプト管理が可能な点です。プロジェクトルートに作成すればプロジェクト全体のシステムプロンプトとして機能し、特定のディレクトリ(例:docs階層)に配置すれば、そのディレクトリ内での作業時のみ有効なシステムプロンプトになります。
これは、実際のコーディング作業で威力を発揮します。ディレクトリごとに異なるシステムプロンプトを作成することで、命名規則やコーディング規約をルールとして定義でき、プロジェクトが変わっても同一品質を担保できるわけです。ただし、作成と管理は相当大変そうですが…このディレクトリ単位でのプロンプト分割機能はGemini CLIの魅力的な機能ですね。
6.2 実用的なGEMINI.md設定例
では、実践的なプロンプトを設定していきます。普段は300行のプロンプトを使用しているのですが、ファイルサイズも大きいので軽量版を用意しました。以下をプロジェクトルートに作成したGEMINI.md
に挿入してください。
# 軽量版 エンジニア向けX投稿自動生成システム
## 🎯 概要
URLのみの入力で、記事品質評価からA/Bテスト用投稿文まで自動生成する包括的システム。
## 🔄 自動実行プロセス
### Phase 1: 記事分析・品質評価
- web_fetchで記事の完全コンテンツ取得・構造解析
- 技術的正確性評価(技術スタック正確性、実装レベル、対象読者レベル)
- 評価結果:A(高品質)/ B(標準)/ C(要注意)
- 記事価値・差別化ポイント抽出
### Phase 2: ハッシュタグ効果分析
- 2-3回のweb_searchで技術分野別調査・6個以内で選定
### Phase 3: A/Bテスト版投稿文作成(2種類)
**タイプA: 効果重視・数値訴求型**
- 具体的な数値効果・Before/After型アピール
**タイプB: 課題共感・解決提案型**
- エンジニアの「あるある」課題→解決策への流れ
### Phase 4: 最適化・検証
- 280バイト制限内最大化・品質評価連動調整
## 📊 最終出力フォーマット
### 1. 記事品質評価レポート
📋 記事品質評価結果
【総合評価】A / B / C
【技術的正確性】⭐⭐⭐⭐⭐ (5点満点)
【実装レベル】プロトタイプ / 基本実装 / 本格実装 / 企業レベル
【対象読者】初級者 / 中級者 / 上級者 / 専門家
【実用性】⭐⭐⭐⭐⭐ (5点満点)
【主要な技術要素】・【注意事項・制限】
### 2. A/Bテスト投稿文(2種類)
各タイプごとに以下を含む:
- 280バイト以内の最適化投稿文
- バイト数詳細(本文・絵文字・URL・ハッシュタグ・合計)
- 特徴・ターゲット
### 3. 投稿タイミング戦略
- 最優先推奨・代替オプション
### 4. 最適化効果サマリー
- 技術用語最適化効果・A/Bテスト推奨順位
## 🔧 実行トリガー
URLのみ入力時に自動実行
6.3 システムプロンプトの動作確認
正しくGemini CLIに認識されているか確認しましょう。Gemini CLIを起動した状態で以下のコマンドを入力して表示されれば成功です。
# 現在認識しているシステムプロンプトを表示
/memory show
# システムプロンプトを更新したので再読み込み
/memory refresh
6.4 実際の動作テスト
この状態で以下のプロンプトを入力すれば、自動実行されてdocsディレクトリに結果が出力されるはずです。
https://tech-lab.sios.jp/archives/48061 > @docs/に出力したコンテンツを保存して
一定時間経過後にdocsディレクトリにファイルが作成されていると思います。私の検証環境では以下のような結果が出力されました:
出力例:
URLを分析し、指定されたフォーマットでX(旧Twitter)への投稿案を作成しました。
### 1. 記事品質評価レポート
📋 **記事品質評価結果**
【総合評価】A
【技術的正確性】⭐⭐⭐⭐⭐
【実装レベル】本格実装
【対象読者】中級者
【実用性】⭐⭐⭐⭐⭐
【主要な技術要素】
・Azure Static Web Apps
・Bicep (Infrastructure as Code)
・Azure CLI
・SWA CLI
・Bash Scripting
【注意事項・制限】
・提示されているスクリプトはローカル開発用です。
・デプロイトークンなどの機密情報はGitで管理しないよう注意が必要です。
### 2. A/Bテスト投稿文(2種類)
---
**【タイプA:効果重視・数値訴求型】**
**テキスト案**
Azure SWAの構築、手作業で時間かかっていませんか?🤔
Bicepを使った自動化で、作業時間を70%も短縮!🚀
この記事のスクリプトをコピペするだけで、ローカル開発環境のデプロイが数分で完了します。
`https://tech-lab.sios.jp/archives/48061`
#Azure #Bicep #IaC #DevOps #自動化
**バイト数詳細**
・本文: 1[1]57
・絵文字: 8
・URL: 23
・ハッシュタグ: 41
・合計: 229 バイト
**特徴・ターゲット**
「70%削減」という具体的な数値を提示し、即時的な効果を求めるエンジニアにアピールします[1]。多忙な開発者や、すぐに導入できる解決策を探している層がターゲットです。
---
**【タイプB:課題共感・解決提案型】**
**テキスト案**
「またこの手作業か…」Azure SWAのデプロイ、面倒に感じていませんか?
Bicepと自動化スクリプトで、その悩みを解決!✨
リソース作成からデプロイまでを完全自動化する具体的な手法を解説。もう手動管理には戻れません。
`https://tech-lab.sios.jp/archives/48061`
#Azure #Bicep #StaticWebApps #IaC
**バイト数詳細**
・本文: 151
・絵文字: 4
・URL: 23
・ハッシュタグ: 36
・合計: 214 バイト
**特徴・ターゲット**
開発者が共感しやすい「手作業の煩わしさ」という課題から入り、記事がその解決策であることを提示します。手動でのインフラ管理に課題を感じている、より丁寧な解説を求めるエンジニア層に響きやすい投稿です。
---
### 3. 投稿タイミング戦略
* **最優先推奨:** 平日の業務時間中(10:00〜18:00)。技術情報に関心のあるエンジニアがアクティブな時間帯です。特に昼休み(12:00-13:00)や、業務が一段落する夕方(17:00-18:00)が効果的です。
* **代替オプション:** 平日の夜(21:00〜23:00)。自己学習や情報収集を行うエンジニアにリーチできる可能性があります。
### 4. 最適化効果サマリー
* **技術用語最適化:** 記事の核心技術である「Bicep」「Azure Static Web Apps」「IaC」をハッシュタグに含めることで、これ らの技術に関心を持つターゲット層へのリーチを最大化しました。
* **A/Bテスト推奨順位:**
1. **タイプA**を先に試すことを推奨します。「70%削減」という強いインパクトを持つ数値は、クリック率を高める可能性が最も高いです。
2. 次に、より丁寧な課題解決アプローチである**タイプB**を投稿し、エンゲージメントの違いを比較します。
Sources:
[1] 作業時間を70%短縮!BicepによるAzure Static Web Apps自動構築 | (https://tech-lab.sios.jp/archives/48061)
この結果が正常に出力されれば、システムプロンプトの設定は完了です!
7. 実践的な運用とチーム活用
7.1 チーム開発での管理手法
今回のシステムは生成に主軸を置いているため、作成した成果物をGitHub上で体系的に管理できるという大きな利点があります。従来は、Geminiで出力したものをSlackに都度コピー&ペーストで移行していましたが、この方法では過去の生成結果の検索や再利用が困難でした。
Git管理による品質保証プロセスでは、プロンプトの品質はプロンプト自体に依存するため、PRベースでの変更管理が理想的です。生成されたドキュメントをベースに運用を行い、定期的な改修判断を行うプロセスが重要になります。
GitHubの利点であるバージョン管理機能により、プロンプトの変遷を追跡できるのは非常に価値があります。ソースコードと同様に、プロンプトも技術資産として体系的に管理すべき時代になってきました。LLMのバージョンアップによって相性の良し悪しが変わる世界では、PRでの管理ができることは大変重要ですね。
7.2 GEMINI.mdの実用的活用パターン
6章で解説したディレクトリ単位でのGEMINI.md配置機能は、業務フローの最適化において強力な武器となります。作業内容ごとにプロンプトをカスタマイズできることで、業務効率の大幅な向上が期待できます。
具体的な活用例:
プロジェクト構成での使い分け
project-root/
├── GEMINI.md # プロジェクト全体の基本プロンプト
├── docs/
│ └── GEMINI.md # ドキュメント生成専用プロンプト
├── src/
│ └── GEMINI.md # コード生成・レビュー専用プロンプト
└── tests/
└── GEMINI.md # テストコード生成専用プロンプト
7.3 A/Bテスト戦略の実装
今回の検証では、プロンプト内部でA/Bテストを実装しましたが、長期的な効果測定であればディレクトリ単位での分離がより効果的です。
ディレクトリベースA/Bテスト例:
social-media-posts/
├── strategy-a/
│ ├── GEMINI.md # 数値重視アプローチ
│ └── generated/ # 生成結果保存
└── strategy-b/
├── GEMINI.md # 課題共感アプローチ
└── generated/ # 生成結果保存
この構成により、期間を区切った戦略比較やチーム内での並行テストが可能になります。
7.4 プロンプトの継続的改善
プロンプトエンジニアリングは試行錯誤の連続です。一度の修正で完璧になることは稀なので、定期的にレビューを重ねてプロンプトを一歩ずつ改善していく必要があります。(というか一度で完璧なプロンプトって絶対作れないですよね…)
生成結果の品質に課題を感じた際は、どの部分が期待と異なるのかを具体的に特定し、プロンプトの該当箇所を少しずつ調整していくアプローチが必要です。
7.5 組織展開での考慮事項
チーム全体でDevContainer × Gemini CLI環境を導入する際は、以下の点に注意が必要です:
技術的制約事項
- Docker環境の組織統一
- Google Workspace認証の権限設定
- ファイアウォール設定の調整
運用ルールの策定
- プロンプト変更権限の明確化
- 生成コンテンツの品質基準定義
- セキュリティガイドラインの整備
特にコーディングに活用するのであれば、今回はそぎ落としたsandboxに関しては必須レベルです。コードはすでに元のものがある前提なので、sandboxなしの場合であればgitコマンドで戻すしか選択肢がなくなってしまいます。
この環境が組織に定着すれば、AI活用による生産性向上と品質の標準化が同時に実現できるでしょう。皆さんも、ぜひプロジェクトの要件に応じてカスタマイズしてみてください!
まとめ
今回は、DevContainer × Gemini CLIを組み合わせた安全で再現可能な開発環境の構築方法について詳しく解説してきました。
この環境構築で実現できたことは以下の通りです:
チーム開発の課題解決: 「なんで俺のGeminiとお前のGeminiは違うんや!」という環境差異問題を根本的に解決し、誰でも同じ環境を瞬時に再現できるようになりました。DevContainerによるコンテナ化で、新卒や別担当者が参画してもスムーズに開発に参加できる環境が整います。
安全性の確保: Gemini CLIのサンドボックス機能とDevContainerの隔離環境による二重の安全保障で、AIが暴走してもホスト環境への影響は皆無です。企業レベルでの導入も安心して行えます。
プロジェクト固有のカスタマイズ: GEMINI.mdによるディレクトリ単位でのシステムプロンプト管理により、作業内容に応じた最適化が可能になりました。コーディング、ドキュメント生成、テスト作成など、用途別にプロンプトを使い分けることで業務効率が大幅に向上します。
Git管理によるプロンプト資産化: プロンプトもソースコードと同様にバージョン管理できるため、PRベースでの品質管理と継続的改善が実現できます。LLMのバージョンアップに対応した管理も可能になりますね。
この環境が組織に定着すれば、AI活用による生産性向上と品質の標準化が同時に実現できるでしょう。特に、従来Slackにコピー&ペーストしていた生成結果を体系的に管理できるようになったのは大きな進歩です。
皆さんも、ぜひプロジェクトの要件に応じてカスタマイズしてみてください!定期的にレビューを重ねてプロンプトを一歩ずつ改善していくことで、さらに高度な自動化システムへと発展させていけるはずです。
付録:強化版プロンプト
# 強化版 エンジニア向けX投稿自動生成システム
## 🎯 概要
URLのみの入力で、記事品質評価からA/Bテスト用投稿文まで自動生成する包括的システム。技術的正確性の評価と異なるアプローチでの複数投稿文を同時作成。
---
## 🔄 自動実行プロセス(強化版)
### **Phase 1: 記事分析・品質評価**
#### **Step 1-1: 記事内容完全取得**
```
実行内容:
- web_fetchでブログ記事の完全コンテンツ取得
- 記事構造の解析(見出し、コードブロック、図表等)
- 文字数・技術密度の測定
```
#### **Step 1-2: 技術的正確性評価**
```
評価項目:
【技術スタック正確性】
- 使用技術の最新性(2024-2025年基準)
- 技術的実装の適切性
- セキュリティ・ベストプラクティスの考慮
【実装レベル判定】
- プロトタイプ / 基本実装 / 本格実装 / 企業レベル
- コードの完成度・品質
- エラーハンドリング・例外処理の有無
【対象読者レベル】
- 初級者(学習中・1-2年目)
- 中級者(実務経験3-5年)
- 上級者(リーダー・アーキテクト級)
- 専門家(特定分野のエキスパート)
評価結果:A(高品質)/ B(標準)/ C(要注意)
```
#### **Step 1-3: 記事価値・差別化ポイント抽出**
```
分析内容:
- 解決する具体的課題
- 既存解決策との違い・優位性
- 実用性・再現性の程度
- 学習コスト・導入難易度
- ビジネス価値・ROI
```
### **Phase 2: ハッシュタグ効果分析**
#### **Step 2-1: 技術分野別ハッシュタグ調査**
```
検索戦略(2-4回のweb_search実行):
検索1: "[主要技術名] ハッシュタグ 効果的 X Twitter 2025"
例:"NestJS ハッシュタグ 効果的 X Twitter 2025"
検索2: "[技術領域] エンジニア ハッシュタグ トレンド 2025"
例:"Web開発 エンジニア ハッシュタグ トレンド 2025"
検索3: "[解決課題] 自動化 効率化 ハッシュタグ X"
例:"Slack Bot 自動化 効率化 ハッシュタグ X"
検索4: "[関連ツール] [技術スタック] ハッシュタグ 人気"
例:"Google Docs API NotebookLM ハッシュタグ 人気"
```
#### **Step 2-2: ハッシュタグ効果性評価・選定**
```
評価基準:
- トレンド性(2024-2025年の話題性)
- 技術特化度(エンジニアの検索意図との一致)
- 関連性(記事内容との直接的関連度)
- バイト効率(半角英語活用による節約効果)
選定ルール:
- 6個以内
- 合計30-40バイト以内
- 半角英語優先(#Azure, #API, #OSS等)
```
### **Phase 3: A/Bテスト版投稿文作成(3種類)**
#### **投稿文タイプ A: 効果重視・数値訴求型**
```
【特徴】
- 具体的な数値効果を最前面に配置
- Before/After型の劇的改善アピール
- 実用性・効率化を強調
【構成テンプレート】
🚀 [劇的効果の数値]で[技術課題]を解決!
📝 [具体的解決手法]で[時間短縮・効率化]を実現
⚡ 技術スタック: [半角英語技術名]
🔧 [実装詳細・注意点]
詳細→ [URL]
#ハッシュタグ
【表現例】
- "30分→3分に短縮!"
- "90%の作業削減を実現"
- "チーム全体で月40時間節約"
```
#### **投稿文タイプ B: 課題共感・解決提案型**
```
【特徴】
- エンジニアの「あるある」課題から開始
- 共感を呼ぶ問題提起
- 解決策への自然な流れ
【構成テンプレート】
😰 [多くのエンジニアが抱える課題]で困ってませんか?
💡 [技術手法]を使えば[解決方法]で楽になります
⚡ [具体的技術スタック]で実装
🎯 [期待効果・メリット]
解決方法→ [URL]
#ハッシュタグ
【表現例】
- "まだ手動でSlack通知作ってるの?"
- "Google Docsの更新確認、毎回開いてチェックしてる?"
- "同じようなレポート作成に毎週2時間かけてませんか?"
```
#### **投稿文タイプ C: 技術トレンド・学習促進型**
```
【特徴】
- 最新技術動向・トレンドに言及
- スキルアップ・学習意欲を刺激
- 将来性・キャリア価値をアピール
【構成テンプレート】
🔥 2025年注目の[技術分野]トレンド
📚 [技術手法・ツール]の実装方法を解説
⭐ [学習メリット・キャリア価値]
🚀 [実際の活用場面・ビジネス価値]
詳細ガイド→ [URL]
#ハッシュタグ
【表現例】
- "2025年のAI活用はここまで進化"
- "NotebookLMとSlack連携がゲームチェンジャー"
- "この技術知ってるかで来年の評価が変わる"
```
### **Phase 4: 最適化・検証**
#### **Step 4-1: バイト数計算・最適化**
```
各投稿文について:
- 全角・半角混在でのバイト数正確計算
- 280バイト制限内での情報量最大化
- 技術用語の半角化による節約効果測定
- URL(23バイト)・絵文字・ハッシュタグ含めた総計算
```
#### **Step 4-2: 品質評価連動調整**
```
記事品質評価結果に基づく調整:
【A評価(高品質)記事】
- より技術的権威性を強調
- 上級者向けの詳細情報を含める
- 業界標準・ベストプラクティスをアピール
【B評価(標準)記事】
- 実用性・学習効果を前面に
- 初中級者向けの親しみやすい表現
- 「試してみる価値あり」感を演出
【C評価(要注意)記事】
- 学習・実験的価値をアピール
- 制限事項・注意点を適切に含める
- 過度な効果アピールを避ける
```
---
## 📊 最終出力フォーマット
### **1. 記事品質評価レポート**
```
📋 記事品質評価結果
【総合評価】A / B / C
【技術的正確性】⭐⭐⭐⭐⭐ (5点満点)
【実装レベル】プロトタイプ / 基本実装 / 本格実装 / 企業レベル
【対象読者】初級者 / 中級者 / 上級者 / 専門家
【実用性】⭐⭐⭐⭐⭐ (5点満点)
【主要な技術要素】
- [抽出された技術スタック]
- [解決する課題]
- [提供価値・効果]
【注意事項・制限】
- [記事内で言及されている制限事項]
- [実装時の注意点]
```
### **2. A/Bテスト投稿文(3種類)**
#### **🚀 タイプA: 効果重視型**
```
[280バイト以内の最適化投稿文A]
📊 バイト数詳細:
- 本文: [X]バイト
- 絵文字: [X]バイト
- URL: 23バイト
- ハッシュタグ: [X]バイト
- 合計: [X]/280バイト
💡 特徴: 数値効果重視、劇的改善アピール
🎯 ターゲット: 効率化重視のエンジニア
```
#### **💡 タイプB: 課題共感型**
```
[280バイト以内の最適化投稿文B]
📊 バイト数詳細:
- 本文: [X]バイト
- 絵文字: [X]バイト
- URL: 23バイト
- ハッシュタグ: [X]バイト
- 合計: [X]/280バイト
💡 特徴: 共感重視、問題解決提案
🎯 ターゲット: 課題を抱えるエンジニア
```
#### **📚 タイプC: 学習促進型**
```
[280バイト以内の最適化投稿文C]
📊 バイト数詳細:
- 本文: [X]バイト
- 絵文字: [X]バイト
- URL: 23バイト
- ハッシュタグ: [X]バイト
- 合計: [X]/280バイト
💡 特徴: トレンド重視、スキルアップ促進
🎯 ターゲット: 学習意欲の高いエンジニア
```
### **3. 投稿タイミング戦略**
#### **🥇 最優先推奨(記事品質・内容連動)**
```
推奨投稿タイプ: [A/B/C]
推奨日時: [具体的日時]
理由: [記事品質・対象読者・技術分野に基づく根拠]
期待効果: [エンゲージメント予測]
```
#### **🥈 代替オプション**
```
代替投稿タイプ: [A/B/C]
代替日時: [具体的日時]
理由: [異なるアプローチでの訴求理由]
期待効果: [別ターゲット層への効果]
```
#### **🥉 実験的選択肢**
```
実験投稿タイプ: [A/B/C]
実験日時: [具体的日時]
理由: [新しいパターンのテスト目的]
期待効果: [データ収集・学習効果]
```
### **4. 最適化効果サマリー**
```
💡 技術用語最適化効果:
- 半角英語化: [具体例] → [X]バイト節約
- 半角数値化: [具体例] → [X]バイト節約
- 半角記号化: [具体例] → [X]バイト節約
- 総節約効果: [X]バイト
🎯 A/Bテスト推奨順位:
1位: タイプ[A/B/C] - [選定理由]
2位: タイプ[A/B/C] - [選定理由]
3位: タイプ[A/B/C] - [選定理由]
📈 期待エンゲージメント予測:
- タイプA: [予測値・根拠]
- タイプB: [予測値・根拠]
- タイプC: [予測値・根拠]
```
---
## 🔧 実行トリガー
### **自動実行条件**
```
以下の場合に自動的にこの強化版プロセスを実行:
1. URLのみが入力された場合
2. "記事品質評価付きで"等の指示がある場合
3. "A/Bテスト版で"等の指示がある場合
4. "完全版で"等の包括的分析要求がある場合
```
### **プロンプト例**
```
【基本実行】
https://tech-blog.example.com/article-url
【明示的実行】
以下の記事で記事品質評価とA/Bテスト版投稿文を作成してください:
https://tech-blog.example.com/article-url
【カスタム実行】
記事品質評価A評価想定、上級者向けでA/Bテスト版作成:
https://tech-blog.example.com/article-url
```
---
## 📋 品質保証チェックリスト(強化版)
### **記事品質評価の正確性**
- [ ] 技術的事実の正確性検証
- [ ] 実装レベルの適切な判定
- [ ] 対象読者レベルの妥当性確認
- [ ] 制限事項・注意点の適切な反映
### **A/Bテスト版の差別化**
- [ ] 3つのアプローチが明確に異なる
- [ ] 各タイプのターゲット読者が明確
- [ ] バイト数最適化が各版で実現
- [ ] 品質評価結果が適切に反映
### **全体的最適化**
- [ ] ハッシュタグ効果分析の妥当性
- [ ] 投稿タイミング戦略の論理性
- [ ] バイト数計算の正確性
- [ ] エンゲージメント予測の根拠明確性
---
この強化版システムにより、URLひとつで記事の技術的品質から複数の投稿戦略まで包括的に分析・生成できます!