🔍 検索
投稿する

CEO Mail Autopilot — Gmail自動分類・返信ドラフト生成AI秘書

経営者のGmailを24時間監視し、重要度に応じた自動分類や返信ドラフトの作成を行うAI秘書エージェントです。Claude APIを活用して新着メールを4段階にランク付けし、3行要約とアクション提案、さらにユーザーのこれまでの文体を学習した返信案を自動生成します。 Vercel Cronによる定期実行で自律的に稼働し、ユーザーはAIが整理した「見るべきリスト」を確認して採用・却下のフィードバックを送るだけでメール処理を完結できます。 日々のメール対応に追われる一人社長やスタートアップCEOの工数を大幅に削減し、重要な商談や顧客連絡の見落としを防ぐための強力な自動運転パイプラインを提供します。
zip未取得

CEO Mail Autopilot

経営者のGmailを24時間自動運転するAIメール秘書

Gmail を定期監視し、新着メールを重要度・緊急度に応じて A/B/C/D で自動分類。3行要約・推奨アクション・返信ドラフトを生成し、ユーザーのフィードバックで継続的に精度を改善します。

---

プロジェクト概要

経営者・1人社長は日々大量のメールに追われます。重要な顧客メール・契約関連・商談日程調整・パートナー連絡が、営業メール・メルマガ・自動通知と混在し、本当に見るべきメールが埋もれます。

CEO Mail Autopilot は、AI秘書が重要メールだけを届け、返信案まで作ります。経営者はAIが整理した「見るべきメールリスト」を確認し、採用/却下のフィードバックを与えるだけです。

HOOTL（Human Out of the Loop）型の設計

本プロジェクトは「.AI自動運転部」の評価軸である HOOTL 型システムとして構築します。AIが自律的に動き続け、人間の介入なしに処理・改善を続けます。ユーザーは主体的に操作するのではなく、AIの判断に対してフィードバックを与える役割に留まります。

---

MVPスコープ（3週間）

必須機能

#機能説明
1Gmail連携OAuth2認証、メール取得
2A/B/C/D 自動分類重要度・緊急度による4段階分類
33行要約メール本文の要点を3行で要約
4推奨アクション生成返信・転送・対応期限などの提案
5返信ドラフト生成CEOの文体に合わせた返信文案
6DB保存処理結果・ログの永続化
7定期実行5〜15分ごとの自動ポーリング
8処理ログ・失敗ログ稼働証跡と障害追跡
9再処理キュー失敗メールの自動リトライ
10分類修正ユーザーによる分類の上書き
11ドラフト採用/却下/編集ログ返信ドラフトへのフィードバック収集
12自律改善ログ重要送信者リスト・分類ルール・文体の改善履歴

今回やらないこと

  • Outlook / 他メールサービス対応
  • Slack本文の解析
  • カレンダー連携
  • 添付ファイルの高度解析（OCR・要約など）
  • 自動返信送信（人間の確認なしの送信は行わない）
  • SNS運用
  • PPT自動生成

Stretch Goal

  • AランクメールのSlack通知
  • 添付ファイル名・有無を分類スコアに反映
  • Outlook対応の設計ドキュメント記載

---

評価軸への対応（.AI自動運転部）

1. 稼働性

評価項目対応内容
24時間稼働Vercel Cron / GitHub Actions による定期実行
障害からの自己復旧再処理キュー（Dead Letter Queue）と指数バックオフリトライ
処理・失敗ログSupabase に処理レコード・エラーレコードを保存

2. 進化性

評価項目対応内容
データ蓄積全処理メールをDB保存し、分析可能な状態を維持
フィードバック学習分類修正・ドラフト採用/却下/編集を全てログ化
自律改善フィードバック集計に基づき、分類プロンプト・重要送信者リスト・文体サンプルを自動更新

3. 事業性

評価項目対応内容
解いた課題の大きさ経営者のメール確認・返信作成時間の大幅削減
定量効果メール確認時間 -70%、重要メール見落とし率の低減
拡張性Outlook / Slack / カレンダー連携への拡張設計

---

3週間ロードマップ

Week 1: 基盤構築
  Day 1-2:  プロジェクト計画・要件定義・アーキテクチャ設計
  Day 3-4:  Next.js + Supabase セットアップ、Gmail OAuth2 認証実装
  Day 5-6:  メール取得パイプライン + Claude API による分類・要約・ドラフト生成
  Day 7:    処理ログ・失敗ログ・再処理キューの実装

Week 2: UI + フィードバックループ
  Day 8-9:  ダッシュボード UI（メール一覧・分類表示・ドラフト表示）
  Day 10-11: 分類修正・ドラフト採用/却下/編集 UI の実装
  Day 12-13: フィードバックログのDB保存・集計ロジック
  Day 14:   定期実行の本番設定（Vercel Cron）

Week 3: 自律改善 + 品質強化
  Day 15-16: 重要送信者リスト・分類ルールの自動更新ロジック
  Day 17-18: 返信文体の学習・プロンプト自動チューニング
  Day 19-20: 結合テスト・本番稼働確認・ログ検証
  Day 21:   Stretch Goal（Slack通知）+ ピッチ資料作成

---

技術スタック

レイヤー技術
フロントエンドNext.js 14 (App Router), TypeScript, Tailwind CSS
バックエンドNext.js API Routes / Server Actions
AIClaude API (claude-sonnet-4-6)
メールGmail API (Google OAuth2)
DBSupabase (PostgreSQL)
定期実行Vercel Cron Jobs
通知 (Stretch)Slack Incoming Webhooks
ホスティングVercel

---

セキュリティ方針

  • **.env.local、credentials.json、token.json、*.pem、secrets.* は絶対にGitにコミットしない**
  • .gitignore でこれらのファイルパターンを必ず除外する
  • Gmail APIのアクセストークン・リフレッシュトークンはDBに暗号化して保存する
  • ユーザーのメール内容は AI処理後にマスクして保存し、本文原文の長期保存は行わない

---

セットアップ

1. インストール

git clone <repository-url>
cd ceo-mail-autopilot
npm install

2. 環境変数の設定

cp .env.local.example .env.local

.env.local に以下の値を設定してください：

変数名取得先
NEXT_PUBLIC_SUPABASE_URLSupabase ダッシュボード > Settings > API
NEXT_PUBLIC_SUPABASE_ANON_KEY同上
SUPABASE_SERVICE_ROLE_KEY同上
GOOGLE_CLIENT_IDGoogle Cloud Console > APIs & Services > Credentials
GOOGLE_CLIENT_SECRET同上
GOOGLE_REDIRECT_URIhttp://localhost:3001/api/auth/google/callback
ANTHROPIC_API_KEYhttps://console.anthropic.com
CRON_SECRETopenssl rand -hex 32 で生成

3. Supabase DBのセットアップ

# supabase/migrations/ 内のSQLファイルをSupabaseのSQL Editorで順番に実行
# または Supabase CLI を使用
npx supabase db push

4. Gmail OAuth認証

npm run dev

http://localhost:3001/debug/gmail を開き、"Gmailに接続" ボタンで認証を完了してください。

5. 動作確認

# AIパイプラインのテスト（サンプルメール）
open http://localhost:3000/debug/ai-pipeline

# Gmailとの接続テスト
open http://localhost:3001/debug/gmail

# ダッシュボード
open http://localhost:3000/dashboard

---

現在の実装状況

機能状態
ダッシュボードUI（分類・要約・ドラフト表示）完成
AIパイプライン（分類・要約・ドラフト生成）完成
Gmail APIクライアント・パーサー完成
Gmail OAuth2認証フロー完成
経営戦略インサイト画面完成
Supabase DBスキーマ完成（migrations済み）
Vercel Cron設定完成（vercel.json）
フィードバックループUI実装済み（API接続待ち）
自律改善ロジック実装済み

---

ディレクトリ構成

ceo-mail-autopilot/
├── README.md
├── CLAUDE.md
├── vercel.json              # Vercel Cron設定
├── .env.local               # Git除外（機密情報）
├── .env.local.example       # 環境変数テンプレート
├── docs/                    # 設計ドキュメント
├── supabase/migrations/     # DBスキーマ定義
├── data/rules/              # 分類ルール（自律改善で自動更新）
└── src/
    ├── app/
    │   ├── dashboard/       # メイン一覧画面
    │   ├── mails/[id]/      # メール詳細
    │   ├── strategy/        # 経営戦略インサイト
    │   ├── debug/           # 開発用デバッグ画面
    │   └── api/auth/google/ # Gmail OAuth2
    ├── lib/
    │   ├── ai/              # Claude API連携（分類・要約・ドラフト）
    │   ├── gmail/           # Gmail APIクライアント
    │   └── strategy/        # 経営戦略インサイト生成
    └── components/          # UIコンポーネント