技能包

Slack Agent Skill:用 eve 在 Vercel 上搭 Slack 代理

适合要在 Vercel 上部署 Slack 代理的人,须用官方 npx skills add vercel-labs/slack-agent-skill 安装,且 Slack 事件要等部署后才通过 Connect 验证。

官方来源 · slack-agent-skill

安装

npx skills add vercel-labs/slack-agent-skill

适合谁

这份技能面向要在 Vercel 上构建并部署 Slack 代理的人。它配合 eve(Vercel 的持久代理框架)和 Vercel Connect(托管 Slack 凭证)。eve 文档在 https://eve.dev/docs Connect 说明在 https://vercel.com/kb/guide/vercel-connect 仓库强调:不必自己经手 bot token 或签名密钥。

更贴的用法是:你准备用 /slack-agent 建新项目或给已有项目做配置,本地先在 eve dev 文本界面里测工具、指令和对话,把 Slack 事件留到部署之后。它不适合还想自己保管 Slack 签名密钥、或指望不部署就能在 Slack 界面点完所有事件的人。

没有 skill 支持的环境,不要套用这条安装命令。也不要把 ngrok 隧道当成必需步骤:说明写明 Slack 事件经 Connect 转到已部署项目,不需要 ngrok。

3 分钟完成第一次尝试

官方安装命令是:npx skills add vercel-labs/slack-agent-skill。仓库地址是 https://github.com/vercel-labs/slack-agent-skill 请只按这一页操作。不要编写未记载的安装器。

前置条件:当前助手支持 skill,并且你有一个可丢弃的空目录或已有 eve 项目。安装位置是助手的技能目录。装完后确认能看到 /slack-agent new、/slack-agent configure、/slack-agent deploy、/slack-agent test。

低风险第一次任务:不要先部署。若从零开始,先运行 /slack-agent new(用 eve 搭脚手架),但在写入文件前先确认目录是练习用。若已有项目,用 /slack-agent configure(会自动检测 eve)。成功信号是脚手架或配置完成,且你还没有执行 /slack-agent deploy。

本地验证走 eve dev 的 TUI:测工具、指令和对话。Slack 界面上的事件要等部署后,经 Vercel Connect 到达项目。Slack 侧环境变量说明里只提到 SLACK_CONNECTOR,不要再编造其它密钥占位。/slack-agent test 用于设置测试,等本地对话跑通再考虑。

使用案例

案例一:从零脚手架。/slack-agent new 会用 eve 搭一个新项目。适合你还没有仓库、只想先在本地看到代理结构的时候。说明没有列出生成的文件清单,因此只能做到“命令成功并出现 eve 项目”。写入前确认目录。对照页是 https://github.com/vercel-labs/slack-agent-skill

案例二:给已有项目配置并分开本地/线上验证。/slack-agent configure 自动检测 eve。本地用 eve dev 测工具、指令和对话;Slack 事件在部署后经 Connect 到达,不需要 ngrok。/slack-agent deploy 部署到生产环境,应放在本地 TUI 通过之后。Connect 负责托管 OAuth、令牌轮换和 webhook 校验,唯一点名的 Slack 环境变量是 SLACK_CONNECTOR。说明没有写该变量的填值步骤,也没有写生产回滚;未完成 Connect 配置前不要部署。

使用边界

安装边界:官方只写了 npx skills add vercel-labs/slack-agent-skill。命令边界:能核对到 /slack-agent new、configure、deploy、test。凭证边界:不必自己处理 bot token 或签名密钥;Slack 环境变量只点名 SLACK_CONNECTOR。测试边界:本地 TUI 测工具、指令和对话;Slack 事件在部署后经 Connect 验证,不需要 ngrok。框架边界:eve 与 Vercel Connect 是写明的依赖,文档分别在 https://eve.dev/docs 与 https://vercel.com/kb/guide/vercel-connect 说明没有保证其它托管平台能直接套用。