用途:在终端使用 Slack CLI(slack 命令)创建、运行和管理 Slack 应用,包括直接调用 Web API 方法和搜索 Slack 开发者文档。初始搭建(沙箱创建、模板脚手架)应改用 slack:create-slack-app 技能。
主要能力与用法:
- 检测 CLI:优先使用官方安装路径(macOS/Linux 为 ~/.slack/bin/slack,Windows 为 %USERPROFILE%\AppData\Local\slack-cli\bin\slack.exe),否则用 slack _fingerprint 验证 PATH 中的命令,必要时询问别名或安装:curl -fsSL https://downloads.slack-edge.com/slack-cli/install.sh | bash。解析出的命令记为 SLACK_CMD。
- 命令发现:构造未用过的命令前先运行 SLACK_CMD <command> --help,不要猜测参数。
- 文档搜索:SLACK_CMD docs search "<query>" --output=text --limit=5。
- 调用 Web API:参数用位置式 key=value,如 SLACK_CMD api chat.postMessage channel=C0123456789 text="Hello from the CLI";--team、--token、--json、--data 是元标志。
- 认证:认证按团队区分。运行 SLACK_CMD login --no-prompt 获取一次性 ticket,让开发者在目标工作区发送 /slackauthticket <ticket>,Slack 弹窗显示挑战码后,用 SLACK_CMD login --ticket <ticket> --challenge <code> 完成登录;ticket 一次性且有时限,失败需重新获取。
- 本地运行:SLACK_CMD run --org-workspace-grant=all --app=<app_id> 或 --team=<team_id>,作为后台进程运行。
- 清单管理:SLACK_CMD manifest validate 等。
适用场景:开发者需要在终端管理 Slack 应用、调试 API、查询文档或本地开发时。
限制:交互式命令(如不带 --trigger-def 的 slack trigger create)无法后台运行,需开发者在新终端执行;slack run 为本地开发,slack deploy 部署到 Slack 托管基础设施(除非 .slack/hooks.json 定义了部署钩子)。