---
title: 程式開發 agent 的 skill
description: 安裝 BillionSend skill，讓 Claude Code 與 Codex 知道如何連線、處理收件匣，並把收到的郵件視為不可信內容。
ai:
  exclude: true
---

BillionSend skill 是一個 `SKILL.md` 檔案，教程式開發 agent 如何使用 BillionSend：以 OAuth 或 agent 金鑰連接 [MCP 伺服器](/docs/zh-hant/mcp)，找到收件匣，等待驗證碼與郵件，回覆，草擬待核准的郵件，收件匣規則把某次傳送暫扣為草稿時該怎麼辦，以及為什麼收到的郵件只是資料、絕不是指令。當任務提到 BillionSend、`bs_` API 金鑰或 `bs_agent_` 金鑰，或是提到要給 agent 一個郵件收件匣時，agent 就會載入它。

檔案位於 `https://billionsend.com/docs/skills/billionsend/SKILL.md`。它以英文撰寫，因為 agent 就是用英文讀它的。

## 安裝

每個 agent 都從以 skill 命名的資料夾（`billionsend`）裡讀取 skill，資料夾裡放著 `SKILL.md`。

**Claude Code**

```sh
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` 並提交。

**Codex**

```sh
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 Code**

```sh
claude mcp add --transport http billionsend https://api.billionsend.com/mcp
```

然後在 Claude Code 裡執行 `/mcp`，選擇 `billionsend` 登入。你授予的權限見 [MCP 伺服器](/docs/zh-hant/mcp)。

**Codex**

在 **MCP → 建立 Agent 金鑰**下建立一把 agent 金鑰，並把伺服器加入 `~/.codex/config.toml`：

```toml title="~/.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 安全](/docs/zh-hant/agent-safety)。 |
| 傳送 | 從已驗證網域使用 `send_email` 與 `send_email_batch`，批次操作前先呼叫 `get_usage`，以及 REST API。 |

skill 不會增加任何權限。agent 能做什麼，仍然由它的 OAuth 授權或 agent 金鑰的權限範圍、它的[團隊角色](/docs/zh-hant/team-roles)，以及每個收件匣的[傳送規則](/docs/zh-hant/inboxes)決定。
