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

这个页面有帮助吗?