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] (陳君厚老師,中研院統計所,推薦)
2. [email protected] (統計所其他「陳」)
3. 其他

你要哪一個?

怎麼找候選:

• 從 .claude/emails.md 的 participant_aliases 讀別名對應
• 從 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)

你要哪一個?

E5 — Mailbox Ambiguity

Examples: 「INBOX 的信」當有多個 accounts、「Drafts」當不確定哪個 account

Resolution pattern:

你有 {N} 個 mail accounts:
1. {account_1}
2. {account_2}
3. ...

「{mailbox}」要在哪一個 account 找?還是全部?

Disambiguation skip 條件

不需要 disambiguate(直接 execute):

• 明確 email 地址([email protected])
• 精確日期區間(2026-04-01 to 2026-04-30)
• Message-ID 直接指定
• 之前 session 已經 disambiguate 過同一個 term(且 user 沒改)

與 confirmation-protocol 的關係

E1-E5 是 confirmation-protocol 的 Phase 1(Disambiguation)。 完成 disambiguation 後進入 Phase 2(Search Preview),由 bulk-operation-preview skill 接手。

範例 dialogue

user: 把 jonathan 寄給我的信都歸檔

AI [E1 trigger]:
「jonathan」可能對應到:
1. [email protected] (Jonathan Tong,合作研究者)
2. [email protected] (其他)

你要哪一個?

user: 1

AI [E4 trigger - direction is "寄給我的" so direction is implicitly received, but let me double check via E3]:
「[email protected] 寄給我的信」我理解是:
- Direction: received only (不含我寄出去的)
- Mailbox: 預設 INBOX(若要包含其他 mailbox 例如 archived 請說)
- Time range: 全部歷史

確認嗎?

user: 對,但是要包含 archived 的

AI: [proceed to Phase 2 with refined filter]