--- name: meeting-copilot description: | A two-machine live meeting copilot. A Windows laptop streams two audio channels (your mic, and a loopback of the other side's voice) to a parent machine, which transcribes them, drives a teleprompter you read from, watches every incoming utterance against a ledger of pre-agreed facts, and answers off-script questions. Ships the parent daemons, the Windows capture agent, and worked config examples. Consumes raw transcripts only — never a meeting-AI summary. 会議に同席してリアルタイムで進行ナビ・前提監視・台本外質問への回答を行う2台構成のモニタ。子機(Windowsノート)が2系統の音声を親機へ送り、親機が文字起こし・カード生成・画面配信を行う。親機の常駐一式・子機の取り込み一式・設定の実例つき。入力は逐語のみで、議事録AIの要約は使わない。 --- # meeting-copilot **会議に同席して、進行と前提を見張るモニタ一式** > **English abstract** — Two machines. The **child** (a Windows laptop, in the meeting) captures two physical audio channels — `T` = your microphone, `G` = a WASAPI loopback of the default speaker — and streams both to the **parent** over TCP with a shared token. The parent transcribes each channel separately (speaker identity comes from the *channel*, never from diarization), then runs three layers over the transcript: a rule-only warden (`copilot.py`) that advances the agenda and fires boundary alarms with no LLM at all; a premise watcher (`premise_watch.py`) that classifies every guest utterance against a ledger of pre-agreed facts as contradiction / already-known / new; and an answerer (`answerer.py`) for off-script questions. A teleprompter (`viewer2.py`) serves two different pages — a **prompt screen** only you see on your phone, and a **stage window** you actually screen-share. Everything case-specific lives in config files; the code carries no customer data. Written mainly in Japanese; the structure is language-independent. --- ## 0. 全体像 — これは2台構成である 一番よくある取り違えが「1台で完結する道具だと思う」こと。**必ず2台要る。** ``` ┌─ 子機 (Windows ノートPC・会議に持っていく機体) ────────────┐ │ │ │ マイク ────────────► agent_mic.py ──┐ ch "T" │ │ │ │ │ 既定スピーカーの │ │ │ ループバック ─────► agent_loop.py ──┤ ch "G" │ │ │ │ │ 音を録って送るだけ。STTもAPIキーも持たない │ └──────────────────────────────────────────┼──────────────────┘ │ TCP + 合言葉(token) │ 16kHz mono ×2本 プライベート網(tailscale等)を想定 │ ┌─ 親機 (Linux / WSL・自宅や事務所に置きっぱなし) ───────────┼───┐ │ ▼ │ │ receiver.py … 音を受けて STT へ流し transcript.jsonl へ追記 │ │ │ │ │ ├──► copilot.py … ルールだけで段の進行・境界警報 │ │ │ ├──► premise_watch.py … 相手の発話×事実台帳 │ │ │ └──► answerer.py … 台本外の質問に回答 │ │ │ │ │ └──► viewer2.py … カンペ画面 + 舞台画面を配信 │ └─────────────────────────────────────────────────────────────────┘ │ │ │ カンペ画面(自分だけ見る) │ 舞台画面(相手に画面共有する) ▼ ▼ スマホ / 携帯ディスプレイ 名前付き別窓 meetlive_stage ``` ### 🔴 イヤホン／イヤモニが必須な理由は、この構成に直結している 話者の分け方が**物理チャンネル**だからである(`receiver.py` の `CH_SPEAKER = {"T": "host", "G": "guest"}`)。 STT の話者分離(diarization)には一切頼っていない。安いし速いし確実——**ただし1つだけ前提がある**。 > 子機のスピーカーで相手の声を鳴らすと、ch `G`(相手の声)として送っている音を > ch `T`(自分のマイク)が拾い直し、**同じ声が2チャンネルに二重計上される**。 > こうなると相手の発話が `speaker="host"` として記録される。 そして `host` / `guest` の区別は、この道具の土台になっている: | 何が壊れるか | どこで効いているか | |---|---| | 段の進行が勝手に進む | 段の検知キーワードは **host の発話だけ**に当てる (`copilot.auto_step`) | | 前提監視が黙る/誤爆する | 前提監視を撃つのは **guest の発話のとき**だけ (`copilot.feed`) | | 呼びかけが効かない/暴発する | 呼びかけ語の検知は **host の発話だけ** (`receiver.Writer.emit`) | | 台本外の質問への回答が暴走する | answerer を呼ぶのは **guest の質問**のときだけ | つまり**イヤホンを忘れると、モニタの機能がほぼ全部おかしくなる**。 `receiver.py --xtalk-gate` は「T の音量より G の音量が1.5倍大きければ T を捨てる」という **保険**だが、解決ではない。イヤホンを挿すこと。 --- ## 1. 4つの層 — 何がどこまでやるか | 層 | ファイル | LLM | いつ動くか | |---|---|---|---| | 逐語化 | `receiver.py` + `stt.py` | 使わない | 音が来るたび | | 番人(第1層) | `copilot.py` | **使わない** | 逐語1行ごと。ルールと文字列照合だけ | | 前提監視 | `premise_watch.py` | 量産呼び出し | **相手の発話ごとに毎回** | | 回答(第2層) | `answerer.py` | 一発呼び出し | 台本外の質問のときだけ(30秒に1回まで) | | 返し役 | `responder.py` | 一発呼び出し | 相手の発話がひと区切りするたび | | 表示 | `viewer2.py` | 使わない | 長ポーリングで配信 | | 判定層 | `decision_engine.py` | 差し替え式 | 発話1本ごと(§1.8。判定器→小型LLM→ルールの順に退避。本線の外で1本だけ走る) | | 事後検証 | `action_log.py` | 使わない | 会議のあと | | 採点 | `replay_eval.py` | 使わない | 会議のあと(過去の逐語を流し直す) | **なぜ第1層に LLM を置かないか**: 会議中は「速い・落ちない・同じ入力に同じ出力」が 何より効く。段の進行と約束の境界(金額・期限・責任)の検知は、キーワード照合で足りる。 LLM を挟むと、その分だけ遅れ、その分だけ落ちる。 **`answerer.py` と `responder.py` の違いは構え**。answerer は「答えを作る」、responder は **「台本のどこを読み上げればよいかを指す」**。だから responder の出力は毎回 ①該当する節 ②そのまま言える返し ③言ってよい数字 ④🚫言ってはいけないこと1つ、の4点に固定してあり、 材料(`kb/`)は**全文**を渡す(切り詰めが何を起こすかは §5.8)。台本があって「その通り話したい」 会議は responder、台本が薄く「その場で答える」会議は answerer。**同時には使わない**。 --- ## 1.5 会議フォルダ — 案件固有はここにしか無い **コードは1本。案件ごとに変わるのは「会議フォルダ」の中身だけ**、という形にしてある。 会議のたびにフォルダを1つ作り、`MEETLIVE_MEETING` でそれを指す。それ以外の環境変数は、 古い運用のための後方互換として残してあるだけで、ふだんは触らない。 ``` <会議フォルダ>/ 例: ~/meetings/2026-01-20-acme/ (git に載せない場所) meeting.json 今日の構え(下の表)。この1枚が入口 agenda_steps.json 段と必須取得物 talk_script.md 台本(テレプロンプターの中身) phrasebook.json 定型回答・約束の境界の文言 stage_resources.json 舞台に出せるもの(URL・画像・声で呼ぶ語) ledger.yaml 事実台帳(前提監視の基準・任意) bank.json 先読み回答(任意) kb/ 台本外の回答の材料。🔴 置いたものはそのままLLMへ送られる docs/ 資料棚。会議中に画面のボタンで開く手元資料(.md/.txt/.html) ``` ```bash export MEETLIVE_MEETING=~/meetings/2026-01-20-acme export MEETLIVE_DIR=~/meetlive_state/2026-01-20-acme # 省略時は ./meetlive_state/<フォルダ名> export MEETLIVE_CREDS_FILE=~/secrets/acme_logins.md # 🔴 会議フォルダの外 python3 scripts/viewer2.py --port 47328 ``` ### 解決の順番（キー単位・迷ったらこの順） 1. **会議フォルダの中のファイル** … あればこれが勝つ 2. **個別の環境変数**（`MEETLIVE_AGENDA` 等）… 会議フォルダに無いときだけ 3. **同梱の `config/*.example`** … どちらも無いとき。必須の入力は stderr に警告を出す 前の案件の `MEETLIVE_AGENDA` がシェルに残っていても、会議フォルダが勝つので事故らない。 逆に、**環境変数が指すファイルが存在しないときは例へ落ちずに止まる**(黙って別の案件の 台帳を読んでいた、が起きないように)。会議フォルダ自体が無いときも同じく止まる。 ### `meeting.json` の各キー | キー | 既定 | 意味 | |---|---|---| | `title` | (空) | 会議の名前(ログ・画面用) | | `start` | (空) | 開始予定 `"HH:MM"`。`--start` を渡さないときの既定(その日の時刻) | | `total_min` | `0` | 会議の長さ(分)。0 なら `agenda_steps.json` の「会議分」 | | `host_label` | `進行役` | こちら側の呼び方(プロンプト内) | | `counterpart` | `相手` | 相手の呼び方(プロンプト内) | | `share` | `host` | 画面共有の構え `host` / `guest` / `none` | | `layout` | `auto` | 画面の並べ方 `columns`(左右2列) / `rows`(上下) / `auto`(向きで切替) | | `script_mode` | `with_lines` | カンペの粒度。`answers_only` にすると**言い方の例を隠し**、「取る答え」と「抜けたら出す問い」だけ出す | | `end` | (空) | 終わりの予定 `"HH:MM"`。終話検知の材料(§3.2.5) | | `auto_stop.enabled` | `true` | 終話を検知したら全層を自分で畳む | | `auto_stop.silence_min` | `10` | 双方の無音がこれだけ続いたら終話(分) | | `auto_stop.farewell_grace_min` | `5` | 別れの言葉のあと、この時間の無音で終話(分) | | `auto_stop.end_grace_min` | `10` | `end` からこれだけ過ぎ、**かつ無音**なら終話(分) | | `features` | 全部 `true` | 起動する層の ON/OFF (`copilot` / `responder` / `premise_watch` / `stage`) | | `stage.set_label` | (空) | 今回の舞台セットの呼び名 | | `stage.order` | (空=全部) | 出す舞台ボタンだけを順に並べる | | `card_policy.auto_dismiss_kinds` | `["warn","premise_warn"]` | **自動で消える種別**。ここに無いカードは「済」を押すまで残る | | `card_policy.ttl_sec` / `max_turns` / `min_show_sec` | `120` / `8` / `40` | 自動で消える種別の引っ込み方 | | `card_policy.stack_max` / `history_max` | `60` / `30` | カード列と履歴の上限 | | `call_words` | `コパイロット,…` | 呼びかけ語。🔴 STT の誤変換の綴りも並べる | | `start_homophones` | (空) | 開始合図が音声認識で化けた綴り。**実際に化けたものだけ**足す | | `creds_label` | `🔑 合言葉` | 鍵パネルのボタン名 | **優先順位はキー単位**で決めてある。舞台の `order` / `set_label` は「今日の構え」なので `meeting.json` が正。個々の **URL は走行中に差し替えたい**ので `<状態Dir>/stage_urls.json` が勝つ(会議直前にURLが変わっても、プロセスを止めずに直せる)。 ### 稼働ライン — 沈黙と故障の区別 画面の上段に「受信 08:12:33 ・ 逐語 08:12:30 ・ 心拍 08:12:31」の1行が出る。 「起動したのに何も出ない」ときに、**材料が来ていない**のか**機構が落ちている**のかを、 ここだけで見分けるためのもの。 - **受信** … 最後に音が届いた時刻(`partial.json` / `latency.jsonl` の更新) - **逐語** … 最後に確定発話が書かれた時刻(`transcript.jsonl`) - **心拍** … 返し役・番人が `<状態Dir>/heartbeat.json` に書く `{"ts": ISO8601, "role": "responder"|"copilot", "model": ..., "note": ...}`。 **ファイルが無い / 60秒より古いときは「心拍なし」と表示する**(そこで落ちたりはしない) 3つとも「—」でも異常とは限らない。**まだ誰も喋っていないだけ**のことがあるので、 画面には「材料が無ければカードは出ません（それは設計どおり）」と常に添えてある。 ### 秘密の置き場 — 会議フォルダには置かない 合言葉・管理画面のログインは `MEETLIVE_CREDS_FILE` で**会議フォルダの外**を指す。 会議フォルダは資料置き場なので、うっかりリポジトリに載る事故が起きうるため。 書式は md の表。`| 用途 | URL | 合言葉 |` の行だけを拾う: ```markdown | 用途 | URL | 合言葉 | |---|---|---| | 管理画面 | https://example.com/admin | `xxxxxxxx` | ``` この中身は**HTMLに一切埋め込まない**。手元の画面が `/creds` を叩いた瞬間にだけ読む。 共有する別窓(`/stage/*`)はこの経路に触れないので、画面共有に合言葉は映らない (この不変条件は `tests/test_viewer_state.py` が毎回確かめている)。 --- ## 1.8 判定層（Decision Layer）— 発話ごとに「決めた問い」へ確率つきで答える **第1層（番人）はキーワード照合だけで動く。** 速くて落ちないのが取り柄だが、 書いた言葉と同じ言葉が出たときしか当たらない。会議で人は毎回違う言い方をするので、 実走ではここが軒並み外れた（段の切替4回は全部たまたま一致した無関係な語、 口にした約束は1件も記録に残らなかった）。 判定層は、その判定だけを**差し替えられる口**にする層。 ``` 発話 ─▶ state（直近K発話だけ）＋ questions（問いの束） ─▶ DecisionEngine.evaluate() ─▶ 問いごとの答えと確率 ─▶ （確信度ゲート）─▶ カード ``` | 実装 | 何をするか | 外へ出るか | |---|---|---| | `JevBackend` | 設定した宛先へ REST で1往復。問いは全部1回に積む | 出る | | `LLMBackend` | 同じ問いの束を、小型 LLM に JSON で答えさせる（OpenAI 互換） | 出る | | `RulesBackend` | いまのキーワード判定（`step_detect` / `lookup_assist`）を同じ問いの形に包んだもの | **出ない** | | `ChainEngine` | 上を順に試して、答えた実装で止まる。**どれが答えたかを記録に残す** | 途中で止まれば出ない | **退避の順序は `fallback_chain`**（既定 `[jev, "llm:anthropic/claude-haiku-4.5", rules]`）。前から順に試し、答えた実装で 止まります。**最後は必ず `rules`**——外へ出ない実装で終わらないと、全部落ちたときに 答えが1つも出ません（書き忘れても足します）。使わない段は外してよく、 `[jev, rules]` なら LLM を挟みません。`base_url` が空の段は鎖から自動で外れます。 段は `llm:<モデル>` と書けて、**同じ名前の段を何段でも**並べられます （1つ目の小型 LLM が落ちたら2つ目へ）。段ごとにタイムアウトを変えるなら辞書で: ```yaml fallback_chain: - jev - {llm: anthropic/claude-haiku-4.5, timeout_sec: 2.0} - "llm:openai/gpt-5.6-luna-fast" # 1つ目が落ちたらこちら - rules ``` `decisions.jsonl` の `backend` 欄に、**実際に答えた段がモデル名まで**残ります （`jev` / `llm:anthropic/claude-haiku-4.5(fallback)` / `rules(fallback)`）。 どのモデルが答えたのか分からないと、並べて測った意味が無くなるためです。 ここを見ないと「判定器で測った」つもりの数字が実はルールの数字、が起きます ——実測で 2,077発話のうち 1,754 が退避でした。 ### 小型 LLM を中段に置くとき 判定器が使えないとき（枠のレート制限・障害・契約前）の受け皿です。同じ問いの束を 言葉に直して送り、`{問いid: {"value":…, "confidence":…}}` の JSON で答えさせます。 **判定器ではない**ので、本物と違うところが2つあります。 - **確率分布が返りません。** 確信度1つから近似して埋め、答えに `approx: true` を 立てます。🔴 校正の表を読むときは、この印の付いた行を**混ぜないこと** - **崩れた JSON が返りえます。** 厳格に読み、選択肢に無い値は**丸めずに捨て**、 1問も読めなければ答えを捏造せず次の退避先へ渡します `--backend llm` で LLM 単独の成績を測れます（鎖を LLM から始める）。 `--llm-model <モデル>` を足すと、そのモデル1つ＋ルールの鎖になります （測っているモデルが途中で入れ替わらないよう、後ろの `llm` 段は外れます）。 Jev と並べて的中率を見てから、どちらを本線にするか決めてください。 🔴 **この道具は宛先を内蔵しない。** 送り先・鍵の環境変数名・モデル名は設定ファイル側。 設定に宛先が無ければ Jev は起動しません（既定は `rules`＝外へ1バイトも出ない）。 ### 1.8.1 問いの束 — `decisions.yaml` 会議フォルダ直下に置きます。置かなくても動きます（同梱の `config/decisions.example.yaml` に落ちる）。問いの束は案件に依らず、 **候補だけ**が会議フォルダから来るためです。 | 問い | 型 | 候補の出どころ | 誰の発話で聞くか | |---|---|---|---| | `q1_step` 段 | choice | `agenda_steps.json` の段＋`none` | 両方 | | `q2_phase` 局面 | score | opening / body / closing / ended | 両方 | | `q3_kind` 発話の種類 | choice | 8択（事実・質問・決定・約束…） | 両方 | | `q4_lookup` 探し物 | noul | — | **進行役だけ** | | `q5_quick_fact` 探し物はどの行か | choice | `quick_facts.md` の見出し＋`none` | 両方 | | `q8_commitment` 約束 | noul | — | **進行役だけ** | `q1_step` には `criteria_detail: true` を足せます（既定 false）。候補の説明に、 段の見出しだけでなく進行表の**「取る答え」**を添えます——見出しは4〜8文字しかなく、 判定材料として薄いことがあるためです（実測: 検収の段を「該当なし」と答える誤りが 48件中11件）。1問が長くなる＝入力トークンが増えるので、再生で効き目を確かめてから。 問いを足しても往復は増えません（1回の呼び出しの中で並列に答えます）。 進行役だけの問いは、相手の発話のときは**組み立てません**。候補が0件の問いは 丸ごと外します（「該当なし」しか選べない問いは料金だけ掛かります）。 型ごとの注意: - **閾値は型ごとに別で調整する。** 同じ問いでも choice と noul では返る数字の 大きさが違います。片方で決めた値をもう片方へ流用しないこと。 - **noul に確信度はありません**（返るのは「はい」の確率だけ）。校正を見るときの 確信度は `max(p, 1-p)` と決めてあります。 - **`instructions` は書いたとおりにしか読まれません。** 含みを持たせず、 「誰の」「いつの」発話について聞いているかを毎回書くこと。 - **日本語は精度が落ちます。** 閾値は保守的に始めて、再生の的中率を見てから緩めます。 ### 1.8.2 送る物 — 直近K発話だけ・人名は伏せる ```yaml window: utterances: 8 # 直近8発話。逐語の蓄積は送らない max_chars: 1200 # 1発話が異様に長いときの保険 privacy: roster: roster.txt # 会議フォルダの名簿（1行1名・任意） host_alias: 〈進行役〉 guest_alias: 〈相手〉 ``` 窓を切るのは料金のためではありません。判定器は **state が伸びるほど精度が落ちます** （判定に関係のない材料が答えを引っ張る）。 人名の置換は **送る物の全体**に掛かります——発話だけでなく、段の見出しや即答表の 見出しにも相手の名前が入りうるからです。名簿に姓名を空白区切りで書くと、 **姓だけ・名だけでも**伏せます（会議では姓だけで呼ばれる方が普通なため）。 `roster.txt` を作り忘れても、`meeting.json` の `counterpart` / `host_label` に 書いてある呼び方は**自動で名簿に入ります**（敬称は落とします）。ただしこれは 書き忘れの保険であって、出席者を数え上げたことにはなりません。 🔴 **だから名簿の関門は、保険の件数では開きません。** 見るのは `roster.txt` というファイルが**在ること**と、**中身が1件以上あること**だけです。 | 経路 | 名簿が無い／空のとき | |---|---| | `replay_eval.py --backend jev`(や `llm`) | **止まります**。作るか `--allow-no-roster` で明示的に押し切るか | | 会議中（`copilot.py`） | **外へ送る段（`jev` / `llm`）を組み立てません**。ルールだけで動き、起動ログに🔴で理由が出ます | 判定は同じ関数（`decision_engine.roster_gate`）で、**両方の経路が同じ規則**です。 片方だけ緩いと緩い方から漏れます——実際、会議中の経路だけが名簿の**中身**で 分岐しており、「作り忘れ＋`counterpart` あり」で警告なく実名が出る状態でした （2026-09-20 の独立レビューで発覚・修正済み）。 🔴 **これは匿名化の保証ではありません。** 書き漏らした名前は素通りしますし、 文脈から相手が分かることもあります。何を外へ出すかは、`decisions.jsonl` に残った **送った物の現物**を見て判断してください（`--dry-run` なら送る前に見られます）。 ### 1.8.3 鍵の置き場所 🔴 **鍵はファイルに書きません。** 設定に書くのは**環境変数の名前**だけです。 ```yaml jev: base_url: <送り先> # 例: ゲートウェイ経由 / 直契約の API path: /v1/systemone model: <モデル名> key_env: AI_GATEWAY_API_KEY # ← 鍵そのものではなく、鍵が入る変数の名前 timeout_sec: 2.0 # 2秒。再試行はしない（遅れて出るカードは邪魔） ``` 小型 LLM の宛先は別の枠（`llm:`）に書きます。ゲートウェイ経由なら**同じ鍵**が 使えるので、`key_env` は同じ名前で構いません。 走らせる側で `export AI_GATEWAY_API_KEY=...` します。鍵を会議フォルダに置かないのは 合言葉と同じ理由です（§1.5）。鍵が空のときは判定が例外になり、Rules へ退避します ——会議は止まりません。 ### 1.8.4 採点 — `replay_eval.py` 会議は1日1回しか来ません。閾値を当日の勘で決めると、外したことに気づくのは次の会議の 最中になります。**終わった会議の逐語を流し直して**、発話ごとに判定層を叩きます。 ```bash # ルール判定だけで最後まで通す（鍵は要らない・外へ出ない） python3 scripts/replay_eval.py \ --transcript <逐語.jsonl> --meeting <会議フォルダ> --backend rules # 何を外へ送るのかだけ見る（1件も送らない） python3 scripts/replay_eval.py \ --transcript <逐語.jsonl> --meeting <会議フォルダ> --backend jev --dry-run # 外の判定器で採点する export AI_GATEWAY_API_KEY=... python3 scripts/replay_eval.py \ --transcript <逐語.jsonl> --meeting <会議フォルダ> \ --backend jev --labels labels.csv ``` 出るもの: 問いごとの**的中率**・**対象外**（正解は付いているが、その発話では 聞いていない問いの件数。q4/q8 は進行役の発話にしか聞かないので、相手の発話に 付いた正解は分母に入れません）・noul の**再現率**（閾値 0.5 と 0.8）・ **確信度ごとの的中率**（校正の簡易確認。数字どおりに当たっていれば右肩上がり）・ **p50/p95 の遅延**・**総トークンと概算費用**・どの実装が答えたかの内訳。 **レート制限のある枠で回すとき**（無料枠は実測でおよそ10回/分。2,077発話を流したら 320しか通らず、残りは 429 でルールへ退避した）: | 旗 | 何をするか | |---|---| | `--ids ` | 判定する発話を絞る（`utterance_id` を1行1つ）。**窓の文脈は逐語全体から取る**ので、間引いても直前の話は欠けません | | `--pace <秒>` | 呼び出しの間隔。既定 0 | | `--retry-on-429` | 混雑(429/503)のときだけ、退避せず `--pace` ぶん待って**1回だけ**撃ち直す。既定 off。🔴 **会議中は使わない**——待つぶんカードが遅れるので、会議では待たずにルールへ退避するのが正しい | 正解を付けた発話だけを拾うのがいちばん効きます（`--ids` に正解表の `utterance_id` を 渡す）。判定の回数は減りますが、採点に使える数は変わりません。 正解表 `labels.csv` は3列。**発話の番号は逐語ファイルの1始まりの行番号**です。 ```csv utterance_id,q,gold 142,q1_step,s3 142,q8_commitment,yes ``` `gold` に書くのは鍵（`s3` `none` `yes` `no` `closing`）。鍵と見出しの対応は `--dry-run` が先頭に出します。 ### 1.8.5 費用の見方 単価は設定に書きます。**0 のままなら費用は計算しません**——この道具は他所の値段を 内蔵しないためです（値段は変わりますし、経路によっても違います）。 ```yaml pricing: input_per_mtok: 0.042 # 入力100万トークンあたり。自分が契約した単価を書く output_per_mtok: 0.0 currency: USD ``` `decisions.jsonl` の各行に `usage` が入っているので、会議1回ぶんを足せば実績が出ます。 再生の最後に概算が出ますが、**これは記録した usage からの算術であって請求書ではありません**。 ### 1.8.6 会議中に何が出るか | 設定（`meeting.json`） | 既定 | 意味 | |---|---|---| | `decision_backend` | `"rules"` | 判定層を何で回すか。`"jev"` にすると外へ出る | | `show_decision_cards` | `false` | 判定の答えをカンペに出すか。既定は**記録だけ** | どちらも既定のままなら、判定層は組み立てすらしません。`decision_backend` を `jev` にすると記録が溜まりはじめ、`show_decision_cards` を `true` にして初めて 画面が変わります。**閾値は先に `replay_eval.py` で実測してから**画面に出す、の順です。 🔴 **判定は本線の外で、発話ごとに走ります。** 1発話ごとに鎖のタイムアウト合計だけ 本線が待つ作りにすると、発話が4秒に1本来る会議では二度と追いつきません。かといって 班を1本に絞ると、鎖が遅い日は「走行中につき見送り」が大半になり、**カードが まったく出ない会議**になります。だから班は **3本まで重ねて走らせ**、それでも 溢れたら**いちばん古い未完了を諦めます**（新しい発話の方が価値がある。古い判定が 今ごろ返ってきても、会話は先へ行っている）。 - 諦めた判定は、返ってきても**画面には出さず記録だけ**残します （`decisions.jsonl` に `"abandoned": true`。採点では混ぜないこと） - 「諦める」は結果を捨てて枠を空けることで、通信を止めることではありません （走っているスレッドは外から止められない）。タイムアウトで自然に終わります - 起動時に「1発話あたり最大◯秒」を読み上げ、**4秒 × 班の本数**を超える鎖のときだけ 警告します。同梱の鎖は 2.0（判定器）＋1.5（小型 LLM）＝**3.5秒**に収めてあります - 会議中は混雑しても**撃ち直しません**（待つぶんカードが遅れるだけ） | 問い | 出るもの | 既定の境目 | |---|---|---| | Q8 約束 | **3行カード**（【対象】いまの段 or 相手の直前の発話／【状況】進行役がいま約束した「逐語40字」／【言うこと】確定なら「はい」と一声 → 台帳へ記帳）。宛先は「進行役へ」。同じ発話で1枚だけ | `0.8` | | Q4 探し物 | 既存の即答表アシストを起動（**合図の語と OR**。言い回しは毎回違うので両方で拾う）。カードの形は従来どおり | `0.5` | | Q1 段 | カンペ上部に小さく「推定の段: ④…」。🔴 **段は動かしません**（切替は従来どおりキーワードの規則。外したときに台本が飛ぶため） | `0.8` | | Q3 種類 | 画面には出ません。`small_talk` と判定したら**直後の催促を見送る**だけ | `0.8` | | Q2 局面 | `ended` が3発話続いたら終話の**予鈴**。🔴 **予鈴は停止ではありません**——畳むには従来どおり無音が続くことが必要です | `0.8` / `streak: 3` | 境目は `decisions.yaml` の各問いの `thresholds:` で変えられます（`act:` が確信度、 Q2 だけ `streak:` も見ます）。**確信が足りないものは何もしません**——外れたカードは、 無いカードより悪いからです。 判定層が例外を投げても番人は生き続けます（ログだけ残して次の発話へ）。 前提監視は**従来どおり同期で動きます**——Q3 で絞ると、判定層が落ちた日に 前提監視まで消えるためです（実測で退避率85%の日がありました）。 --- ## 2. 環境変数リファレンス（後方互換） **ふだんは `MEETLIVE_MEETING` 1本でよい**(§1.5)。以下は、会議フォルダを使わない場合と、 会議フォルダに置けないもの(状態Dir・秘密・モデル)のための一覧。 未設定でも**顧客データへは絶対に落ちない**。落ちる先は次の2つだけ: 状態ディレクトリ = `./meetlive_state`(カレント直下)、入力ファイル = 同梱の `config/*.example`。 環境変数が指すファイルが**存在しない**ときは、例へ落ちずに `SystemExit` で止まる (解決は `scripts/meetlive_config.py` の1箇所に集約してある。各スクリプトは 環境変数を直接読まない ── その規律は `tests/test_l_meeting_copilot.sh` が見張っている)。 ### 置き場 | 変数 | 既定 | 意味 | |---|---|---| | `MEETLIVE_DIR` | `./meetlive_state` | 状態(逐語・カード・ログ)の置き場。🔴**案件ごと・会議ごとに必ず分ける** | | `MEETLIVE_LEDGER` | `config/ledger.yaml.example` | 前提監視が読む事実台帳(YAML・`facts[].id` / `.title`) | | `MEETLIVE_AGENDA` | `config/agenda_steps.example.json` | 段と必須取得物 | | `MEETLIVE_SCRIPT` | `config/talk_script.example.md` | 台本(テレプロンプターの中身) | | `MEETLIVE_PHRASEBOOK` | `config/phrasebook.example.json` | 定型回答・約束の境界の文言 | | `MEETLIVE_STAGE` | `config/stage_resources.example.json` | 舞台に出せるもの(URL・画像・声で呼ぶ語) | | `MEETLIVE_KNOWLEDGE_DIR` | `config/` | answerer の接地資料ディレクトリ。🔴**この直下の `.md`/`.txt` を名前順に全部読み、そのままLLMへ送る**(§2.1) | | `MEETLIVE_SCRIPT_NAME` | `talk_script.example.md` | 接地資料のうち先頭に置く台本のファイル名 | | `MEETLIVE_MEETING` | (空) | **会議フォルダ**(§1.5)。これ1本で上の入力が全部決まる | | `MEETLIVE_CREDS_FILE` | (空) | 合言葉の md(§1.5)。未設定なら鍵パネルは中身なし | | `MEETLIVE_DOCS` | `<会議フォルダ>/docs` | 資料棚。会議フォルダが無ければ `<状態Dir>/docs` | | `MEETLIVE_BANK` | `<会議フォルダ>/bank.json` | 先読み回答バンク(任意) | | `MEETLIVE_LAYOUT` | `auto` | 画面の並べ方。`meeting.json` の `layout` が優先 | | `MEETLIVE_HEARTBEAT_STALE_SEC` | `60` | これより古い心拍は「心拍なし」と出す | ### 2.1 🔴 `MEETLIVE_KNOWLEDGE_DIR` に何を置くかは、そのまま「LLMへ送るもの」を決める `answerer.py` はこのディレクトリ直下の `.md` / `.txt` を**名前順に全部**読み、 上限(`MEETLIVE_KNOWLEDGE_PER_FILE` / `_TOTAL`)まで**逐語でプロンプトへ載せる**。 ファイル名の allowlist は持っていない。**置いたものは送られる。** したがって、**案件フォルダをまるごと指さないこと**。値付けの検討メモ・社内の下書き・ 相手に見せられない判断の記録が同じ階層にあれば、それも一緒に送られる。 ```bash # ✗ 危ない: 何が入っているか分からない階層を丸ごと指す export MEETLIVE_KNOWLEDGE_DIR=/path/to/projects/acme # ✓ 送ってよい資料だけを置いた専用ディレクトリを作って指す mkdir -p /path/to/projects/acme/meetlive_knowledge cp talk_script.md requirements.md minutes_prev.md /path/to/projects/acme/meetlive_knowledge/ export MEETLIVE_KNOWLEDGE_DIR=/path/to/projects/acme/meetlive_knowledge ``` サブディレクトリは読まない(直下だけ)。拡張子が `.md` / `.txt` 以外のものも読まない。 ### 会議の中身 | 変数 | 既定 | 意味 | |---|---|---| | `MEETLIVE_CALL_WORDS` | `コパイロット,こぱいろっと,秘書,ひしょ` | 呼びかけ語(カンマ区切り)。**STT の誤変換の綴りも並べる** | | `MEETLIVE_COUNTERPART` | `相手` | 相手の呼び方(プロンプト内で使う。例:「〇〇さん」) | | `MEETLIVE_HOST_LABEL` | `進行役` | こちら側の呼び方(プロンプト内で使う) | | `MEETLIVE_MODE_START_WORD` | `同席開始` | 同席の開始合図 | | `MEETLIVE_MODE_END_WORD` | `同席終了` | 同席の終了合図 | | `MEETLIVE_START_HOMOPHONES` | (空) | 開始合図が STT で化けた綴り。実際に化けた語を足す | | `MEETLIVE_PREMISE_IDS` | (空→台帳の先頭N件) | 監視する事実idのカンマ区切り | | `MEETLIVE_PREMISE_MAX` | `16` | id 未指定のとき台帳から取る件数の上限 | | `MEETLIVE_PREMISE_COOLDOWN` | `45` | 同種の前提カードを間引く秒数 | | `MEETLIVE_SCRIPT_MODE` | `with_lines` | カンペの粒度。`answers_only` で言い方の例を隠す（`meeting.json` の `script_mode` が勝つ） | | `MEETLIVE_QUICK_FACTS` | (空→会議フォルダの `quick_facts.md`) | 即答表の置き場。指した先が無ければ止まる | | `MEETLIVE_LOOKUP_COOLDOWN` | `120` | 同じ探し物を撃ち直すまでの秒数 | これら3つと下の3つは、いずれも `meeting.json`（`script_mode` / `auto_stop.*`）で 会議ごとに書くほうが本筋。環境変数は**その場だけ上書きしたいとき**の口。 ### 終話検知（全層の自動停止） | 変数 | 既定 | 意味 | |---|---|---| | `MEETLIVE_STOP_SILENCE_MIN` | `10` | 双方の無音がこれだけ続いたら終話(分) | | `MEETLIVE_STOP_FAREWELL_MIN` | `5` | 別れの言葉のあと、この無音で終話(分) | | `MEETLIVE_STOP_END_MIN` | `10` | 予定の終わりからこれだけ過ぎ、**かつ無音**なら終話(分) | 🔴 どれも「無音」とセットで効く。予定を過ぎただけでは止まらない（§3.2.5）。 ### モデル・接続 | 変数 | 既定 | 意味 | |---|---|---| | `MEETLIVE_AGENT_CLI` | (空→PATHにある方・両方あれば `claude`) | 使う CLI: `claude` / `codex` | | `MEETLIVE_MODEL_PREMISE` / `_EFFORT_PREMISE` | claude: `claude-sonnet-5`/`medium`
codex: `gpt-5.6-sol`/`low` | 前提監視(量産呼び出し) | | `MEETLIVE_MODEL_PREMISE_FALLBACK` / `_EFFORT_PREMISE_FALLBACK` | claude: `claude-opus-5`/`medium`
codex: `gpt-5.6-sol`/`medium` | 既定が空を返したときだけ1回 | | `MEETLIVE_MODEL_ANSWER` / `_EFFORT_ANSWER` | claude: `claude-opus-5`/`low`
codex: `gpt-5.6-sol`/`xhigh` | 台本外の回答(一発呼び出し) | | `MEETLIVE_MODEL_ANSWER_FALLBACK` / `_EFFORT_ANSWER_FALLBACK` | claude: `claude-sonnet-5`/`low`
codex: `gpt-5.6-sol`/`low` | 同上のフォールバック | **既定が CLI ごとに違うのは、モデルidがCLIをまたいで通用しないから**(片方の既定を もう片方に渡すと、CLI 自身のエラーで空が返る＝画面の上では「材料になし」と区別が つかない)。`MEETLIVE_MODEL_*` を明示すれば、どちらの CLI でもそれが勝つ。 ⚠️ **codex の前提監視だけ effort が低いのは節約ではない。** 前提監視は発話ごとに 叩き、呼び出し側の制限は20秒。実測(gpt-5.6-sol・短い1往復・2026-09-06)は **low 8.8秒 / medium 7.3秒 / xhigh 17.3秒**——xhigh は本番の長い前提リストでは 入らず、**間に合わないと沈黙する**(空振りではなく無音になる)。 | `MEETLIVE_KNOWLEDGE_PER_FILE` / `_TOTAL` | `9000` / `40000` | 接地資料の文字数上限 | | `MEETLIVE_TOKEN` | (空) | 子機との合言葉。`receiver.py --token` の既定値 | | `DEEPGRAM_API_KEY` / `OPENAI_API_KEY` | — | 使う STT バックエンドに応じて必須 | --- ## 3. セットアップ ### 3.1 前提 - **親機**: Linux または WSL2。Python 3.9+。**`claude` か `codex` のどちらかの CLI**が PATH にあり、認証済みであること。`premise_watch.py` / `answerer.py` / `responder.py` は `scripts/agent_cli.py` 経由でサブプロセスを起動する(claude なら `claude -p --model --effort `、codex なら `codex exec -m -c model_reasoning_effort= --ephemeral -s read-only -o `)。 どちらも無いと、この3つは黙って何も出さない。使う CLI は `MEETLIVE_AGENT_CLI` で固定できる (未指定なら PATH にある方・両方あれば `claude`) - **子機**: Windows ノートPC。Python 3.9+(`setup.cmd` が無ければ winget で入れる) - **2台をつなぐ網**: 子機から親機の TCP ポートへ届くこと。実運用では tailscale 等の プライベート網を想定。同じ LAN 内なら LAN の IP でよい - **STT の API キー**: Deepgram(`DEEPGRAM_API_KEY`)または OpenAI(`OPENAI_API_KEY`)。 **キー無しでも `--backend stub` で配管の検証だけはできる**(発話区間を検知して `[STUB] host の発話 1.2秒` のような行を transcript へ書く。話者・時刻・遅延・ jsonl の形式は本番と完全に同じ経路を通る) - **イヤホン／イヤモニ**(§0を読むこと。任意ではない) ### 3.2 親機のセットアップ ```bash # 1) 置き場を作る cd <このスキルの scripts/ を置いた場所> python3 -m venv venv ./venv/bin/pip install numpy websockets pyyaml ``` 依存はこれだけ(実際の import から数えたもの): | 部品 | どこで使うか | |---|---| | `numpy` | `receiver.py`(リサンプラ・音量測定)、`stt.py`(VAD・PCM変換) | | `websockets` | `stt.py` の OpenAI / Deepgram バックエンド(関数の中で import している) | | `pyyaml` | `premise_watch.py` が事実台帳を読む | `copilot.py` / `viewer2.py` / `answerer.py` / `action_log.py` / `meetlive_config.py` は **標準ライブラリだけ**で動く。 ```bash # 2) 案件の設定を指す export MEETLIVE_DIR=$PWD/meetlive_state/2026-01-20-acme # 会議ごとに別のディレクトリ export MEETLIVE_LEDGER=/path/to/projects/acme/ledgers/ledger.yaml export MEETLIVE_AGENDA=/path/to/projects/acme/agenda_steps.json export MEETLIVE_SCRIPT=/path/to/projects/acme/talk_script.md export MEETLIVE_PHRASEBOOK=/path/to/projects/acme/phrasebook.json export MEETLIVE_STAGE=/path/to/projects/acme/stage_resources.json export MEETLIVE_KNOWLEDGE_DIR=/path/to/projects/acme/meetlive_knowledge # 🔴 §2.1 export MEETLIVE_SCRIPT_NAME=talk_script.md export MEETLIVE_COUNTERPART="〇〇さん" export MEETLIVE_CALL_WORDS="コパイロット,こぱいろっと,秘書,ひしょ" export MEETLIVE_TOKEN="$(openssl rand -base64 18)" # 子機の config.txt と同じ値にする export DEEPGRAM_API_KEY=... # 3) 会議前に設定が読めるか確かめる(LLMもネットワークも使わない) ./venv/bin/python copilot.py --selfcheck ``` `--selfcheck` は段取り・台本・語彙集・舞台の資源を読んで件数を出して終わる。 **`⚠ MEETLIVE_XXX が未設定です。同梱の例を読みます` が出たら、その環境変数が 効いていない**(=架空の例のまま会議に入るところだった)。 ```bash # 4) 起動 (3つとも別プロセス。nohup なりターミナル多重化なりで並べる) ./venv/bin/python receiver.py --backend deepgram --port 47311 >> receiver.log 2>&1 & ./venv/bin/python copilot.py --start 2026-01-20T15:00:00 >> copilot.log 2>&1 & ./venv/bin/python viewer2.py --start 2026-01-20T15:00:00 --port 47323 >> viewer2.log 2>&1 & ``` #### 起動順について（正確に） **硬い制約は1つだけ**: `receiver.py` が待ち受けていないと子機は繋がらない (繋がらない間、子機は最大30秒まで待ち時間を伸ばして繰り返し試す)。 **だから receiver を先に上げる。** `copilot.py` と `viewer2.py` の間には順序の制約は無い。どちらも同じ `transcript.jsonl` を独立に読み、**同じ式で段を計算する**だけだからである。 ただし次の2つは守らないと、画面と番人が食い違う: 1. **`--start` を copilot と viewer2 で同じ値にする**。経過時間・予定時刻・超過判定が この値基準。(`receiver.py` に `--start` は無い。逐語を書くだけなので要らない) 2. **`MEETLIVE_AGENDA` を同じファイルにし、編集したら copilot と viewer2 の 両方を上げ直す**。 - `copilot.py` は段取りJSONを**起動時に1回だけ**読む - `viewer2.py` は、中段に出す台本ブロックだけは毎リクエスト読み直すが、 **段の判定に使う段取りは起動時に読んだものを使い続ける** (ここだけ読み直すと、番人が持つ古いキーワードと段の判定がズレるため) 片方だけ上げ直すと、下段のカードに書かれた段番号と上段の段番号がズレる。 ### 3.2.5 起動と停止 — `run.sh` / `stop.sh` 上の4行を毎回手で並べるかわりに、**会議フォルダ1つを渡して必要な層だけ起こす**口がある。 起こす層は `meeting.json` の `features` が決める。 ```bash export MEETLIVE_MEETING=~/meetings/2026-01-20-acme export MEETLIVE_DIR=~/meetlive_state/2026-01-20-acme export MEETLIVE_CREDS_FILE=~/secrets/acme_logins.md # 🔴 会議フォルダの外 export MEETLIVE_PYTHON=$PWD/venv/bin/python # 省略時は python3 ./run.sh --dry-run # 何をどう起こすかを見るだけ（前夜にこれを見る） ./run.sh --port 47323 --backend deepgram --keywords "固有名詞,を,カンマ区切り" ./stop.sh --port 47323 ``` ログは状態ディレクトリの `logs/<層>.log`、pid は `logs/<層>.pid`。 | 層 | `features` のキー | 備考 | |---|---|---| | `receiver.py` | `receiver`(既定 true) | 子機が繋ぐ先。**先に上げる** | | `viewer2.py` | (常に起こす) | これが無いと何も見えない | | `copilot.py` | `copilot` | 進行の番人。ルールだけ | | `responder.py` | `responder` | そのまま言える返し。材料は `kb/` 全量 | | `premise_watch.py` | `premise_watch` | **常駐ではない**。copilot が発話ごとに起こす子プロセス | 🔴 **`copilot` と `responder` を両方 true にはできない**（同じ `cards.jsonl` に書くので、 片方のカードがもう片方を押し出す）。`run.sh` は両方 true なら起動せずに止まる。 🔴 **`premise_watch: true` でも `copilot: false` なら前提監視は動かない**（起こす親がいない）。 `run.sh` はその組み合わせのとき警告を出す。**8時に画面を見てから気づく類の穴なので、前夜の `--dry-run` で読むこと。** #### 停止 — 全層で1つのファイル。`kill` は使わない 停止の合図は **`<状態Dir>/meetlive.stop` を1つ置くだけ**。各層がそれを見に行き、 **自分で**終わる。`stop.sh` はそのファイルを置き、ついでに viewer2 の `/quit` も叩く。 | 層 | 見る周期 | ほかの口 | |---|---|---| | `copilot.py` | tail の周回（0.3秒） | 終話を検知したら**自分でこのファイルを置く** | | `receiver.py` | 2秒 | — | | `viewer2.py` | 2秒 | HTTP `GET /quit`（localhost からのみ） | | `responder.py` | 周回ごと | 自分あての `responder.stop` | `run.sh` は起動前に**前回の停止ファイルを片付ける**（残っていると、起こした層が起動した 瞬間に自分で終わり、「画面は上がるのに番人が居ない」という一番分かりにくい壊れ方をする）。 `kill` / `pkill` は会議中に走っている別の python を巻き込み、書きかけの逐語やカードを 壊すので使わない（§7.1 も同じ理由）。 ##### 終話の自動検知 — 会議の最中には**絶対に**止めない 2026-09-19 の実走では、会議のあと3つのプロセスが**12時間近く**残り、誰も見ていない画面に 同じカードを903件描き続けた。`receiver` と `copilot` に停止の口が無く、手で畳むのを忘れた のが原因。番人が終話を検知して自分で畳むようにしたのがこの機構。 畳む条件は3つ。**どれも「無音」とセット**になっている: | 合図 | 条件 | |---|---| | 長い無音 | 双方の発話が `auto_stop.silence_min`（既定10分）来ない | | 別れの言葉 | `phrasebook.json` の `farewell_words` → そのあと `farewell_grace_min`（既定5分）の無音 | | 予定の終わり | `end` + `end_grace_min` を過ぎ、**かつ** `farewell_grace_min` の無音 | 🔴 **予定を過ぎただけでは止めない。** 同じ実走の会議は60分の予定に対して**133分**かかった。 「予定＋猶予で停止」だと会議の真っ最中に3層とも落ちる。会議の最中に落ちる害のほうが、 畳み忘れの害より大きい。同じ理由で、無音の閾値は秒ではなく**分**で置いてある （実測で会議の途中に150秒の片側ギャップがあった）。 `farewell_words` に「ありがとうございました」「よろしくお願いします」を**入れないこと** ——日本語の商談では会議の途中に何度も出る。 ### 3.3 子機(Windows)のセットアップ `scripts/portable/` の中身を、そのままノートPCへ持っていく(zip でよい)。 1. **`setup.cmd` をダブルクリック**(初回だけ・2〜3分) - Python を探し、無ければ winget で入れる - `venv/` を作り、`soundcard` と `numpy` を入れる - `config.txt.example` を `config.txt` へコピーし、メモ帳で開く 2. **`config.txt` を書き換える** ``` host=<親機のアドレス> ← プライベート網のIP port=47311 ← receiver.py --port と同じ token=<親機と同じ合言葉> ← MEETLIVE_TOKEN と同じ値 rate=16000 mic_match= ← 任意。§6 を見よ ``` 🔴 `config.txt` は**親機のアドレスと合言葉が平文で入るファイル**。 git に入れない・他人に渡さない。配るのは `config.txt.example` の方だけ。 例のまま(`CHANGE_ME...`)で起動すると、その場で止まって何を直すか出す。 3. **イヤホンを挿す**(START.bat より先に。§0) 4. **`START.bat` をダブルクリック** → 窓が2つ開く - `MIC (agent_mic) - my voice` … `[mic-only] 接続OK -> 送信中` が出れば成功 - `LOOP (agent_loop) - other side` … `[loop-only] connected OK -> sending` が出れば成功 - **2つとも出て初めて成功**。片方だけだと片側の声が丸ごと落ちる - 親機側のログにも `++ host 接続` `++ guest 接続` が出る 5. 止めるときは `STOP.bat`(または2つの窓を閉じる) `portable/` の中身: | ファイル | 役割 | |---|---| | `agent_mic.py` | 自分の声。**推奨経路**。デバイス列挙もループバックもしない最小版 | | `agent_loop.py` | 相手の声(WASAPI ループバック)。v10。録音スレッドと送信ループを分けてある | | `agent_loop_v9.py` | 上の旧版。**無音が続くと1バイトも送らない**ので実運用不可。デバイスが開けるかの切り分け用 | | `agent.py` | 2系統を1プロセスで扱う簡易版。片方が落ちると両方死ぬので非推奨 | | `agent_common.py` | `config.txt` の読み込み(接続先の既定値をコードに持たない) | | `START.bat` / `start_all.ps1` | MIC窓とLOOP窓を開くランチャ。LOOP窓は落ちたら3秒後に自動再起動 | | `STOP.bat` / `stop.cmd` | 止める | | `setup.cmd` / `start.cmd` | 初回セットアップ / `agent.py` の起動 | | `config.txt.example` | 設定の雛形 | | `手順.txt` | 子機を使う人へ渡す手順書(この SKILL.md を読まない人向け) | #### 子機と親機をつなぐ線の仕様 自前の取り込みプログラムを書くならこれに合わせる。 ``` 接続直後に JSON 1行 + "\n": {"ch":"T","rate":16000,"token":"合言葉"} ch = "T"(こちらのマイク) / "G"(相手側のループバック) 以降くり返し: struct ":47323/` | `http://<親機>:47323/stage/...` | | 誰が見るか | **自分だけ**。スマホ／携帯ディスプレイで見る | **相手**。これを画面共有する | | 中身 | 段の一覧・台本・カード・舞台の操縦ボタン | 資源1枚だけ(黒画面・スライド・画像など) | 舞台は `window.open(url, 'meetlive_stage')` で開く**名前付きの1枚の窓**。 共有するのはこの窓だけで、中身が声やボタンで切り替わる。 iframe は使っていない(相手先サイトが `x-frame-options: DENY` だったり、ログイン cookie が `SameSite=lax` だったりして中身が出ないため)。 カンペ画面をPCに出すと画面共有に映り込むので、**カンペはスマホで見る**。 `?theme=washitsu` を付けると和風の見た目になる(既定は暗い配色)。 起動のたびに、カンペの上部へ**舞台の使い方3行**が1回だけ出る（「分かった」で消える）。 実走で、開始56秒後の実発話が「舞台が見えてるけどどうすればいんだっけ操作方法教えて」 だった——手順は資源表にしか無く、進行画面に出ていなかった。 ### 4.1.5 カードの読み方 — 必ず3行 カードはすべて同じ形をしている。**上から順に読めば、そのまま声に出せる**。 ``` 進行 進行役へ 未解決 4回 10:47:10 [済] 対象 メール配信サービスの契約名義 状況 まだ取れていません 言うこと 「ご契約は御社名義でよろしいですか」 ← これを読む ``` | 行 | 意味 | |---|---| | 【対象】 | 何についての話か。**内部ID（`F-011` 等）は本文に出さない**——台帳の事実文が出る | | 【状況】 | 何が起きた・何が分かった | | 【言うこと】 | その場でそのまま読み上げられる完成文。**大きく出ているのがこれ** | 右上のラベル: - **進行役へ** … 声に出すもの - **記録のみ** … 裏で記録しただけ（舞台の切替・「考え中…」など。読まなくてよい） - **未解決 N回** … 同じ対象の催促が N 回目。**同じカードは積み上がらない** 🔴 **なぜこの形か。** 2026-09-19 の実走で出たカード1013件のうち、この3つがそろっていたのは **14件（1.4%）**だった。残りは「対象は分かるが、何が問題で・何を言えばよいかが本文に無い」型で、 進行役の言葉でいえば「どこの何のことを言っていて何をどうしていいかが分からない」。 さらに全体の95%が**同一文言1種類の反復**（960件）で、「読む／消える」の区別自体が 意味を失っていた。いまは同じ対象の催促は**初回だけフルカード**、以後は件数のバッジになる。 ### 4.2 会議の流れ 1. 子機の2窓が「送信中」になっているのを確認する 2. カンペ画面をスマホで開く 3. 舞台を使うなら、カンペ画面の「🎭 舞台を開く」を押して別窓を出し、それを画面共有する 4. **「同席開始」と声に出す** → ここで番人の状態がリセットされる (前夜のリハ発話やテスト行を本番に持ち込まないため。この合図が無いと、 起動時に読んだ古い逐語が段の判定に混ざる) 5. 会議中に使える声のコマンド: - `<呼びかけ語>、次` / `<呼びかけ語>、戻って` … 段を手で送る／戻す - `<呼びかけ語>、時間` … 経過・残り・いまの段の予定枠 - `<呼びかけ語>、成果は` … 必須取得物の未達一覧 - `<呼びかけ語>、スライド` … 舞台を切り替える(語は `stage_resources.json` の `match`) - `<呼びかけ語>、舞台消して` … 舞台を黒画面に戻す - それ以外 … 台本と段取りの全文検索。当たらなければ「手元にありません」 6. **「同席終了」と言う** → 逐語に区切りが入る(判定は続くが状態は保持される) 7. 子機の `STOP.bat`、親機のプロセスを止める ### 4.3 会議のあと — 何をしたか検証する ```bash MEETLIVE_DIR=$PWD/meetlive_state/2026-01-20-acme \ python3 action_log.py --date 2026-01-20 --md action_log_0120.md ``` カード発火・舞台切替・前提監視の判定・段の進行を、**1本の時刻順の年表**にする。 `--kind card` などで種別を絞れる。`--from-time` / `--to-time` で実開始で切れる。 これは飾りではない。**「モニタが鳴らし続けたあの催促は、誤検知だったのか、 本当に未達だったのか」を後から確かめる唯一の手段**である(§5.4)。 年表と `transcript.jsonl` を並べて読むこと。 --- ## 5. 実戦で得た設計知見 ここは「そう決めた理由」を残す節。同じ穴を掘り直さないために書いてある。 ### 5.1 🔴 議事録AIの要約を入力に使わない。逐語の生ログだけを信じる Gemini 等の議事録AIが出す要約を、モニタや台帳の入力に使ってはならない。 実測で、要約から取った項目は**10件中4件しか正しくなかった**。 最悪の壊れ方は「**疑問形を約束に格上げする**」——相手が「〜できますか？」と聞いただけの ものが、要約では「〜することで合意」になる。これが事実台帳に入ると、前提監視は **間違った前提**を基準に「矛盾」を判定し始める。 この道具の配管は最初からそうなっている: `receiver.py` が STT の確定発話だけを `transcript.jsonl` へ追記し、`copilot.py` はそれを tail する。要約が入る隙間が無い。 **会議後の台帳更新でも同じ規律を守ること**(要約は索引としてなら使ってよい。 配管には使わない)。 ### 5.2 前提監視は量産呼び出しになる。既定を安いモデルに置く `premise_watch.py` は**相手の発話1件ごとに1回**呼ばれる(`copilot.call_premise_watch`)。 実測で **50分の会議で218回**。ここに上位モデルを置くとクォータの底が抜ける。 だから既定は Sonnet 相当・`--effort medium`、**異常時(空が返ったとき)だけ上位モデルへ 1回フォールバック**する形にしてある。 **呼ぶ回数を減らす方向で節約しないこと。** 発話をフィルタで間引くと精度が落ちる—— 会話は途切れ途切れで、断片も拾わないと文脈が繋がらない。**呼ぶ頻度は変えず、単価を下げる。** 対照的に `answerer.py` は台本外の質問のときだけ・30秒に1回まで(`ANSWERER_MIN_GAP`)の **一発呼び出し**なので、上位モデルを置いてよい。 **量産呼び出しか一発呼び出しか**で、置くモデルを分けるのが原則。 ### 5.3 🔴 イヤホン／イヤモニは必須。任意ではない §0 に書いたとおり。話者分離を物理チャンネルでやっている以上、 スピーカーで相手の声を鳴らした瞬間に土台が崩れる。`--xtalk-gate` は保険。 ### 5.4 🔴 必須取得物の検知キーワードは、実際の会話で試さないと機能しない `unmet()` は「その必須取得物の検知キーワード(正規表現)が、蓄積した発話全文に 1つも当たらない」ときに未達とみなす。つまり**キーワードが実際の言い回しに 当たらなければ、永遠に未達のまま催促が鳴り続ける**。 実際に、**18分間ずっと同じ催促が鳴り続けた**会議があった。 ただし——**あとで逐語と突き合わせたら、それは誤検知ではなく、本当に未達だった**。 モニタは正しく鳴らし続けていた。 ここが両面である。 > **モニタは「キーワード設計が悪い」と「本当に取れていない」を区別できない。** > どちらも同じ「鳴り続ける」として出てくる。 したがって: - **キーワード設計をサボると、真実を鳴らし続けるだけの装置にもなりうる** (鳴っていること自体は情報量ゼロ。原因が2つあるので) - 正規表現として当たるので、**言い換えを `|` で並べておく**のが実用的。 例: `"(月末|来月末|末日)まで"` - 会議の前に、**想定される相手の言い回しを声に出して1度通す**こと - 会議の後に、必ず `action_log.py` の年表と逐語を突き合わせ、 **「鳴っていた催促はどちらだったのか」を判定して、キーワードへ反映する** 会議1回ごとにこれを回さないと、キーワードは永遠にチューニングされない。 ### 5.5 🔴 案件を移すときは、必ず状態ディレクトリ(`MEETLIVE_DIR`)を隔離する 同じディレクトリを使い回すと、**過去の会議の逐語が段の判定に混ざる**。 `copilot.tail()` は起動時に既存の `transcript.jsonl` を読み、直近の「同席開始」以降を 無言で再生して状態を復元する。`viewer2.build_nav()` も逐語を**切り詰めずに全部**読む (末尾N行だけ見ると、長い会議で古い発話が窓から落ちて段が巻き戻るため)。 つまり**古い逐語は消えずに効き続ける**。案件ごと・会議ごとに分けること。 ```bash MEETLIVE_DIR=$PWD/meetlive_state/2026-01-20-acme # 会議1回 = 1ディレクトリ ``` `cards.jsonl` / `premise_watch.jsonl` / `stage_cmd.jsonl` / `display_log.jsonl` も すべてここに溜まるので、隔離しておくと会議後の検証もそのまま案件別になる。 ### 5.6 番人は呼ばれ待ちをしない層を持つ 初期版は「呼ばれたら答える」だけだった。その結果、**相手が前提を覆す発言をしても、 呼ばれない限り何も出なかった**。前提監視(`premise_watch.py`)はこれを直すために、 相手の発話ごとに自発的に撃つ層として足したもの。 判定は3値(矛盾⚠ / 既知✔ / 新規＋)で、**カードを出さなかった判定も含めて全件** `premise_watch.jsonl` に残る。画面に出なかったからといって、判定していないわけではない。 ### 5.7 事実台帳は10〜20件に絞る `MEETLIVE_PREMISE_MAX` の既定が16なのはこのため。全部入れるとプロンプトが膨らみ、 「矛盾」の判定がぼやけて鳴らなくなる。**今日の会議で覆されたら困る事実**だけを選ぶ: 契約・約束の範囲境界、相手の現状についてこちらが握っている認識、前回決まったこと。 ### 5.8 🔴 材料の切り詰めは「沈黙」ではなく「捏造」を生む 2026-09-03 の実測。返し役の材料(台本)を 9,000字に切ったところ、**答えが後半にある問いで 「手元にありません」ではなく、台本と逆の答えを自信をもって返した**（台本が禁じている 「はい、ぜひお願いします」を、そのまま言える返しとして出した）。 切り詰めは「知らないことを知らないと言う」方向には働かない。**材料の一部だけを見た モデルは、見えている範囲でいちばんもっともらしい話を作る**。だから `responder.py` は `MEETLIVE_KNOWLEDGE_PER_FILE` / `_TOTAL` に**従わない**（`answerer.py` は従う。あちらは 台本外の質問に一発で答える構えなので、材料が広いほど的が散る）。 🔴 **`kb/` に置くものは、そのまま送られる分量として選ぶ**。切るなら棚から抜くのであって、 コードに切らせない。 同じ実測から、機械の関門を2つ入れてある。**どちらかに落ちたら「材料になし」に降格する**: 1. **接地** — 返しの中に台本の30字以上の連続片が無ければ、それは台本の文言ではない （捏造答えは台本と17字しか一致せず、本番で通った15本は64〜142字一致していた） 2. **節の語** — 節の見出し語が相手の発話に1つも出てこないなら、話題の違う節へ吸い寄せられた形 そして**「材料になし」はカードにしない**（議題外の雑談のたびに画面が「手元にありません」で 塗り替わり、直前の使える返しを押し出すため）。ただし**声で呼ばれたときだけは必ず出す** —— 呼んだのに何も出ないと、壊れたのか材料が無いのかが手元から区別できない。 --- ## 6. 自分の案件に合わせる — 書くのは**進行表1枚と台帳** 🔴 **コードは1本・案件ごとに違うのは会議フォルダの中身だけ。** 会議のたびに用意するのは 次の2つで、`agenda_steps.json` と `talk_script.md` は**進行表から生成する**（§6.2）。 | 書くもの | 何に効くか | |---|---| | 進行表 `agenda_sheet.md` | 相手に渡す1枚。ここからカンペと段取りを作る（§6.2） | | 事実台帳 `ledger.yaml` | 前提監視の基準（§6.1） | | （任意）即答表 `quick_facts.md` | 探し物アシストの索引（§6.3） | 残り2つ(`phrasebook.json` / `stage_resources.json`)は既定のままでも成立する。 ### 6.1 `ledger.yaml` — 事実台帳（前提監視の基準） ```yaml facts: - id: F-001 title: 発注は保守フェーズのみ。新規開発は今回の範囲に含まない - id: F-002 title: 相手先の在庫管理は今も表計算ソフトで、担当者1名に集中している ``` `id` と `title` だけあればよい(他の列は人間の管理用)。 既に3台帳(`templates/context_ledgers_template.md`)を運用しているなら、 **その `ledger.yaml` をそのまま `MEETLIVE_LEDGER` に指せる**。 `title` は**一文で言い切る**こと。「〜について」のような見出しだと、 LLM が矛盾を判定できない。 ### 6.2 🔴 進行表1枚から作る — `build_agenda.py` **台本を別に書かないこと。** 相手に渡す進行表（Notion 等に貼る1枚）と、こちらのカンペを 二重に持つと、会議では必ず片方しか見ない。2026-09-19 の実走で突合したところ、 台本の特徴句40件のうち実際に口に出たのは**1件**（しかも別件の偶然一致）で、 進行役は最初から最後まで確認シートの流れで話していた。 ```bash python3 scripts/build_agenda.py <進行表.md> --out <会議フォルダ> --check ``` 入力はごく普通の Markdown（そのまま相手に貼れる形）。同梱の実物は `config/example_meeting/agenda_sheet.md`： ```markdown ## 📋 アジェンダ（45分） - [ ] **1. 今日決めたいこと（3分）** — ①移行の範囲 ②承認の道すじ ③次回の日付 - [ ] **2. 現状の確認（10分）** — 担当の人数と、残っているデータの年数 ## ❓ 確認したいこと **今日ぜひお答えいただきたいもの** - [ ] いまの在庫の管理は、どなたが担当されていますか ``` 見出しは「アジェンダ / 進行 / 次第 / agenda」「確認したいこと / 確認事項 / 質問」を 含むものを拾う（絵文字・括弧つきでよい）。出るのは2ファイル: | 出力 | 中身 | |---|---| | `agenda_steps.json` | 段・目安分・検知キーワード・必須取得物・3要素（取る答え／言い方の例／抜けたら出す問い） | | `talk_script.md` | カンペ。段ごとに**3行だけ** | **「確認したいこと」は段へ自動で割り付く**（語の重なりで決め、同点は前の段）。 割り付いた問いが、その段の必須取得物と「抜けたら出す問い」＝**カードの【言うこと】**になる。 #### 機械では決められないところは、同じ1枚に注記で書く Markdown のコメントは Notion に貼っても表示されないので、**進行表を1枚のまま**保てる。 | 注記 | 効き方 | |---|---| | `` | その段の検知キーワードを足す | | `` | 言い方の例（キメ台詞）を上書き | | `` | その段の「抜けたら出す問い」を上書き | | `` | 必須取得物を足す（複数行書ける） | 🔴 **埋まらなかった欄に文章を発明しない。**「（要記入）」と書いて出す。 `--check` を付けると、そういう欄が残っていれば終了コード1で知らせる （会議の前夜にこれを見る）。 🔴 **検知キーワードは「言い方の例」に文字どおり含まれる**ように作る。つまり **キメ台詞を読み上げれば段が進む**。実走ではここが切れていて、段の切替4回とも 台本と無関係な語の偶然一致だった。 #### 段ごとの3行（`talk_script.md`） ```markdown ## 【1】 ① 今日決めたいこと 取る答え: ①移行の範囲 ②承認の道すじ ③次回の日付 **今日決めたいことは3つです。** **抜けたら: 今日はこの3つを決めさせてください。よろしいですか** ``` | 行 | 画面 | |---|---| | `取る答え: …` | 小さく（常に出る） | | `**…**`（言い方の例） | 大きく。`script_mode: answers_only` で**隠れる** | | `**抜けたら: …**` | 大きく（常に出る） | `script_mode: answers_only` は「読み上げ用の台詞が画面にあると、そこを読もうとして 会話が固くなる」ときに使う。隠れるのは言い方の例だけで、取る答えと問いは残る。 ### 6.2.1 手で書く場合の `agenda_steps.json` `build_agenda.py` を使わず手で書いてもよい（従来の形はそのまま読める）。 ```json { "会議分": 45, "警報分": 10, "steps": [ { "id": "s1", "title": "① 現状の確認", "目安分": 10, "検知キーワード": ["まず現状", "いまの運用"], "必須取得物": [ {"名前": "現行の担当者数", "検知キーワード": ["(担当|運用)(は|が)?\\s*\\d+\\s*(名|人)", "一人でやって"], "問い": "いまの担当は何名でいらっしゃいますか"} ], "取る答え": "担当の人数と、残っているデータの年数", "言い方の例": "では、現状の確認に入らせてください。", "抜けたら出す問い": "いまの担当は何名でいらっしゃいますか", "nudge": "相手に喋らせる。こちらの案はまだ出さない", "台本": ["まず、いまの運用を確認させてください。"] } ] } ``` - **段の検知キーワード**は**こちら側の発話にだけ**当たる。 → **台本で必ず口にする語**を選ぶ。相手が言いそうな語を入れると勝手に進む - **必須取得物の検知キーワード**は**両者の発話に**当たる(答えるのは相手なので) → 🔴 §5.4 を読むこと。**ここのチューニングが全体の当たり外れを決める** - **`問い`** は取り漏れカードの【言うこと】になる。空だと「〜について、いまどうなって いますか」という定型に落ちる（読めはするが、進行表に書いた本文のほうがよい） - 英語キー(`title` / `minutes` / `keywords` / `musts` / `name` / `ask` / `answer` / `say` / `script` / `total_minutes` / `warn_at_minutes`)でも書ける ### 6.3 `quick_facts.md` — 即答表（探し物アシスト） 会議の最中、進行役が「ちょっとお待ちください」「確認します」「どこだっけ」と言った瞬間に、 **1秒以内**にカードを出すための索引。会議フォルダ直下に置くだけで効く（任意）。 ```markdown ## 検証環境の入口 画面: 検証用のログイン画面（資料棚の「環境の一覧」1行目） 使えるアカウント: demo-01 / demo-02 / demo-03 の3つ ``` - 話題は **`##` 見出し**。相手が言いそうな言葉で書く（正式名称より通称）。 `#`（H1）はその表の題として読み飛ばすので、H1 の下に書き方のメモを置いてよい - その下の行が**そのまま読める値**。URL・アカウント名・件数・日付・手順の所在 - 🔴 **合言葉・パスワード・トークンの値は書かない。** 書くのは「どこにあるか」だけ #### 伏字は「見出しに印が付いた項目」だけ 値を置かざるを得ない項目は、**見出しに印を付ける**: ```markdown ## secret: 管理画面のログイン ← これと ## 管理画面のログイン [secret] ← これは同じ（秘密/機密 でも可） ``` 印の付いた項目だけ、値らしい長い文字列（英数記号12字以上）が `••••` に置き換わり、 【言うこと】が「値は画面に出しません。鍵パネル（🔑）で確認してください」に変わる。 印が無くても、見出しが**値そのものを名指している**とき（`パスワード` `合言葉` `秘密鍵` `APIキー` `アクセストークン` `credential` 等）は同じ扱いになる。 🔴 **本文は見ない。** 以前は見出しと本文の全文に「鍵」「秘密」を部分一致させていて、 同梱のデモの「連携の相手先」が——本文に「動画配信: 鍵があと1つだけ足りない」と 書いてあるだけで——決済やメール配信の状況ごと伏字になった。進行役がその場で 言いたい実務情報が消えるので、判定は**見出しの型**に寄せてある（2026-09-20 修正）。 - 探し始めの合図は `phrasebook.json` の `lookup_triggers`（未設定なら汎用の既定語） - 即答表・台帳(`ledger.yaml` の facts)・`kb/` の順に当て、**当たらなければ answerer(LLM)** - 当たらなかった問い合わせは `<状態Dir>/lookup_misses.jsonl` に残る。 **会議のあとにこれを見て即答表を育てる**のが、次の会議の準備の一部 （会議の準備手順を持っているなら、その最後に「即答表を1枚書く」を足すこと） ### 6.3.1 `talk_script.md` を手で書く場合（従来の形） ```markdown ## 【1】 現状の確認 **まず、いまの運用を確認させてください。** ### 聞く順番 **データは、何年分くらい残っていますか。** （移行範囲の見積りに効く） ▸ 「わからない」と言われたら → 「では、いまの置き方で仮に作っておきます」 （ト書き。小さく薄く出る） ``` | 行の形 | 画面での出方 | |---|---| | `## 【N】 見出し` | 段N の始まり。N は `agenda_steps.json` の並び順(1始まり)と対応 | | `**声に出す文**` | 大きく表示。後ろに続く文字は小さい注記になる | | `### 小見出し` | 段の中の区切り | | `▸ 条件 → 言うこと` | 折りたたまれた分岐 | | `（ト書き）`・表 | 小さく薄い注記 | `▸` 行の「」で囲んだ部分は、番人が「**台本が想定している言い回し**」として拾う。 相手がその言い方をしたら、疑問符が無くても第2層(answerer)を呼んでよい、の判定材料になる。 `## 【N】` 以外の `##` 節はテレプロンプターに出ないので、準備メモはそちらへ書く。 ### 6.4 呼びかけ語は、誤変換の綴りも並べる ```bash export MEETLIVE_CALL_WORDS="コパイロット,こぱいろっと,カタカナ以外の誤変換,..." ``` STT は呼びかけ語を高確率で化かす。**1回でも化けた綴りは、そのまま足す。** 開始合図が化けた場合は `MEETLIVE_START_HOMOPHONES` に足す(こちらは「開始/スタート」との 組み合わせでのみ効くので、多少広く入れても暴発しにくい)。 --- ## 7. トラブルシュート ### 7.1 ポートが埋まっている / 差し替えたい — `kill` を使わない 3つとも**自分で席を譲る仕組みを持っている**ので、プロセスを撃つ必要がない。 | プロセス | 差し替え方 | 仕組み | |---|---|---| | `viewer2.py` | `curl http://127.0.0.1:47323/quit` してから新しいのを起動 | `/quit` は**localhost からのみ**受け付け、0.3秒後に自ら終了する。外から止められると会議中に事故るのでこの制限がある | | `copilot.py` | **新しいのをそのまま起動するだけ** | 起動時に `/copilot.owner` へ自分のpidを書く。古い方は次のポーリング(0.3秒)で持ち主が変わったのに気づき、自分から降りる | | `receiver.py` | `allow_reuse_address` が立っているので、止めた直後に上げ直せる | 子機の二重接続も同様に、**新しい接続が古い接続を打ち切って差し替える**(取り残しがあると全行が二重に出るため) | `kill -9` で落とすと、`copilot.owner` に死んだpidが残ったり、状態ファイルが中途半端に なったりする。**上の経路を使うこと。** ### 7.2 音が届かない — 確認の順序 1. **子機の2窓**に `接続OK -> 送信中` / `connected OK -> sending` が出ているか - 出ていない → `config.txt` の `host` / `port`、プライベート網の接続を見る - `合言葉が違う` が親機のログに出る → `token` が親機と一致していない 2. **親機のログ**に `++ host 接続` `++ guest 接続` が両方出ているか 3. **`/transcript.jsonl` が増えているか** - 増えない → STT のキー(`DEEPGRAM_API_KEY` / `OPENAI_API_KEY`)を確認 - 切り分け: `--backend stub` で上げ直す。キー無しで `[STUB] ... の発話 N秒` が 出るなら、**配管は生きていて STT だけが問題**と分かる 4. **片側だけ入らない** - 相手の声だけ入らない → 会議アプリの音が出ているデバイスが「既定のスピーカー」か。 イヤホンを挿し直したら `START.bat` を叩き直す(取り込み先は起動時に決まる) - 自分の声だけ入らない → 既定のマイクを確認。既定マイクが Bluetooth 機器だと 取得時にネイティブ層ごと落ちることがある。その場合は `config.txt` の `mic_match` に内蔵マイク名の一部を書いて指名する 5. **文字が二重に出る** → 子機が2つ動いている。`STOP.bat` してから `START.bat` ### 7.3 カードが出ない — 確認の箇所 1. **`MEETLIVE_DIR` が copilot と viewer2 で同じか**。 `copilot.py` は `/cards.jsonl` へ書き、`viewer2.py` は同じファイルの末尾40行を読む。 ここが食い違うと、番人は動いているのに画面には永遠に何も出ない 2. **`/cards.jsonl` に行が増えているか** - 増えている → 表示側の問題。カードは `ttl` 秒で消え、**新しい発話が2つ来ても消える** (ただし出してから最低8秒は残る)。会話が速い区間では見逃しやすい - 増えていない → `copilot.log` を見る。`CARD` の行が出ていなければ判定に達していない 3. **前提カードが出ない** - `/premise_watch.jsonl` を見る。**カードを出さなかった判定も全件残っている** - `type: なし` ばかり → 事実台帳の `title` が見出し調で、矛盾を判定できていない - `debounced: true` ばかり → 同種の連発を45秒で間引いている(`MEETLIVE_PREMISE_COOLDOWN`) - ファイル自体が空 → CLI が PATH に無い / 認証が切れている / モデルidが いま使っている CLI のものでない。まず `python3 agent_cli.py` で、どちらの CLI が 選ばれて何が起動されるかを1行で見る。次に 手で `python3 premise_watch.py "テストの発話"` を叩いて確かめる 4. **台本外の質問に答えない** - 発火条件が厳しい: 「明確な疑問形の語尾 **かつ 30字以上**」または 「台本の `▸` 行が想定している言い回し」のどちらか。しかも30秒に1回まで - これは意図的に厳しくしてある(緩めると相手の言いさし断片で撃ちまくり、 画面がカードで埋まって台本が読めなくなる) - `/answerer_log.jsonl` に、カードを出さなかった「手元にない」も含めて全件残る 5. **段が進まない / 勝手に進む** - 段の検知キーワードは**こちら側の発話にだけ**当たる。イヤホンをしていないと 相手の声が `host` として入り、勝手に進む(§0) - `<呼びかけ語>、次` で手で送れる。手動の送りは自動判定に**加算**される ### 7.4 会議前の点検（1分） ```bash python3 copilot.py --selfcheck # 設定が読めるか・件数は妥当か python3 premise_watch.py "テストの発話です" # LLM経路と台帳が生きているか ``` `--selfcheck` で `⚠ ... 未設定です。同梱の例を読みます` が1行でも出たら、 **架空の例のまま本番に入るところだった**ということ。環境変数を見直す。 --- ## 8. 収録物 ``` meeting-copilot/ ├── SKILL.md ├── config/ … 全部「架空の案件」の例。中身を入れ替えて使う │ ├── meeting.example.json … 会議1回ぶんの構え(会議フォルダの入口・§1.5) │ ├── ledger.yaml.example … 事実台帳(前提監視の基準) │ ├── agenda_steps.example.json … 段と必須取得物 │ ├── talk_script.example.md … 台本(テレプロンプターの中身) │ ├── phrasebook.example.json … 定型回答・約束の境界の文言 │ ├── stage_resources.example.json … 舞台に出せるもの │ ├── decisions.example.yaml … 判定層の問いの束(§1.8) │ └── example_meeting/ … そのまま起動できるデモ会議フォルダ(全部架空) │ ├── agenda_sheet.md … 進行表1枚。ここから下の2つを生成する(§6.2) │ ├── agenda_steps.json / talk_script.md … build_agenda.py の出力 │ ├── quick_facts.md … 即答表(探し物アシストの索引・§6.3) │ ├── decisions.yaml … 判定層の問いの束(会議フォルダ側が勝つ) │ └── roster.txt … 判定層へ送る前に伏せる名前(§1.8.2) ├── tests/ … 標準ライブラリだけの回帰テスト(CIのグループL) │ ├── test_viewer_state.py … 済の永続化/カード列/資料棚/合言葉/舞台/レイアウト │ ├── test_mode_signal.py … 開始合図(書く側と読む側が同じ入力を受理するか) │ ├── test_build_agenda.py … 進行表→段取り/カンペ(割り付け・注記・発明しない) │ ├── test_cards.py … カードの3要素/催促の抑制/終話検知/探し物/粒度 │ ├── test_responder.py … 返し役(材料を切り詰めない・接地の関門) │ ├── test_decision_engine.py … 判定層(問いの組み立て/マスク/退避/採点) │ └── test_decision_live.py … 会議中の配線(カードの発火条件・見送り・予鈴) └── scripts/ ├── meetlive_config.py … 置き場と設定の解決(既定の一元管理) ├── mode_signal.py … 「同席開始」の判定(書く側・読む側で共有する1本) ├── step_detect.py … 「いまどの段か」の判定(番人・画面で共有する1本) ├── build_agenda.py … 進行表1枚 → agenda_steps.json + talk_script.md ├── lookup_assist.py … 探し物アシスト(合図の検知と即答表の索引) ├── decision_engine.py … 判定層(Rules / Jev / 退避・§1.8) ├── replay_eval.py … 過去の逐語を流し直して判定層を採点する ├── receiver.py … 音を受けて逐語へ ├── stt.py … STTアダプタ(stub / OpenAI / Deepgram) ├── copilot.py … 番人(第1層・LLM無し) ├── premise_watch.py … 前提監視(量産呼び出し) ├── answerer.py … 台本外の回答(一発呼び出し) ├── viewer2.py … カンペ画面 + 舞台画面 ├── action_log.py … 会議後の行動年表 └── portable/ … 子機(Windows)一式。ノートPCへ持っていく ├── agent_mic.py / agent_loop.py / agent_loop_v9.py / agent.py ├── agent_common.py ├── START.bat / STOP.bat / start_all.ps1 ├── setup.cmd / start.cmd / stop.cmd / agent_loop.cmd ├── config.txt.example … 🔴 実物(config.txt)はコミットしない └── 手順.txt … 子機を使う人へ渡す手順書 ``` **この一式に案件のデータは入っていない。** 顧客名・URL・合言葉・金額・実在のパスは すべて設定ファイル側にあり、設定ファイルの実物はこのスキルの外に置く。