email-sender-policy send \
  --to "recipient@example.com" \
  --subject "報告" \
  --file "path/to/document.md"  # 自動轉換表格為清單

# 銷售報告

• AI助手：銷量 150，成長率 +25%
• 自動化工具：銷量 89，成長率 +12%

Email Sender Policy Skill

自動應用郵件發送標準政策，確保所有外發郵件符合格式規範。

📜 核心政策

1. 標題編碼政策

• - ✅ 強制使用 UTF-8 Base64 編碼（RFC 2047 格式）
• ✅ 格式：=?utf-8?b?{base64encodedtitle}?=
• ✅ 避免亂碼，確保所有郵件客戶端正確顯示

2. 內容格式政策

• - ✅ Markdown 表格一律轉為清單格式

- 表頭列 | 欄位1 | 欄位2 | → 轉為項目符號.開頭 - 分隔列 |-----|-----| → 移除 - 數據列 | 內容1 | 內容2 | → 轉為 • 內容2 層級

• - ✅ 保持純文字優先，不嵌入複雜格式
• ✅ 使用 \r\n 作為 RFC 822 行分隔符

3. 寄件人政策

• - ✅ 使用當前登入的 Gmail 連接
• ✅ 不自定義寄件人（除非另有授權）
• ✅ 從 Maton API Gateway 的 OAuth 會話取得有效連接

4. 多收件人政策

• - ✅ 支援多收件人同時寄送
• ✅ 格式：To: user1@example.com, user2@example.com
• ✅ 個別追蹤 Message ID

---

🛠 使用方法

基本發信

bash email-sender-policy send \ --to recipient@example.com \ --subject 你的主題 \ --body 郵件內容（支援清單、項目符號）

多收件人

bash email-sender-policy send \ --to user1@example.com, user2@example.com \ --subject 團隊通知 \ --body 內容...

檔案讀取

bash email-sender-policy send \ --to recipient@example.com \ --subject 報告 \ --file path/to/document.md # 自動轉換表格為清單

---

🔄 內部工作流程

1. 1. 接收參數（to, subject, body）
2. 預處理：

• 檢查 MATONAPIKEY 環境變數 • 載入當前有效的 Gmail 連接 • 轉換 Markdown 表格 → 清單（如需要）

1. 3. 建置 RFC 822 郵件：

• From: me (使用當前連接) • To: [收件人列表] • Subject: UTF-8 Base64 編碼 • Content-Type: text/plain; charset=UTF-8 • Content-Transfer-Encoding: 8bit

1. 4. Gmail API 發送：

• POST https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages/send • Headers: Authorization: Bearer $MATONAPIKEY • Body: { raw: base64url(message) }

1. 5. 回傳結果：

• Message ID • 發送狀態

---

📊 表格轉換規則示例

輸入（Markdown 表格）

markdown

景點	特色	預算
DDP屋頂	免費	KRW 0
樂天塔

高空步道 | KRW 27,000 |

輸出（清單格式）

• DDP屋頂：免費
• 樂天塔：高空步道 + KRW 27,000

轉換邏輯：

• - 每行資料轉為 • [第一欄]：[第二欄]（[第三欄]）
• 合併多欄位為單一行可讀句子
• 移除表格邊界字符（|、-）

---

🧩 與其他技能整合

此技能可作為底層政策被其他技能調用：

javascript
// marketing-drafter 產生內容後，自動應用政策發送
const email = await emailsenderpolicy({
to: [customer@example.com],
subject: 您的報告,
body: generated_content //自動處理表格編碼
});

---

⚙️ 配置

環境變數

變數	說明	強制性
MATONAPIKEY	Maton API 金鑰	✅ 必須
EMAILDEFAULTFROM

預設寄件人（可選） | ❌ 可選 |

連接管理

• - 使用 https://ctrl.maton.ai/connections 管理 OAuth 連接
• 自動選擇 status=ACTIVE 的 google-mail 連接
• 支援多個連接切換（未來擴展）

---

🎯 觸發說明

當用戶出現以下意圖時自動觸發：

• - 幫我寄信、send email
• 寄給...、發送郵件
• 調整標題編碼、避免亂碼
• 表格轉清單、格式轉換

---

📝 技能規範檢查清單

• - ✅ name 符合小寫+連字符
• ✅ description 完整說明
• ✅ version 語義化版本
• ✅ triggers 觸發關鍵字
• ✅ mode: subagent 子代理執行
• ✅ tags 標記正確
• ✅ 符合 AgentSkills v1.1 規範

---

🚀 安裝與發布

bash

開發中測試

cd ~/.openclaw/workspace/skills
clawhub link email-sender-policy # symbolic link

發布到 ClawHub

clawhub publish

---

📖 使用範例

案例 A：行銷電子報

bash email-sender-policy send \ --to subscriber@example.com \ --subject 本週新內容｜產品更新與行銷技巧 \ --body 📧 電子報內容...

本週新功能：
• 功能1：...
• 功能2：...

⭐ 行銷建議：...

案例 B：含表格的報告

markdown

銷售報告

產品	銷量	成長率
AI助手	150	+25%
自動化工具

89 | +12% |

→ 自動轉換為：

銷售報告

• AI助手：銷量 150，成長率 +25%
• 自動化工具：銷量 89，成長率 +12%

---

🐛 已知限制

• - ❌ 僅支援純文字內容，不支援 HTML
• ❌ 附件功能待實現（未來版本）
• ❌ 僅支援 Gmail 連接（未來擴展其他服務）
• ⚠️ 需先完成 Maton OAuth 授權

---

🔮 未來藍圖

• - [ ] 支援 HTML 郵件模板
• [ ] 附件上傳功能
• [ ] 多服務支援（Outlook、SendGrid）
• [ ] 郵件模板庫
• [ ] 發送統計追蹤
• [ ] 退訂管理（GDPR 合規）

📈 版本歷史

v2.0.1 (2026-03-17)

• - ✅ 修復參數別名問題：新增 --bodyFile 別名，與 --file 功能相同
• ✅ 提升易用性：支援不同命名字串，減少使用錯誤

v2.0.0 (2026-03-17)

• - ✅ 新增電子報格式排版：自動添加頭尾裝飾、分隔線
• ✅ 表格轉換優化：支援三欄位以上合併
• ✅ CLI 參數增強：--newsletter、--title 參數
• ✅ 完全重寫與文件更新

v1.0.0 (2026-03-16)

• - ✅ 初始版本
• ✅ UTF-8 Base64 標題編碼（RFC 2047）
• ✅ Markdown 表格轉清單
• ✅ RFC 822 標準郵件構建
• ✅ Gmail API 整合（Maton Gateway）

---

維護者：Shuttle AI 許可證：MIT ClawHub ID：k97cc6x99pbra5535jb0eb2269832z2v