はじめに:なぜ作ったのか
会社でも家庭でも、会話がうまく続かないことがあります。それに、悪気はないのに言葉がきつくなって、相手を傷つけてしまったこともありました。
例えば、妻から洗濯物の中にティシュが入っていて注意されたときに、逆ギレして過去の話を出したりと、妻には不快な思いをさせるときがあります。
そんなとき、会話術について書かれた記事を読んで、強く共感しました。
例えば、
「嫌われる人」 : 言い負かすために否定して、誰にも反論させない
「好かれる人」 : 共通の課題を見つけて一緒に解決する
説明として、「論破してくる相手と仕事をしたい人はいない」です。
ただ、読んで納得しただけでは、実際の会話で使えるようにはなりません。身につけるには練習が必要だと思い、練習用のツールを作りました。それが今回紹介する「会話アドバイザー」です。
Python 3.12 と Streamlit、Anthropic API で作った個人用のローカルアプリで、GitHub で公開しています。

どんなツールか
大きく2つの機能があります。
機能1:会話アドバイザー
自分の会話に対して、助言をもらう機能です。モードは3つあります。
- A 送信前チェック:言おうとしている一言や、送ろうとしている文面を見てもらう
- B 会話の振り返り:実際に交わした会話を見てもらう
- C 次の一言の提案:相手の発言に対して、どう返すかを考えてもらう
相手との関係(上司、同僚、友人、家族など)と場面(依頼、謝罪、励ましなど)を選んで会話を入力すると、助言が返ってきます。出力は次のとおりです。
- 全体所見
- 良かった点
- 指摘事項
- 改善案(そのままコピーして使える文)
- 注意点
指摘事項には、「質問」「褒める」「自分の話」「助言」「説明」「正論」「返答」の7つの分かれ道と、場面別の言い換えカテゴリのバッジが付きます。なぜそう言えるのか、根拠も一緒に示されます。
もうひとつ、気に入っている点があります。問題が見当たらないときは、無理に指摘しない設計にしました。駄目出しばかりのツールは、使っていて疲れてしまうからです。


機能2:会話トレーニング(ゲーム)
こちらが、練習のためにいちばん力を入れた機能です。
まず、AI が会話ケースを3つ提案してくれます。最低1件は、家族か友人との場面になります。難易度は★1〜3(やさしい/ふつう/むずかしい)から選べます。
選んだケースでは、相手役の AI と実際に会話します。会話の途中で、相手の気持ちゲージが動きます。自分の一言で相手の気持ちが上がったり下がったりするのが見えるので、ゲーム感覚で続けられます。
【画像: 会話トレーニング中の画面(気持ちゲージ)】
会話が終わると、レビューが表示されます。次の5つの観点を、それぞれ0〜5で採点します。
- 相手を主役にできたか
- 質問の質
- 返答・受け止め
- 伝え方の具体性
- 押しつけの回避
合計は100点満点で、ランク(S〜C)とバッジも付きます。
発言ごとの振り返りもあります。相手の直前の発言と自分の発言を並べ、評価を緑・黄・橙の3色で示します。そのうえで、おすすめの返し方と、その理由も表示されます。



なお、合計点・ランク・バッジは AI に決めさせず、Python で計算しています。同じ採点結果なら同じ点数になるようにして、再現性を確保するためです。
使い方
セットアップは短い手順で済みます。
git clone https://github.com/Jun-kaneko/conversation-advisor.git
cd conversation-advisor
# 仮想環境を作って、依存パッケージをインストール
# 【要確認:requirements.txt を使った手順でよいか】
export ANTHROPIC_API_KEY="(自分のAPIキー)"
# 知識ベースを用意(次の節を参照)
streamlit run app.py
API の利用には、Anthropic の API キーが必要です。
ローカルで動かす個人用のツールなので、キーは自分の環境に置くだけで済みます。
知識ベースは自分で用意します
ここが、このツールの少し変わったところです。
私は会話術について学んだ内容を、個人用の知識ベースにまとめて使っています。ただ、その内容はリポジトリに同梱していません。
代わりに、knowledge.sample/ に形式のサンプルを置いています。読者のみなさんには、自分が学んだ会話術を自分の言葉でまとめて、knowledge/ に置いてもらう形です。
knowledge.sample/ について技術的な説明になってしまいますので、一番最後に補足的に説明します。
こうしたのは、特定の資料の内容をそのまま配布したくなかったからです。同時に、自分で要約する作業自体が、学びの定着に役立つと感じています。
作ってみて工夫した点・学んだこと
実際にありそうな場面で練習できる
「会話トレーニング」では、実際にありそうな場面を想定して練習できます。【要記入:実際に試した場面の例と、使ってみた感想】
おすすめの返信例も出力されるので、「自分ならこう言うけれど、こう言い換えると伝わり方が変わる」という比較ができます。
技術面で工夫したこと
技術に関心のある方向けに、ポイントを短くまとめます。
- 知識ベースは YAML で管理し、全量をシステムプロンプトに埋め込んでいます。
RAG(検索)は使っていません。知識の量が多くないので、全部渡したほうが精度が安定すると考えました。プロンプトキャッシュも利用しています。 - 出力は JSON で受け取り、pydantic で検証しています。 形式が崩れたときは、1回だけ再試行します。
- 助言のロジックと画面を分離しました。
advisor.pyとgame.pyが処理を担当し、Streamlit は表示だけを担当します。 - API キーなしで通るテストを用意しました。 手元で気軽に動作確認ができます。
注意点
使う前に、次の3点を知っておいてください。
1. 知識ベースは各自で用意するものです。
同梱していないので、そのままでは助言の質が出ません。自分で学んだ内容をまとめて置いてください。作った知識ベースは、公開・共有しないようお願いします。
2. 著作権への配慮をお願いします。
知識ベースに書く内容は、自分の言葉で要約したものにしてください。資料の文章をそのまま写すことは避けてください。
3. AI の助言は「一つの見方」です。
このツールの助言は、あくまで一つの考え方に基づいたものです。会話に正解は1つではありませんし、相手や状況によっても変わります。「このとおりにすれば必ず好かれる」というものではありません。参考にしつつ、最後は自分で判断してください。
また、このツールは個人利用のローカルアプリで、履歴は保存しません。入力した会話は、API を通じて AI に送られます。その点に注意して、機密性の高い内容は入力しないようにしてください。
おわりに
会話は、知識として知っているだけではなかなか変わりません。練習して、振り返って、少しずつ言葉の選び方が変わっていく。そのための道具として、このツールを作りました。【要記入:今後の使い方や、自分の変化への期待】
リポジトリは次のとおりです。ライセンスは MIT で、コードとプロンプトが対象です。
使ってみた感想や、「こんな機能があったら」という要望があれば、ぜひ教えてください。
Issue やコメントで、お気軽にどうぞ。
※ 本記事およびこのツールは、特定の出版物・出版社・著者とは一切関係がありません。
補足 : 「知識ベース」の用意のしかた(knowledge.sample/ について)
このツールは、AI が会話に助言するときの「ものさし」を、利用者自身が用意する仕組みです。ものさしの中身は、自分が学んだ会話術を、自分の言葉でまとめたメモです。リポジトリには、書き方の見本として knowledge.sample/ を入れてあります。
用意するもの
knowledge/ というフォルダに、次の4つのテキストファイル(YAML 形式)を置きます。
| ファイル | 書く内容 |
|---|---|
principles.yaml | 会話の基本的な考え方(例: 相手の話を最後まで聞く) |
seven_branches.yaml | やりがちな行動のパターンと、望ましい対応 |
rephrase_50.yaml | 場面別の「避けたい言い方」と「言い換え例」 |
speaking_style.yaml | 場面を問わない話し方の心がけ |
書き方の例
たとえば「依頼」の場面なら、次のように書きます。
categories:
- name: 依頼・お願い
items:
- {ng: "いつでもいいので", better: "来週水曜までにお願いできますか", point: "期限があるほうが相手は動きやすい"}
「避けたい言い方」「言い換え」「その理由」を、1組ずつ書くだけです。
始め方
knowledge.sample/をknowledge/という名前でコピーします。- 中身を、自分が学んだ内容に書き換えます。最初は1〜2件だけで構いません。
- 動作を確かめながら、少しずつ増やします。
注意点
- 内容は、必ず自分の言葉でまとめてください。本や記事の文章をそのまま写す必要はありません。
- 作った知識ベースは、個人で使う範囲にとどめ、公開や共有はしないでください。
- 書いた項目の名前は、そのまま助言の中で使われます。読み返して分かりやすい名前を付けておくと便利です。
補足2 : 「お試しの知識ベース」を入れたものを準備しました
実際にどのような動作になるのかイメージすメタルに「お試しの知識ベース」を入れたものを準備しました。
使用するに当たり、以下を注意してください
-「知識ベース」は公開していません。使用できるだけです。
– Anthropic APIのキーが必要です。内部ではキーは保存していません。チャット時に使用するだけです。
とはいっても信用できない方は使用しないほうが良いです。

END


コメント