技能介绍

解决了什么问题

在 Slack 里搭建一条工作流，往往意味着在 Workflow Builder 的可视化界面里反复点选、为每个环节配置 webhook，再想办法把审批状态同步回外部系统。步骤一旦超过三四个，手动配置的出错率就会明显上升，而且整个流程的逻辑散落在 Slack 后台和代码库两处，很难 review，也很难版本化。

这个技能把工作流的创建与管理收回到代码侧，让你用熟悉的开发流程去描述一条 Slack 工作流应该是什么样。

它是怎么工作的

技能基于两个官方库：@slack/bolt 处理事件与交互，@slack/web-api 直接调用 Slack 的 Web API。核心能力包括三块：

交互式弹窗（Modal）：用 Block Kit 组装表单和确认页面，用户在 Slack 里直接提交，而不是跳转到外部站点。
斜杠命令（Slash commands）：把工作流的触发入口固化成 /your-command，团队成员在任何频道里输入命令即可启动。
多步审批编排：通过 Slack Events API 监听事件，按预定义的步骤推进审批链，上一步完成后再触发下一步。

关键步骤上，开发者先初始化一个 Bolt app，然后注册事件监听器。这里有一个重要的细节：payload 的结构取决于你注册的监听器类型。比如处理 Events API 事件时，payload 拿到的就是事件类型本身的结构体，你需要据此决定是继续流转还是终止流程。技能的上游实现来自 GitHub 上的 1991513ccie-png/skills 仓库，其中的初始化指引提取自 Slack 官方 slackapi/bolt-js 项目的 README。

适用边界与注意点

Request URL 路径必须正确：Bolt app 的 Slack Request URL 需要把路径设为 /slack/events，否则事件投递会失败。这是接入时最常见的坑。
payload 结构不统一：不同监听器返回的 payload 结构不同，写解析逻辑时要区分 Events API 事件和交互回调（如 modal 提交）两种场景。
上游依赖社区仓库：技能的初始化逻辑来自社区维护的 1991513ccie-png/skills，并非 Slack 官方出品。遇到接口变动时，需要同时关注 slackapi/bolt-js 的上游文档和该仓库的更新状态。

适合的场景是：你已经在用 Bolt 开发 Slack 应用，需要在代码里以可测试、可版本化的方式管理多步审批或表单交互。如果只是偶尔发一条通知，直接用 Workflow Builder 反而更轻量。