
プロジェクトエディターエージェントを作ろう! vol.2 〜ステークホルダー管理〜
前回の記事
プロジェクトを振り返るとき、「誰が何をしてたか」を横断的に見える化したい場面はいくつもあります。
月次レポートで「今月一番コミットしたのは誰?」
ユーザー対応で「この件、過去に同じ話を誰かとしてなかったっけ?」
新メンバー合流時に「このプロジェクトでメンバーごとの活動は?」
ところが実データは 1 人の呼び方が何通りもある 問題に直面します。
たとえば同じ人が:
Slack では 「Aさん」 と呼ばれ
GitHub では 「a-handle」 というユーザー名
メールアドレスは 「a@example.com」
社内の議事録には 「A太郎」 とフルネーム
後輩からは 「Aパイセン」
ぜんぶ同じ人。でも素直に AI で抽出するだけだと 5 人の別人として登録されてしまって、「Aさん関連のプロジェクト履歴」を引くと 1/5 しか出てきま
せん。
解決の方向性
イメージは ステークホルダーの名寄せです。
「テキスト中で呼び名」 が来たら、システムが 次のステップで「本人かどうか」を確認します。
社員証の ID チェック(Slack ID や GitHub アカウント名が登録済み?)
名前の完全一致(敬称を外した形が登録済みの呼び方と一致する?)
呼び名が似てる?(意味の近さで判定)
それでも分からなければ AI に相談(「これは同じ人ですか?」と確認)
確信度の高い順に試して、どれかで一致したら「その人の本名カード」に紐付けます。全部空振りしたら「保留トレイ」に置いて、人間に「これ誰だっけ?」と判断してもらいます。
仕組みは データベースで
その人の本名カード(canonical): Aさんの正式名、メール、ステータス
呼び方バリエーション(alias): Aさん / A太郎 / a-handle / Aパイセン ...
会員番号(external_id): Slack / GitHub / メールアドレス
を管理します。
ステークホルダー登録の流れ
テキスト取り込み:Slack / GitHub / 議事録から LLM で Person / Organization などを抽出する
4 段階で名寄せ:platform ID 完全一致 → 正規化文字列一致 → trgm + embedding 類似度 → LLM 判定(opt-in)の順で試す
解決できたら書き込み:canonical_name と stakeholder_id を確定して、グラフに Person ノードを登録する
解決できなければ保留:pending_mention に呼び方と候補を退避し、関係エッジは deferred_relation に退避する(仮 ID で先に書かない)
人手レビュー:運用者が CLI で accept / create-from-pending / reject を選び、監査ログに判断を残す
遅延 MERGE:pending 解決後に deferred_relation を再適用し、両端の Person が揃ってから関係エッジを書く

ステークホルダー登録の流れ
ステークホルダーの名寄せをしておくと名前からアカウントIDで問い合わせができるようになります。

プロジェクトの活動履歴を横断的に検索するためには、ステークホルダーのリストだけでなく呼び名やIDの紐付けまで行う必要があります。上手な情報の紐付けがプロジェクトエディターエージェントの重要なポイントのひとつではないでしょうか。