Imported from blazex60/my-discord-bot (chat-summary-bot/AGENTS.md). Install upstream with npx skills add blazex60/my-discord-bot --skill chat-summary-bot. Copyright stays with the author.

chat-summary-bot

Purpose

カオスな雑談Discordサーバーのテキストチャンネルを対象に、会話を探しやすくし、 離席中の話題に短時間で追いつけるようにするBot。VC（音声チャンネル）は非対応。

discord-minutes-botとは完全に独立した設計。コードの共用なし。

Key Files

Subdirectories

Architecture

システム全体

[Discord テキストチャンネル（全チャンネル＋除外リスト設定）]
       ↓ on_message（リアルタイム受信）
[bot.py]
  ├─ messages テーブルへ保存（SQLite + TTL）
  └─ コマンド受信時
       ↓
[collector.py]  ── DB / Discord channel.history() からメッセージ取得
       ↓
[llm_client.py]  ── HTTP POST → llama-cpp-python サーバー
       ↓
[Gemma4 26B（Dockerサービス）]
  ※ チャンク分割なし。全テキストをそのままコンテキストへ
       ↓
[bot.py]  ── Discord へ返信

Docker Compose 構成（2サービス）

docker-compose.yml
├── bot      ← Python Discord Bot
│   └── depends_on: llm (healthcheck 待機)
└── llm      ← llama-cpp-python HTTP サーバー (Gemma4 26B)
    └── volumes: ./models:/models

SQLite スキーマ

-- メッセージキャッシュ（TTL付き）
CREATE TABLE messages (
  id          TEXT PRIMARY KEY,   -- Discord message ID
  channel_id  TEXT NOT NULL,
  author_name TEXT NOT NULL,
  content     TEXT NOT NULL,
  created_at  INTEGER NOT NULL,   -- Unix timestamp
  expires_at  INTEGER NOT NULL    -- TTL: Unix timestamp
);

-- Bot設定（除外チャンネル・自動投稿スケジュール等）
CREATE TABLE config (
  key   TEXT PRIMARY KEY,
  value TEXT NOT NULL
);

Discord コマンド一覧

出力形式

For AI Agents

Working In This Directory

• パッケージ管理は uv（uv sync / uv add）
• フォーマット: ruff format .、リント: ruff check .
• 環境変数は .env で管理。config.yaml にシークレットを書かない
• LLM呼び出しは常に llm_client.py 経由。直接インポート禁止
• チャンク分割は行わない。全テキストをそのまま LLM に渡す
• discord-minutes-bot のコードは参照・流用しない

Testing Requirements

• テストランナー: pytest
• LLM呼び出し (llm_client.py) はモックでテスト
• DB操作はインメモリSQLiteでテスト
• docker compose up 一発で全サービスが起動することを確認する

Common Patterns

• メッセージ保存は db.py に集約する（bot.py 内に SQL を書かない）
• collector.py はDB優先、DBになければ Discord API にフォールバックする
• TTL切れメッセージの削除は Bot 起動時と定期バッチの両方で行う
• LLMサーバーの起動待機は Docker の depends_on: condition: service_healthy に任せる

Dependencies

External

LLM サービス

共通環境

禁止事項

• 外部 AI API の使用（OpenAI API、Anthropic API 等）
• テキストのチャンク分割（コンテキストを失う処理）
• DISCORD_TOKEN を config.yaml またはソースコードにハードコードすること
• VC（音声チャンネル）のサポート追加
• discord-minutes-bot のコードをコピー・インポートすること