email-search-disambiguation

Email Search Disambiguation

借鑑 nsql 的 disambiguation triggers,adapt 到 email search 領域。

Triggers

E1 — Vague Contact Reference

Examples:

• 中文人名:「陳老師」、「王教授」、「林助理」
• 角色稱呼:「老闆」、「主管」、「指導教授」、「客戶」
• 公司/組織:「中研院的人」、「stat.sinica 的信」

Resolution pattern:

「{contact}」可能對應到:
1. {email_1} ({description_1},推薦)
2. {email_2} ({description_2})
3. 其他({user 補充})

你要哪一個?

範例:

「陳老師」可能對應到:
1. [email protected] [workspace][推薦] "陳老師（研究所）"
2. [email protected] [thread] "同單位的另一位陳"
3. 其他

你要哪一個?

怎麼找候選:

• 在 archive-mail 內，使用 Step 1.4 已解析的 EFFECTIVE_PARTICIPANT_ALIASES：全域 ~/.claude/.mail/identity.yaml 為基底，workspace ${CONFIG_FILE} 的 aliases 原樣補充未涵蓋的地址；重複鍵以全域為準並留待報告具名揭露。
• 獨立使用本 skill 時（不在 archive-mail 內），workspace config 取目前目錄的 .claude/.mail/config.yaml（不存在即空），不執行 archive-mail Step 1.6 的 legacy 遷移，其餘依 commands/archive-mail.md Step 1.4 的同一規則（缺檔靜默、格式錯誤警告、只為比對做正規化、衝突揭露）。不回頭讀 .claude/emails.md，也不建立另一套覆寫優先序。
• email → 顯示名稱只能提供候選；顯示名稱命中多個 email 時逐一列出，保留 email 讓使用者選擇，不自動改 filter 或略過確認。每個候選標示來源（identity／workspace／thread），來源與「推薦」由 agent 放在固定位置，不取自顯示名稱；顯示名稱去掉換行與控制字元、截斷到 64 個字元並加引號。只來自全域 identity 的候選不得標「推薦」；identity 與 workspace 以同一顯示名稱指向不同地址時，這些候選都不標「推薦」。使用者以 --no-confirm／「直接做」跳過確認時，若全域 identity 把模糊人名對到的地址不在本 workspace 的 aliases 與 thread participants，仍列候選；其餘照舊跳過（規則同 commands/archive-mail.md Step 1.5）。
• 從 contacts 或之前 archive 的 thread participants 找匹配
• 如果完全找不到,問 user「我找不到匹配的 contact,你能給我 email 地址嗎?」

E2 — Vague Time Reference

Examples: 「最近」、「上週」、「這個月」、「之前」、「半年內」

Resolution pattern:

「{term}」可以有不同解釋:
1. 過去 7 天 (今天 - 7d)
2. 上一個完整週/月
3. 自從某事件 (例如:上次 archive 之後)

你指的是哪一個?

E3 — Vague Scope

Examples: 「全部」、「所有」、「都」、「整個 thread」

Resolution pattern:

「全部」可能指:
1. 符合 filter 的 emails (用 search criteria 限縮)
2. 整個 mailbox 的 emails (沒有 filter)
3. 過去 N 天/月的 emails (時間限縮)

範圍多大?

E4 — Ambiguous Operation Direction

Examples:

• 「寄給陳老師的信」← 我寄出?還是收到?
• 「跟陳老師往來的信」← 雙向

Resolution pattern:

「{phrase}」可能指:
1. 我寄出去給 {contact} 的(Sent direction)
2. {contact} 寄給我的(Received direction)
3. 雙向(整個 thread)

你要哪一個?