kioku

外観

kioku 取扱説明書（構成・仕組み・使い方） ​

kioku とは ​

会議の音声/テキスト/資料PDFを自動で「文字起こし→要約→整理」し、Claude Code から AI で引ける qmu 社内ツール。3人（益子・田村・笠松）で共有し、「どの会議で誰に何のタスク・進捗があったか」を対話で辿れる。読むだけでなく Claude Code からタスク完了・メモ追記もでき、その追記は会議記録とは別枠（誰が・いつ）で残る。ツール名 kioku＝記憶。

全体の流れ ​

  1. 投入: 会議の音声(m4a)・テキスト(txt)・資料PDFを、自分の個人フォルダ or 共有フォルダの 投入口（音声 m4a mp3 wav mp4 aac・資料 pdf・テキスト txt md vtt srt） に入れる。
    • 録音は 16kHz mono に変換してから（kioku_upload.py / ホットキー ⌃⌥⌘K が自動で変換＋投入）。生の m4a はデカすぎて Worker が扱えないため。
    • Typeless 等の文字起こしテキストは、そのまま .txt を置けば whisper をスキップして要約だけ（安い・速い）。
    • 資料PDF・画像（スライド/配布資料/図 pdf・png・jpg）はそのまま置くだけ。Claude が直接読んで要約する（whisper もテキスト化も不要）。資料だけなら種別は自動で「資料」。
    • 会議＋資料を1つの要約にまとめたい時は、投入口にサブフォルダ YYYYMMDD_種別/ を作り、その中に文字起こし＋資料（PDF/画像）を入れる（中身の名前は自由）。フォルダ＝1会議として、資料の図表・数値も込みで結合要約される。ファイルを直接置けば従来通りそれぞれ1会議。
  2. 処理（Worker）: qmu.dev の Cloudflare Worker が 3分ごとに 投入口（音声 m4a mp3 wav mp4 aac・資料 pdf・テキスト txt md vtt srt） を巡回し、
    • 音声なら Workers AI whisper で文字起こし（テキストはスキップ、PDF は Claude が直読み）
    • Claude（Sonnet）で要約＋種別分類
    • 会議の要約/<日付_種別>/summary/ に要約 md を保存
    • 元ファイルは 処理後の原本 へ退避
    • 要約を embedding して Vectorize（ベクトルDB）に登録（意味検索用）
  3. 読み取り（MCP）: 各自 Claude Code に kioku をリモート MCP として追加し（qmu.jp Google ログイン）、list_meetings / read_meeting / search_meetings（意味検索・語を変えなくても意味で当たる）/ related_meetings（内容が近い関連会議をたどる）で引く。回答には根拠の会議IDが添えられる。
  4. 書き込み（MCP）: complete_task（タスクを完了に）/ add_note（メモ・アイデアを追記）/ list_tasks（担当別に未完タスク一覧）。会議記録そのものは書き換えず、「誰が・いつ」付きの追記として別レイヤー（各会議の 追記_*.json、1件1ファイル）に積む。read_meeting では会議記録と「📝 追記（会議後）」が分けて表示される。
  5. 会議処理の通知（自動）: 共有フォルダの会議が処理されると、要約の概要＋タスク（期限があれば due 付き）を Slack に即通知。「新しい記録が入った」をすぐ把握できる（1on1 等の個人会議は流さない）。
  6. 週次ダイジェスト（自動・月曜9時）: 共有の直近7日の会議・未完タスク（持ち越し含む）・完了タスクを1枚にまとめ 共有/会議の要約/<日付>_週次ダイジェスト/ に自動生成（kioku で読める）＋ Slack に要点を通知。手動再生成は /digest?key=。

フォルダ構造（Google Drive: kioku 共有ドライブ） ​

kioku/
├─ 益子/ 田村/ 笠松/   … 各自の個人フォルダ（本人だけが読める）
│   ├─ 投入口（音声 m4a mp3 wav mp4 aac・資料 pdf・テキスト txt md vtt srt）/    投入する場所
│   ├─ 会議の要約/          会議(要約)が <日付_種別>/ で並ぶ
│   └─ 処理後の原本/        処理後の生ファイル置き場
└─ 共有/               … 3人で見えるフォルダ（同じ3階層）
  • 名前はそのまま用途を表す（投入口 → 処理 → 会議の要約に整理）。
  • 各会議フォルダ <日付_種別>/ の中身は summary/（要約md）・meta.json（タスク等）・transcript.txt（文字起こし全文。音声/テキスト由来のみ、PDFは無し）・追記_*.json（会議後の完了/メモ。1件1ファイル）。要約は不変、追記だけが後から積まれる。
  • 個人フォルダに入れると自分だけ、共有に入れると3人が kioku で読める。

使い方 ​

  • 記録: ⌃⌥⌘R で録音開始 → ⌃⌥⌘S で停止 → 保存・命名 → ⌃⌥⌘K で kioku へ送信（共有/個人を選ぶ）。
  • 命名: YYYYMMDD_種別（例 20260630_開発定例）。日付が無ければ処理日、種別が無ければ Claude が自動分類（開発定例/臨時/1on1/自社株説明/その他）。適当な名前でも大丈夫。
  • 引く: Claude Code で「kioku で最近の会議」「kioku で 認証まわりの決定」「誰がクローラー担当だっけ」など。意味で検索されるので、語を変えて何度も打つ必要はない。
  • 資料: スライド/配布PDFは投入口に .pdf を置くだけ。Claude が読んで要約し、他の会議と同じく検索・参照できる。
  • 完了・メモ: Claude Code で「kioku で 20260622_臨時 の〇〇タスクを完了に」「この会議に『△△を試す』とメモ追加」「kioku で益子の残タスク一覧」。会議記録は変わらず、（誰が・いつ）付きの追記として残る。
  • 接続（各自1回だけ）: プラグイン（/plugin install kioku@qmu-tools）を入れるか、claude mcp add --transport http kioku https://kioku-worker.a-71b.workers.dev/mcp → qmu.jp でログイン。

技術構成 ​

  • 処理・配信: Cloudflare Worker（qmu.dev、cron 3分）。1つの Worker で「処理」と「MCP配信」の2役。
  • 文字起こし: Workers AI @cf/openai/whisper-large-v3-turbo。
  • 要約・分類: Anthropic Claude claude-sonnet-5。
  • 意味検索: Workers AI @cf/baai/bge-m3 embeddings ＋ Cloudflare Vectorize。
  • 通知: Slack Incoming Webhook（共有会議の処理完了＝即時／週次ダイジェスト＝月曜9時JST を push）。
  • 認証: Google OAuth（qmu.jp 限定、workers-oauth-provider。Keycloak は使わない）。
  • データ: Google Drive（サービスアカウント経由）。Worker はデータを保持せず処理のみ。md がソース、ベクトルは検索インデックスの二層。
  • リソース: Worker / KV(OAUTH_KV) / Durable Object(KiokuMCP) / Vectorize(kioku-meetings) の4つ。全て無料枠。

コスト ​

1会議あたり ~¥15〜20（大半は Claude 要約。whisper・embedding・Vectorize は無料枠内でほぼ¥0）。月20会議で ¥300〜400 程度。読み取り（意味検索）はほぼ¥0。

ホットキー（益子環境、skhd） ​

  • ⌃⌥⌘R = 録音開始 / ⌃⌥⌘S = 録音停止 / ⌃⌥⌘K = kioku へ送信（最新録音を16k変換して投入口へ）。