跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

程式開發 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 金鑰的權限範圍、它的團隊角色,以及每個收件匣的傳送規則決定。

这个页面有帮助吗?