メインコンテンツへスキップ
見出し画像

プロジェクトエディターエージェントを作ろう! vol.2 〜ステークホルダー管理〜

    前回の記事

    プロジェクトを振り返るとき、「誰が何をしてたか」を横断的に見える化したい場面はいくつもあります。

    • 月次レポートで「今月一番コミットしたのは誰?」

    • ユーザー対応で「この件、過去に同じ話を誰かとしてなかったっけ?」

    • 新メンバー合流時に「このプロジェクトでメンバーごとの活動は?」

    ところが実データは 1 人の呼び方が何通りもある 問題に直面します。

    たとえば同じ人が:

    • Slack では 「Aさん」 と呼ばれ

    • GitHub では 「a-handle」 というユーザー名

    • メールアドレスは 「a@example.com」

    • 社内の議事録には 「A太郎」 とフルネーム

    • 後輩からは 「Aパイセン」

    ぜんぶ同じ人。でも素直に AI で抽出するだけだと 5 人の別人として登録されてしまって、「Aさん関連のプロジェクト履歴」を引くと 1/5 しか出てきま
    せん。

    解決の方向性

    イメージは ステークホルダーの名寄せです。

    「テキスト中で呼び名」 が来たら、システムが 次のステップで「本人かどうか」を確認します。

    1. 社員証の ID チェック(Slack ID や GitHub アカウント名が登録済み?)

    2. 名前の完全一致(敬称を外した形が登録済みの呼び方と一致する?)

    3. 呼び名が似てる?(意味の近さで判定)

    4. それでも分からなければ 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で問い合わせができるようになります。

    画像
    名前からGitHub IDに変換

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

    次の記事


     
     

    Dyson

     
     
    通信系企業で働くシステムエンジニア 生成AIなどを使ってプ譜の価値探究にチャレンジする自称プ譜デベロッパー プロジェクトマネジメント / 構造主義 / Web開発 / AWS

    あなたへのおすすめ