Slack工作区管理器（免费版）

概述

Slack工作区管理器免费版是一款面向个人与小型团队的Slack工作区管理工具。通过OAuth安全认证连接Slack工作区，提供消息管理、频道管理、文件处理、提醒创建、用户查询等核心功能，帮助你高效管理日常工作协作。

所有写操作均需用户确认后执行，确保操作安全可控。

核心能力

1. 消息管理

发送文本消息、线程回复、定时消息，删除与更新已发送消息。

输入: 用户提供消息管理所需的指令和必要参数。 处理: 按照skill规范执行消息管理操作,遵循单一意图原则。 输出: 返回消息管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. 频道管理

列出所有频道、搜索频道、创建新频道、设置频道主题与用途。

输入: 用户提供频道管理所需的指令和必要参数。 处理: 按照skill规范执行频道管理操作,遵循单一意图原则。 输出: 返回频道管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. 文件处理

上传文件到频道、列出工作区文件、下载文件。

输入: 用户提供文件处理所需的指令和必要参数。 处理: 按照skill规范执行文件处理操作,遵循单一意图原则。 输出: 返回文件处理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

4. 提醒管理

创建定时提醒、列出所有提醒、查看提醒详情、完成与删除提醒。

输入: 用户提供提醒管理所需的指令和必要参数。 处理: 按照skill规范执行提醒管理操作,遵循单一意图原则。 输出: 返回提醒管理的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

5. 用户查询

列出所有用户、按邮箱查找用户、查看用户在线状态与勿扰状态。

输入: 用户提供用户查询所需的指令和必要参数。 处理: 按照skill规范执行用户查询操作,遵循单一意图原则。 输出: 返回用户查询的执行结果,包含操作状态和输出数据。 技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Slack、工作区基础管理工、支持消息发送、文件处理与提醒创、适合个人与小型团、工作区管理器、免费版、面向个人与小型团、工作区管理工具、核心能力、消息发送、线程回复与定时消、频道创建、查找与列表查看、文件上传与列表查、提醒创建与管理、用户查询与状态查等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：创建项目频道并发送通知

# 创建新的项目频道
slack-workspace-manager create-channel \
  --name "project-alpha" \
  --is-private false

# 设置频道主题
slack-workspace-manager set-topic \
  --channel "C0123456789" \
  --topic "Alpha项目协作频道"

# 发送启动通知
slack-workspace-manager send-message \
  --channel "C0123456789" \
  --text "项目Alpha正式启动！请各位同步各自负责的模块。"

场景二：上传文件并设置提醒

# 上传项目文档到频道
slack-workspace-manager upload-file \
  --channel "C0123456789" \
  --filename "project_plan.pdf" \
  --title "项目计划书"

# 设置每周五的周报提醒
slack-workspace-manager create-reminder \
  --text "提交本周工作周报" \
  --time "every friday at 17:00"

# 查看所有提醒
slack-workspace-manager list-reminders

场景三：查找同事并发送私信

# 按邮箱查找用户
slack-workspace-manager find-user \
  --email "colleague@company.com"

# 查看用户在线状态
slack-workspace-manager user-presence \
  --user-id "U0123456789"

# 发送私信
slack-workspace-manager send-message \
  --channel "D0123456789" \
  --text "你好，关于昨天的设计文档有几个问题想讨论"

不适用场景

以下场景Slack工作区管理免费版不适合处理：

• 实际人员绩效评估
• 财务预算审批
• 合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

依赖详情

# 安装工具
npx skillhub@latest install slack-workspace-manager-free

# 连接Slack工作区（OAuth认证）
slack-workspace-manager connect
# 浏览器将打开授权页面，完成授权后自动连接

基本使用

# 验证连接
slack-workspace-manager list-connections

# 列出所有频道
slack-workspace-manager list-channels

# 发送消息
slack-workspace-manager send-message \
  --channel "C0123456789" \
  --text "Hello from Workspace Manager"

# 线程回复
slack-workspace-manager send-thread-reply \
  --channel "C0123456789" \
  --thread-ts "1234567890.123456" \
  --text "收到，我来跟进"

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

# config.yaml
slack:
  auth_mode: "oauth"          # OAuth认证模式
  default_channel: "C0123456789"

# 功能配置
features:
  messages: true              # 消息管理
  channels: true              # 频道管理
  files: true                 # 文件处理
  reminders: true             # 提醒管理
  users: true                 # 用户查询

# 安全配置
security:
  confirm_writes: true        # 写操作需确认
  confirm_deletes: true       # 删除操作需确认
  log_operations: true        # 记录操作日志

工具分类总览

最佳实践

安全操作规范

操作流程

读操作（安全）:
  list → get → search → find → call
  示例: 查找频道 → 获取历史 → 显示消息

写操作（需确认）:
  describe → preview → confirm → call
  示例: 预览消息 → 用户确认 → 发送消息

常用操作示例

# 列出所有频道
slack-workspace-manager list-channels

# 搜索频道
slack-workspace-manager find-channels --query "project"

# 获取频道历史消息
slack-workspace-manager get-history \
  --channel "C0123456789" \
  --limit 50

# 获取线程回复
slack-workspace-manager get-thread \
  --channel "C0123456789" \
  --thread-ts "1234567890.123456"

# 设置定时消息
slack-workspace-manager schedule-message \
  --channel "C0123456789" \
  --text "每周提醒：更新项目状态" \
  --time "every monday at 9am"

常见问题

Q: 如何连接Slack工作区？

通过OAuth认证流程连接。运行connect命令后，浏览器会打开Slack授权页面，授权后工具自动获取并安全存储OAuth Token，后续操作无需再次认证。

Q: 写操作为什么需要确认？

为确保操作安全，所有写操作（发送消息、创建频道、删除文件等）在执行前会显示预览，用户确认后才执行。这可以防止误操作。

Q: 频道ID和频道名称如何转换？

# 通过名称查找频道ID
slack-workspace-manager find-channels --query "general"
# 返回结果包含频道ID

大部分工具需要频道ID（C开头），可先通过find-channels查找。

Q: 定时消息支持哪些时间格式？

支持自然语言和Unix时间戳：

• 自然语言："in 15 minutes"、"every thursday at 2pm"、"tomorrow at 9am"
• Unix时间戳：1712023032

已知限制

受Slack API限制，单文件最大不超过1GB。大文件建议先上传到文件托管服务，再分享链接。

Q: 连接失败怎么办？

# 检查连接状态
slack-workspace-manager list-connections

# 重新连接
slack-workspace-manager connect

# 常见问题
# 1. Token过期 - 重新授权
# 2. 权限不足 - 在Slack管理页面调整App权限
# 3. 网络问题 - 检查网络连接

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• 网络环境: 需能访问Slack API端点

第三方依赖

API Key 配置

# 通过OAuth流程自动配置（推荐）
slack-workspace-manager connect

# Token由工具安全存储，无需手动配置
# 所需OAuth Scopes:
# - chat:write              发送消息
# - channels:read           读取频道
# - channels:write          管理频道
# - files:read              读取文件
# - files:write             上传文件
# - reminders:read          读取提醒
# - reminders:write         管理提醒
# - users:read              读取用户信息
# - users:read.email        按邮箱查找用户

可用性分类

• 分类: MD+EXEC+API（Markdown指令 + 命令行执行 + Slack API调用）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作，通过OAuth认证调用Slack Web API管理工作区
• 适用人群: 个人用户、小型团队、Slack工作区管理员
• 版本限制: 免费版支持基础工作区管理，PRO版本提供企业Grid、审计日志与批量操作能力

错误处理