技能包

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 說明沒有保證其它託管平台能直接套用。