Support Inbox Agent

support-inbox-agent

一个 Claude Code 技能，用于初步处理客户支持收件箱：读取新对话、分类、针对真实问题检查错误跟踪器和代码库，然后在电子邮件客户端中撰写回复草稿，供人工审核和发送。

它绝不会发送任何内容。始终只创建草稿。

此技能取自我们在 SiteSpeak 自己的支持收件箱上运行的生产技能，每天早上 6am 执行。

阅读完整文章：使用 Claude Code 和 MCP 自动完成客户支持的初步处理

工作原理

一个 Markdown 文件（SKILL.md）描述了工作流。定时运行的 claude -p 会使用四个 MCP 服务执行该工作流：

角色	示例服务	用途
支持收件箱	SiteSpeak	列出对话串、读取对话、获取潜在客户、归档
错误跟踪器	Sentry	将 Bug 报告与真实的生产错误相匹配
应用监控工具（可选）	Nightwatch	同上，作为第二个来源
电子邮件客户端	Superhuman	搜索现有对话串、创建草稿

你可以将其中任何一个替换为自己的技术栈。该技能使用工具名称编写，不依赖供应商；工具名称占位符列在 SKILL.md 顶部。

每次运行：

1. 列出收件箱中未处理的对话串，保留自上次运行后有新活动的对话（JSON 状态文件可确保运行具有幂等性）
2. 读取访客自己发送的消息，并对对话串分类：紧急／潜在客户／无关内容
3. 撰写草稿前先调查：针对 Bug 报告检查错误跟踪器和相关代码，并根据文档核实操作指南中的答案
4. 在电子邮件中搜索来自该地址的现有对话串（用户在与机器人聊天后，可能几分钟内就会给支持团队发邮件），然后按情况跳过或在原对话串中回复
5. 在电子邮件客户端中创建草稿
6. 归档对话串，并在状态文件中记录处理结果
7. 总结：每个对话串一行，并附上草稿链接

两条重要规则

摘自 SKILL.md，值得原样保留：

绝不猜测。草稿中的每项说法都必须在本次会话中经过核实，否则就不要写入草稿。

绝不调用发送工具。始终只创建草稿。

第一条能避免在客户邮件中出现看似自信、实则荒谬的内容。第二条意味着，只有人工点击发送，回复才会到达客户。

要求

• Claude Code（或任何能够加载 MCP 服务和技能文件的 Agent 命令行工具）
• 带有 MCP 服务的支持工具
• 支持创建草稿的电子邮件客户端或电子邮件 API，且带有 MCP 服务
• 可选：用于调查步骤的错误跟踪器 MCP 服务
• 定时任务工具：launchd（macOS）或 cron（Linux）。示例见 examples/

快速开始（SiteSpeak）

SKILL.md 中的示例工具名称就是 SiteSpeak MCP 的实际名称，因此无需调整即可使用：

1. 在 Claude Code 中运行：/plugin marketplace add sitespeakai/sitespeak-claude-plugin
2. 然后运行：/plugin install sitespeak-chatbot-manager@sitespeak-plugins，并使用 API 令牌进行身份验证
3. 将 SKILL.md 复制到 ~/.claude/skills/support-inbox-agent/SKILL.md，并填写顶部的占位符（你的 chatbot id 位于仪表板 URL 中）
4. 连接电子邮件客户端的 MCP 服务，也可以连接错误跟踪器的 MCP 服务
5. 手动测试：claude -p "/support-inbox-agent"
6. 设置定时任务：参见 examples/run.sh 和 examples/launchd.plist

使用其他支持工具

只要支持 MCP 的工具能够列出对话串、读取对话、获取访客的电子邮件地址并归档对话串，就可以使用。按上述步骤复制 SKILL.md，然后将示例工具名称替换为相应供应商的名称，并填写相同的占位符。

无论采用哪种方式：先只进行分流（删除撰写草稿的步骤），查看一周的运行结果后，再允许它撰写草稿。以后也始终手动发送。

状态

state/processed.json 将访客 ID 映射到 { processed_at, action, reason?, draft_id? }。已创建草稿和已跳过的对话都会被记录，因此重新运行时不会重复处理，也不会重复创建草稿。如果访客在处理后再次发送消息，此技能会更新现有草稿，而不是再创建一份。

许可证

MIT