程式開發 agent 的 skill
安裝 BillionSend skill,讓 Claude Code 與 Codex 知道如何連線、處理收件匣,並把收到的郵件視為不可信內容。
BillionSend skill 是一個 SKILL.md 檔案,教程式開發 agent 如何使用 BillionSend:以 OAuth 或 agent 金鑰連接 MCP 伺服器,找到收件匣,等待驗證碼與郵件,回覆,草擬待核准的郵件,收件匣規則把某次傳送暫扣為草稿時該怎麼辦,以及為什麼收到的郵件只是資料、絕不是指令。當任務提到 BillionSend、bs_ API 金鑰或 bs_agent_ 金鑰,或是提到要給 agent 一個郵件收件匣時,agent 就會載入它。
檔案位於 https://billionsend.com/docs/skills/billionsend/SKILL.md。它以英文撰寫,因為 agent 就是用英文讀它的。
安裝
每個 agent 都從以 skill 命名的資料夾(billionsend)裡讀取 skill,資料夾裡放著 SKILL.md。
mkdir -p ~/.claude/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.claude/skills/billionsend/SKILL.md這樣會為這台電腦上的每個專案安裝。如果想與某個儲存庫的團隊共享,就把它儲存為儲存庫裡的 .claude/skills/billionsend/SKILL.md 並提交。
mkdir -p ~/.agents/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.agents/skills/billionsend/SKILL.md這樣會為這台電腦上的每個專案安裝。如果想與某個儲存庫的團隊共享,就把它儲存為儲存庫根目錄下的 .agents/skills/billionsend/SKILL.md 並提交。
再執行一次指令即可更新 skill。安裝後請開啟新的工作階段,agent 才會載入它。
連接 MCP 伺服器
skill 告訴 agent 如何使用 BillionSend 的工具;agent 仍然需要連上伺服器。
claude mcp add --transport http billionsend https://api.billionsend.com/mcp然後在 Claude Code 裡執行 /mcp,選擇 billionsend 登入。你授予的權限見 MCP 伺服器。
在 MCP → 建立 Agent 金鑰下建立一把 agent 金鑰,並把伺服器加入 ~/.codex/config.toml:
[mcp_servers.billionsend]
url = "https://api.billionsend.com/mcp"
bearer_token_env_var = "BILLIONSEND_AGENT_KEY"啟動 Codex 之前,先在 shell 裡匯出 BILLIONSEND_AGENT_KEY。金鑰絕不寫進檔案。
skill 涵蓋什麼
| 部分 | 告訴 agent 什麼 |
|---|---|
| 連線 | MCP 端點、OAuth 與 agent 金鑰、agent 金鑰的三種權限範圍,以及一般的 bs_ 金鑰只能用於 REST API。 |
| 收件匣工作流程 | 先呼叫 list_inboxes(工具以收件匣 id 為參數),然後是 get_verification_code、wait_for_received_email、get_received_email、reply_to_received_email、send_from_inbox 與草稿工具。 |
| 被暫扣的傳送 | 帶有原因的 draft 表示規則正在發揮作用:如實回報,指向待審核分頁,絕不繞過。可能遇到的錯誤及其含義。 |
| 不可信郵件 | untrusted_data 封裝與 UNTRUSTED EMAIL CONTENT 圍欄、sender_trust 與 screening.verdict,以及絕不能因為郵件要求就去做的事。見 Agent 安全。 |
| 傳送 | 從已驗證網域使用 send_email 與 send_email_batch,批次操作前先呼叫 get_usage,以及 REST API。 |
skill 不會增加任何權限。agent 能做什麼,仍然由它的 OAuth 授權或 agent 金鑰的權限範圍、它的團隊角色,以及每個收件匣的傳送規則決定。