前言¶
在 Outlook 裏做郵件分類,常見做法是打開設置界面,一條一條點「創建規則」。這樣做有兩個問題:一是手工操作無法版本化、無法批量,二是複雜條件(多個條件組合、多步操作)在界面裏容易配錯。對於需要批量初始化規則、把規則納入代碼管理的開發者來說,更直接的辦法是調用 Microsoft Graph API,直接對規則資源做增刪改查。
下面介紹的是一個面向這類需求的 Agent Skill:Outlook 規則自動化管理器。它把 Graph API 的 messageRules 端點包裝成可被 Agent 調用的能力,讓郵件規則的創建和管理以編程方式完成。
這是什麼¶
Outlook 規則自動化管理器是一個基於通用 SKILL.md 格式的社區 Skill,由 user_3c6cb52e 發佈並維護,在 SkillHub 上歸類爲 office-efficiency,版本 1.0.0。
它解決的問題是:Agent 需要幫用戶創建或修改 Outlook 收件箱規則時,不必手寫 Graph API 的請求體和鑑權邏輯,而是通過 Skill 定義的能力,以結構化方式描述規則條件與操作序列,由 Skill 完成調用。
核心功能¶
根據抓取到的簡介,該 Skill 的核心能力如下:
- 使用 Microsoft Graph API 的
/me/mailFolders/inbox/messageRules端點,以編程方式創建和管理 Outlook 郵件規則。 - 支持「操作序列」形式的複雜條件鏈,即一條規則裏可以包含多個條件和多個連續操作,用於實現自動郵件分類(如按發件人、主題、關鍵詞等條件把郵件移動到指定文件夾、標記或轉發)。
- 屬於「需要 API Key」類 Skill(標籤
requires_api_key=true),意味着使用時需要先準備好 Microsoft Graph 的訪問憑據。
安裝與啓用¶
需要說明的是:本文撰寫時,該 Skill 的官方頁面(https://api.skillhub.cn/user_3c6cb52e/outlook-rule-automation-manager 與 SkillHub 頁面 https://www.skillhub.cn/skills/user_3c6cb52e/outlook-rule-automation-manager)均無法正常訪問,抓取到的資料中也沒有包含安裝命令、目錄結構或配置字段。因此本節不給出具體安裝命令,以免編造。
從通用 SKILL.md 約定來看,這類 Skill 通常的啓用方式是:
1、在支持 Skill 的 Agent 客戶端(如 Cursor、Claude Code、Codex CLI 等)中,把 Skill 放入對應的 skills 目錄,或通過 SkillHub 頁面一鍵安裝。
2、配置 Microsoft Graph 訪問憑據。該 Skill 需要 API Key,因此使用前需先向 Microsoft 申請具有 Mail.ReadWrite 權限的 Azure AD 應用註冊,並把訪問令牌配置到 Skill 指定的位置。
3、在對話中明確告知 Agent 使用該 Skill,例如說明「幫我把來自某個域名的郵件自動移動到文件夾 X」。
以上第 1、3 步是 SKILL.md 通用約定的通行做法,第 2 步的權限名來自 Microsoft Graph 文檔;該 Skill 頁面本身未提供任何配置說明,實際配置項需以頁面恢復後或安裝包內的 SKILL.md 爲準。
典型用法¶
由於官方頁面無法訪問,本節的示例基於該 Skill 所調用的 Microsoft Graph API messageRules 端點公開文檔給出,用於說明該 Skill 背後的請求形態,而非該 Skill 自身的參數格式。
創建一條「來自某個發件人的郵件自動移動到指定文件夾」的規則,Graph API 的請求形如:
POST https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messageRules
Authorization: Bearer <access_token>
Content-Type: application/json
{
"displayName": "自動歸檔 domain.com 郵件",
"conditions": [
{
"senderContains": ["@domain.com"]
}
],
"actions": [
{
"moveToFolderId": "<目標文件夾ID>"
}
]
}
Skill 的價值在於:Agent 收到「以後 domain.com 的郵件都放到歸檔文件夾」這類自然語言需求時,可以自動生成上述結構(包括條件與操作序列),並完成鑑權和提交,而不是讓用戶去界面上手工點選。
適用場景與注意¶
適合:
- 需要批量初始化 Outlook 規則、把規則清單當作代碼資產維護的開發者或運維場景。
- Agent 類工具中需要「讀郵件並自動分類」的自動化流程,且規則條件較複雜(多條件、多操作)的場景。
注意:
- 該 Skill 是 community 來源、版本 1.0.0,使用前建議通讀其 SKILL.md,確認請求範圍和憑據管理方式。
- 抓取到的簡介提到支持「操作序列的複雜條件鏈」,具體條件字段和操作類型受 Graph API messageRules 模型限制,超出模型範圍的需求無法通過該端點實現。
- 規則創建在郵箱側即時生效,建議先用測試郵箱或測試文件夾驗證條件邏輯,避免誤分類正式郵件。
- 憑據方面,該 Skill 標記爲 requires_api_key,Graph API 使用 OAuth 2.0 訪問令牌,不要把令牌明文寫進代碼或提交到版本庫。
結尾¶
Outlook 規則自動化管理器的價值在於把「配規則」這件界面操作變成一次可復現、可版本化的 API 調用,並讓 Agent 能直接參與規則的創建與調整。它依賴 Microsoft Graph API 的 messageRules 端點,屬於有明確 API 邊界、有憑據要求的 Skill,用之前把鑑權和條件邏輯準備好即可。
官方地址:https://api.skillhub.cn/user_3c6cb52e/outlook-rule-automation-manager
SkillHub 頁面:https://www.skillhub.cn/skills/user_3c6cb52e/outlook-rule-automation-manager