SuperAPI AI 工具集

slack

办公与效率

查看项目

更新于 10-15 22:12

技能介绍

用途:这是一个通过单一启动器运行的 Slack 自包含 Python 客户端,用于跨多个已配置工作区读取、搜索、摘要、导出和发送 Slack 消息。当用户分享 Slack 链接,或被要求查找、总结、导出消息时使用。所有 Slack 任务均使用此 CLI,即使存在 Slack MCP 连接器也保持未使用。

主要能力:读取消息链接并返回完整线程(父消息与全部回复,含名称和本地时间);解析用户 ID 为名称;列出频道;读取频道历史与线程回复;搜索消息;发送消息到频道、线程或私信;生成活动摘要;导出消息归档并支持断点续传;生成永久链接。

使用方式:通过启动器调用,例如 SLACK=~/.agents/skills/slack/scripts/slack,然后 $SLACK help 查看全部命令与参数。每条命令需指定工作区:$SLACK -w <workspace> ...。读取链接用 $SLACK read-link "<url>"。发送消息用 $SLACK -w <workspace> send "C0123456789" "消息内容",线程回复需附加父消息 ts。导出用 $SLACK -w <workspace> export --from 2025-07-01 --to 2026-01-05 --output ~/slack-export.json,中断后可用 --resume 续传,用 export-status 查看状态。

适用场景:读取共享的 Slack 链接、查找或总结消息、生成活动摘要、导出消息归档、发送消息、检查近期动态。

限制:Slack 返回用户 ID 而非名称,需通过查找解析;Slack Connect 外部用户无法通过 from:username 搜索,需改用频道历史并按用户 ID 过滤;同名用户需先消歧;搜索仅支持日期查询(after:YYYY-MM-DD),不支持日期时间;mark-read 会移动用户已读游标,仅在用户同意后运行;导出受 Slack 速率限制(搜索约每分钟 45 次,线程获取约每分钟 90 次),并自动退避。若 config.json 缺失、需添加工作区或出现 invalid_auth,需按 references/setup.md 处理。若虚拟环境缺少 requests,可重建:python3 -m venv ~/.agents/skills/slack/.venv 与 ~/.agents/skills/slack/.venv/bin/pip install -r ~/.agents/skills/slack/requirements.txt。