Slack通知技能：通过AI代理实现高效Slack API集成与自动化消息管理

slack-notifications by oimiragieo/agent-studio

181 周安装量

23 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/oimiragieo/agent-studio --skill slack-notifications

团队协作自动化 API

🇨🇳中文介绍

Mode: Cognitive/Prompt-Driven — 无独立实用脚本；通过代理上下文使用。

Slack 通知技能

概述

此技能提供 Slack API 操作，采用渐进式披露以优化上下文使用。

上下文节省：约减少 90%

MCP 模式：始终加载约 15,000 个令牌（30+ 个工具）
技能模式：约 500 个令牌元数据 + 按需加载

要求

SLACK_BOT_TOKEN 环境变量（必需）
SLACK_SIGNING_SECRET 环境变量（可选，用于事件验证）
SLACK_APP_TOKEN 环境变量（可选，用于 Socket 模式）

设置 Slack 机器人令牌

在 https://api.slack.com/apps 创建 Slack 应用
导航至 "OAuth & Permissions"
添加所需的机器人令牌权限范围：
- chat:write - 发送消息
- channels:read - 列出频道
- channels:history - 读取频道历史记录

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

类别	工具	需要确认
消息	post-message, post-thread, update-message, delete-message	是（全部）
频道	list-channels, get-channel, channel-history	否
用户	list-users, get-user, user-presence	否
文件	upload-file, list-files	是（仅上传）
反应	add-reaction, get-reactions	否

消息工具（需要确认）

向 Slack 频道发送消息。

channel（必需）：频道 ID 或名称（例如 "C1234567890" 或 "#general"）
text（必需）：消息文本（支持 Slack markdown）
thread_ts（可选）：用于线程化的父消息时间戳
blocks（可选）：富消息块（JSON 数组）

curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "text": "Deployment successful!",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Deployment Status*\n:white_check_mark: Production deployed successfully"
        }
      }
    ]
  }'

在主题中回复消息。

channel（必需）：频道 ID
thread_ts（必需）：父消息时间戳
text（必需）：回复文本

curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "thread_ts": "1234567890.123456",
    "text": "Thread reply here"
  }'

更新现有消息。

channel（必需）：频道 ID
ts（必需）：消息时间戳
text（必需）：新消息文本

curl -X POST https://slack.com/api/chat.update \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "ts": "1234567890.123456",
    "text": "Updated message"
  }'

channel（必需）：频道 ID
ts（必需）：消息时间戳

curl -X POST https://slack.com/api/chat.delete \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "ts": "1234567890.123456"
  }'

列出工作区中的所有频道。

types（可选）：逗号分隔的频道类型（默认："public_channel"）
- 选项："public_channel", "private_channel", "mpim", "im"
limit（可选）：返回的最大频道数（默认：100）

curl -X GET "https://slack.com/api/conversations.list?types=public_channel,private_channel" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

获取频道信息。

channel（必需）：频道 ID

curl -X GET "https://slack.com/api/conversations.info?channel=C1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

获取频道消息历史记录。

channel（必需）：频道 ID
limit（可选）：返回的最大消息数（默认：100）
oldest（可选）：时间范围的开始（Unix 时间戳）
latest（可选）：时间范围的结束（Unix 时间戳）

curl -X GET "https://slack.com/api/conversations.history?channel=C1234567890&limit=50" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

安全注意事项：频道历史记录可能包含敏感信息。请谨慎使用。

列出工作区中的所有用户。

limit（可选）：返回的最大用户数（默认：100）

curl -X GET "https://slack.com/api/users.list" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

获取用户个人资料信息。

user（必需）：用户 ID

curl -X GET "https://slack.com/api/users.info?user=U1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

获取用户在线状态。

user（必需）：用户 ID

curl -X GET "https://slack.com/api/users.getPresence?user=U1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

upload-file（需要确认）

上传文件到 Slack 频道。

channels（必需）：逗号分隔的频道 ID
file（必需）：要上传的文件路径
title（可选）：文件标题
initial_comment（可选）：消息文本

curl -X POST https://slack.com/api/files.upload \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -F "channels=C1234567890" \
  -F "file=@C:\reports\weekly.pdf" \
  -F "title=Weekly Report" \
  -F "initial_comment=Here is this week's report"

列出频道中的文件。

channel（可选）：用于筛选的频道 ID
user（可选）：用于筛选的用户 ID
count（可选）：返回的最大文件数（默认：100）

curl -X GET "https://slack.com/api/files.list?channel=C1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

向消息添加表情符号反应。

channel（必需）：频道 ID
timestamp（必需）：消息时间戳
name（必需）：表情符号名称（不带冒号，例如 "thumbsup"）

curl -X POST https://slack.com/api/reactions.add \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "timestamp": "1234567890.123456",
    "name": "thumbsup"
  }'

获取消息上的反应。

channel（必需）：频道 ID
timestamp（必需）：消息时间戳

curl -X GET "https://slack.com/api/reactions.get?channel=C1234567890&timestamp=1234567890.123456" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

devops：基础设施警报、部署通知、监控
incident-responder：事件警报、状态更新、升级

pm：冲刺通知、里程碑更新、团队公告
developer：构建通知、PR 警报、测试结果
qa：测试失败警报、质量报告
security-architect：安全警报、漏洞通知

# 通知频道部署成功
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#deployments",
    "text": ":rocket: Production deployment completed",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Production Deployment*\n:white_check_mark: v1.2.3 deployed successfully\n*Duration:* 5m 23s"
        }
      }
    ]
  }'

# 向值班团队发出事件警报
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#incidents",
    "text": "<!channel> :rotating_light: High severity incident detected",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Incident INC-1234*\n:rotating_light: *Severity:* P1\n*Service:* API Gateway\n*Status:* 503 errors increasing"
        }
      }
    ]
  }'

# 发布测试结果
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#qa",
    "text": "Test suite completed",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Test Results*\n:white_check_mark: 245 passed\n:x: 3 failed\n:warning: 2 skipped"
        }
      }
    ]
  }'

切勿在日志或错误消息中暴露机器人令牌
将令牌存储在环境变量中，而非代码中
为机器人令牌使用最小权限范围
定期轮换令牌

所有消息操作都需要确认
频道历史记录可能包含敏感信息（PII、凭据等）
发布前验证频道权限
对于敏感通信使用私密频道

遵守工作区数据保留策略
避免在消息中发布 PII 或凭据
使用 Slack 的数据导出功能以满足合规要求
尊重用户隐私和在线状态

错误	原因	解决方案
`not_authed`	缺少或无效的令牌	检查 `SLACK_BOT_TOKEN` 是否正确设置
`channel_not_found`	无效的频道 ID	使用 `list-channels` 验证频道 ID
`missing_scope`	机器人缺少所需权限	在 Slack 应用设置中添加范围
`rate_limited`	请求过多	实现指数退避
`message_not_found`	无效的时间戳	检查消息时间戳是否正确

对于速率限制错误，实现指数退避：

等待 1 秒，重试
等待 2 秒，重试
等待 4 秒，重试
等待 8 秒，重试
5 次尝试后放弃

Slack API 速率限制：

层级 1：每秒 1 个请求
层级 2：每分钟 20 个请求
层级 3：每分钟 50 个请求
层级 4：每分钟 100 个请求

按层级划分的方法：

chat.postMessage：层级 3（50/分钟）
conversations.list：层级 2（20/分钟）
users.list：层级 2（20/分钟）
files.upload：层级 4（100/分钟）

Slack API 文档：https://api.slack.com/docs
Block Kit 构建器：https://app.slack.com/block-kit-builder
Slack 应用管理：https://api.slack.com/apps

记忆协议（强制）

开始前： 阅读 .claude/context/memory/learnings.md

新模式 -> .claude/context/memory/learnings.md
发现的问题 -> .claude/context/memory/issues.md
做出的决策 -> .claude/context/memory/decisions.md

假设中断：如果不在记忆中，则未发生。

🇺🇸English

Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.

Slack Notifications Skill

Overview

This skill provides Slack API operations with progressive disclosure for optimal context usage.

Context Savings : ~90% reduction

MCP Mode : ~15,000 tokens always loaded (30+ tools)
Skill Mode : ~500 tokens metadata + on-demand loading

Requirements

SLACK_BOT_TOKEN environment variable (required)
SLACK_SIGNING_SECRET environment variable (optional, for event verification)
SLACK_APP_TOKEN environment variable (optional, for Socket Mode)

Setting up Slack Bot Token

Create a Slack App at https://api.slack.com/apps
Navigate to "OAuth & Permissions"
Add required bot token scopes:
- chat:write - Send messages
- channels:read - List channels
- channels:history - Read channel history
- users:read - List users
- files:write - Upload files
- reactions:write - Add reactions
Install app to workspace
Copy "Bot User OAuth Token" to SLACK_BOT_TOKEN environment variable

Tools

The skill provides 14 tools across 5 categories:

Category	Tools	Confirmation Required
Messaging	post-message, post-thread, update-message, delete-message	Yes (all)
Channels	list-channels, get-channel, channel-history	No
Users	list-users, get-user, user-presence	No
Files	upload-file, list-files	Yes (upload only)
Reactions	add-reaction, get-reactions	No

Quick Reference

# Post message to channel
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "C1234567890", "text": "Hello from Claude!"}'

# List channels
curl -X GET "https://slack.com/api/conversations.list" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

# Upload file
curl -X POST https://slack.com/api/files.upload \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -F "channels=C1234567890" \
  -F "file=@report.pdf" \
  -F "title=Weekly Report"

Tool Details

Messaging Tools (Confirmation Required)

post-message

Send a message to a Slack channel.

Parameters :

channel (required): Channel ID or name (e.g., "C1234567890" or "#general")
text (required): Message text (supports Slack markdown)
thread_ts (optional): Parent message timestamp for threading
blocks (optional): Rich message blocks (JSON array)

Example :

curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "text": "Deployment successful!",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Deployment Status*\n:white_check_mark: Production deployed successfully"
        }
      }
    ]
  }'

post-thread

Reply to a message in a thread.

Parameters :

channel (required): Channel ID
thread_ts (required): Parent message timestamp
text (required): Reply text

Example :

curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "thread_ts": "1234567890.123456",
    "text": "Thread reply here"
  }'

update-message

Update an existing message.

Parameters :

channel (required): Channel ID
ts (required): Message timestamp
text (required): New message text

Example :

curl -X POST https://slack.com/api/chat.update \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "ts": "1234567890.123456",
    "text": "Updated message"
  }'

delete-message

Delete a message.

Parameters :

channel (required): Channel ID
ts (required): Message timestamp

Example :

curl -X POST https://slack.com/api/chat.delete \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "ts": "1234567890.123456"
  }'

Channel Tools

list-channels

List all channels in workspace.

Parameters :

types (optional): Comma-separated channel types (default: "public_channel")
- Options: "public_channel", "private_channel", "mpim", "im"
limit (optional): Max channels to return (default: 100)

Example :

curl -X GET "https://slack.com/api/conversations.list?types=public_channel,private_channel" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

get-channel

Get channel information.

Parameters :

channel (required): Channel ID

Example :

curl -X GET "https://slack.com/api/conversations.info?channel=C1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

channel-history

Get channel message history.

Parameters :

channel (required): Channel ID
limit (optional): Max messages to return (default: 100)
oldest (optional): Start of time range (Unix timestamp)
latest (optional): End of time range (Unix timestamp)

Example :

curl -X GET "https://slack.com/api/conversations.history?channel=C1234567890&limit=50" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

Security Note : Channel history may contain sensitive information. Use with caution.

File Tools

upload-file (Confirmation Required)

Upload a file to Slack channel.

Parameters :

channels (required): Comma-separated channel IDs
file (required): File path to upload
title (optional): File title
initial_comment (optional): Message text

Example :

curl -X POST https://slack.com/api/files.upload \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -F "channels=C1234567890" \
  -F "file=@C:\reports\weekly.pdf" \
  -F "title=Weekly Report" \
  -F "initial_comment=Here is this week's report"

list-files

List files in channel.

Parameters :

channel (optional): Channel ID to filter by
user (optional): User ID to filter by
count (optional): Max files to return (default: 100)

Example :

curl -X GET "https://slack.com/api/files.list?channel=C1234567890" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

Reaction Tools

add-reaction

Add emoji reaction to a message.

Parameters :

channel (required): Channel ID
timestamp (required): Message timestamp
name (required): Emoji name (without colons, e.g., "thumbsup")

Example :

curl -X POST https://slack.com/api/reactions.add \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "C1234567890",
    "timestamp": "1234567890.123456",
    "name": "thumbsup"
  }'

get-reactions

Get reactions on a message.

Parameters :

channel (required): Channel ID
timestamp (required): Message timestamp

Example :

curl -X GET "https://slack.com/api/reactions.get?channel=C1234567890&timestamp=1234567890.123456" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

Agent Integration

Primary Agents

devops : Infrastructure alerts, deployment notifications, monitoring
incident-responder : Incident alerts, status updates, escalations

Secondary Agents

pm : Sprint notifications, milestone updates, team announcements
developer : Build notifications, PR alerts, test results
qa : Test failure alerts, quality reports
security-architect : Security alerts, vulnerability notifications

Common Use Cases

Deployment Notifications

# Notify channel of successful deployment
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#deployments",
    "text": ":rocket: Production deployment completed",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Production Deployment*\n:white_check_mark: v1.2.3 deployed successfully\n*Duration:* 5m 23s"
        }
      }
    ]
  }'

Incident Alerts

# Alert on-call team of incident
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#incidents",
    "text": "<!channel> :rotating_light: High severity incident detected",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Incident INC-1234*\n:rotating_light: *Severity:* P1\n*Service:* API Gateway\n*Status:* 503 errors increasing"
        }
      }
    ]
  }'

Test Results

# Post test results
curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "#qa",
    "text": "Test suite completed",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Test Results*\n:white_check_mark: 245 passed\n:x: 3 failed\n:warning: 2 skipped"
        }
      }
    ]
  }'

Security Considerations

Token Security

NEVER expose bot token in logs or error messages
Store token in environment variable, not in code
Use least-privilege scopes for bot token
Rotate tokens periodically

Message Security

All message operations require confirmation
Channel history may contain sensitive information (PII, credentials, etc.)
Validate channel permissions before posting
Use private channels for sensitive communications

Data Privacy

Comply with workspace data retention policies
Avoid posting PII or credentials in messages
Use Slack's data export features for compliance
Respect user privacy and online status

Error Handling

Common Errors

Error	Cause	Solution
`not_authed`	Missing or invalid token	Check `SLACK_BOT_TOKEN` is set correctly
`channel_not_found`	Invalid channel ID	Verify channel ID with `list-channels`
`missing_scope`	Bot lacks required permission	Add scope in Slack App settings
`rate_limited`	Too many requests

Retry Strategy

For rate limiting errors, implement exponential backoff:

Wait 1 second, retry
Wait 2 seconds, retry
Wait 4 seconds, retry
Wait 8 seconds, retry
Give up after 5 attempts

Rate Limits

Slack API rate limits:

Tier 1 : 1 request per second
Tier 2 : 20 requests per minute
Tier 3 : 50 requests per minute
Tier 4 : 100 requests per minute

Methods by tier:

chat.postMessage: Tier 3 (50/min)
conversations.list: Tier 2 (20/min)
users.list: Tier 2 (20/min)
files.upload: Tier 4 (100/min)

Slack API Documentation: https://api.slack.com/docs
Block Kit Builder: https://app.slack.com/block-kit-builder
Slack App Management: https://api.slack.com/apps

Memory Protocol (MANDATORY)

Before starting: Read .claude/context/memory/learnings.md

After completing:

New pattern -> .claude/context/memory/learnings.md
Issue found -> .claude/context/memory/issues.md
Decision made -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.

Weekly Installs

116

Repository

oimiragieo/agent-studio

GitHub Stars

First Seen

Jan 27, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykFail

Installed on

github-copilot114

codex113

gemini-cli113

cursor113

opencode113

kimi-cli112

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

44,900 周安装

Slack通知技能：通过AI代理实现高效Slack API集成与自动化消息管理

🇨🇳中文介绍

Slack 通知技能

概述

要求

设置 Slack 机器人令牌

相关 Skills

工具

快速参考

工具详情

消息工具（需要确认）

post-message

post-thread

update-message

delete-message

频道工具

list-channels

get-channel

channel-history

用户工具

list-users

get-user

user-presence

文件工具

upload-file（需要确认）

list-files

反应工具

add-reaction

get-reactions

代理集成

主要代理

次要代理

常见用例

部署通知

事件警报

测试结果

安全注意事项

令牌安全

消息安全

数据隐私

错误处理

常见错误

重试策略

速率限制

相关

记忆协议（强制）

🇺🇸English

Slack Notifications Skill

Overview

Requirements

Setting up Slack Bot Token

Tools

Quick Reference

Tool Details

Messaging Tools (Confirmation Required)

post-message

post-thread

update-message

delete-message

Channel Tools

list-channels

get-channel

channel-history

User Tools

list-users

get-user

user-presence

File Tools

upload-file (Confirmation Required)

list-files

Reaction Tools

add-reaction

get-reactions

Agent Integration

Primary Agents

Secondary Agents

Common Use Cases

Deployment Notifications

Incident Alerts

Test Results