编码 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 密钥的权限范围、它的团队角色,以及每个收件箱的发送规则决定。