技能 slack-bot-builder
📦

slack-bot-builder

安全

使用 Bolt 框架建置 Slack 應用程式

建置 Slack 整合需要處理認證、事件和複雜的 UI 模式。此技能提供現成的 Python、JavaScript 和 Java Bolt 框架範本,可處理安全性、OAuth 流程和互動式 Block Kit 元件。

支援: Claude Codex Code(CC)
🥉 74 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「slack-bot-builder」。 使用者在機器人所在的頻道中發送訊息 'hello bot'

預期結果:

機器人回應個人化的問候:'Hey there @username!',透過使用者的 Slack 名稱識別該使用者

正在使用「slack-bot-builder」。 事件警報觸發,包含關鍵資料庫中斷詳細資訊

預期結果:

Slack 訊息顯示紅色圓圈標頭、顯示標題和嚴重性的事件欄位、截斷至 2000 字元的說明,以及用於確認、升級和解決的操作按鈕

正在使用「slack-bot-builder」。 使用者輸入 /ticket 命令並提交彈出視窗,標題為 'Login Issue',說明為 'Users cannot access portal',優先級為 'High'

預期結果:

確認訊息發布至頻道:'Ticket created: Login Issue (High Priority)',並附有唯一票務 ID 供追蹤

安全審計

安全
v1 • 2/25/2026

All static analysis findings are false positives. The SKILL.md file is documentation containing educational code examples for the Slack Bolt framework. Environment variable usage follows security best practices for credential handling. No executable code with security risks was detected.

1
已掃描檔案
269
分析行數
0
發現項
1
審計總數
未發現安全問題
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
91
規範符合性

你能建構什麼

DevOps 事件警報

建立 Slack 機器人,發布格式化的事件警報,包含嚴重性指示器和操作按鈕,可直接從 Slack 確認、升級或解決事件。

團隊通知機器人

建置機器人,為 CI/CD 流程、程式碼審查或部署狀態發送自動化通知,並帶有互動元素供團隊快速回應。

支援票務系統

實作 slash 命令和彈出視窗,用於在 Slack 內部建立、追蹤和更新支援票務,包含自訂欄位和指派工作流程。

試試這些提示

基本訊息處理器
建立一個 Python Bolt 應用程式,回應包含特定關鍵字的訊息。使用環境變數設定應用程式的權杖,為 'hello' 新增訊息監聽器,並包含一個 slash 命令來確認請求並發送後續訊息。
互動式按鈕元件
為事件通知建置帶有操作按鈕的 Block Kit 訊息。包含帶有嚴重性指示器的標頭、事件詳細資訊欄位,以及用於確認、升級和解決操作的按鈕。使用適當的回呼處理按鈕點擊事件。
彈出視窗表單收集
建立一個 slash 命令,開啟帶有輸入區塊的彈出視窗,用於票務標題、說明和優先級選擇。處理視圖提交以提取表單資料,並使用提交的值建立票務確認訊息。
OAuth 多工作區應用程式
設定帶有 OAuth 2.0 配置的 Bolt 應用程式,用於多工作區部署。實作基於資料庫的安裝儲存區以持久化權杖,最小化配置所需的 scopes,並新增 OAuth 重定向路由以處理安裝流程。

最佳實務

  • 請求最小所需的 OAuth scopes,以減少安裝期間的使用者摩擦並限制潛在的安全風險
  • 在 3 秒內使用 ack() 確認所有互動,然後非同步處理邏輯以避免超時錯誤
  • 將權杖和機密儲存在環境變數或安全保險庫中,切勿硬式編碼或記錄憑證值

避免

  • 將 Slack 權杖或簽章機密直接硬式編碼到原始碼中,而非使用環境變數
  • 「以防萬一」請求過多的 OAuth scopes,這會增加安全風險並降低安裝轉化率
  • 未確認即同步處理事件,導致 Slack 重試並產生重複事件

常見問題

我該如何建立新的 Slack 應用程式以使用此技能?
前往 https://api.slack.com/apps 並點擊 'Create New App'。選擇 'From scratch' 或 'From an app manifest'。建立後,導覽至 'OAuth & Permissions' 配置 scopes 並將應用程式安裝到您的工作區。
我在哪裡可以找到我的 Slack 簽章機密?
前往 api.slack.com/apps 的應用程式設定,從左側側邊欄選擇 'Basic Information',並找到 'App Credentials'。複製 'Signing Secret' 值並將其儲存在您的 SLACK_SIGNING_SECRET 環境變數中。
Bot 權杖和 User 權杖之間有什麼區別?
Bot 權杖 (xoxb-) 代表您的應用程式,具有您配置的 scopes。User 權杖 (xoxp-) 代表安裝您應用程式的個別使用者,並繼承其權限。大多數自動化場景建議使用 Bot 權杖。
我需要託管公開伺服器才能接收 Slack 事件嗎?
不需要。開發和測試時使用 Socket Mode,透過 WebSocket 接收事件而無需公開端點。生產環境中,HTTP 端點更可靠,但需要帶有 HTTPS 的公開可訪問伺服器。
我該如何在實作之前測試 Block Kit 版面配置?
使用 Block Kit Builder (app.slack.com/block-kit-builder) 以視覺化方式設計和預覽您的訊息版面配置。匯出 JSON 結構並將其整合到您的 Bolt 應用程式程式碼中。
如果我的應用程式超過 Slack API 速率限制會發生什麼情況?
Slack 會回傳 HTTP 429 和 Retry-After 標頭,指示等待的秒數。在您的應用程式中實作指數退避重試邏輯,並考慮批次操作或快取以減少 API 呼叫。

開發者詳情

檔案結構

📄 SKILL.md