---
title: 编码 agent 的 skill
description: 安装 BillionSend skill，让 Claude Code 和 Codex 知道如何连接、处理收件箱，并把收到的邮件视为不可信内容。
ai:
  exclude: true
---

BillionSend skill 是一个 `SKILL.md` 文件，教编码 agent 如何使用 BillionSend：用 OAuth 或 agent 密钥连接 [MCP 服务器](/docs/zh-hans/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-hans/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-hans/agent-safety)。 |
| 发送 | 从已验证域名使用 `send_email` 和 `send_email_batch`，批量操作前先调用 `get_usage`，以及 REST API。 |

skill 不增加任何权限。agent 能做什么，仍然由它的 OAuth 授权或 agent 密钥的权限范围、它的[团队角色](/docs/zh-hans/team-roles)，以及每个收件箱的[发送规则](/docs/zh-hans/inboxes)决定。
