SuperAPI AI 工具集

slack-development

编程与开发

查看项目

更新于 10-16 05:45

技能介绍

用途:在开发 Slack 机器人时,按 Slack 官方文档规范实现消息格式、入站事件路由与长任务用户体验。

主要能力:技能先对改动需求分类——输出格式、Slack 事件负载、Chat SDK 负载契约、线程路由、Assistant 线程 API、长时间运行行为;随后仅加载对应参考文件作为实现指南。覆盖 mrkdwn 渲染、bot 提及绕过被动无回复分类、assistant.threads.* 调用上下文、流式/进度反馈等。

使用方式:先判断类别再写代码,从 ${CLAUDE_SKILL_ROOT}/references/ 下选取所需参考文件(如 slack-output-formatting.md、slack-inbound-message-formats.md、chat-sdk-payload-contract.md、slack-thread-routing.md、assistant-thread-apis.md、chat-sdk-patterns.md)。需求含糊时先提一个聚焦问题再继续。

关键约束:以 Slack 当前入站事件负载为 Assistant 线程 API 调用的事实来源;非私信消息事件使用实时频道加 thread_ts ?? ts,message.im 必须显式携带 thread_ts;生命周期事件使用 assistant_thread.channel_id 与 assistant_thread.thread_ts;不得从持久化状态臆造 Assistant 线程标识;回复线程连续性与 Assistant 线程 API 资格需分开;不得用上下文变更覆盖会话专属标题;Assistant 状态写入属尽力而为,不得进入工具/模型执行关键路径。项目内保持与 AI Gateway 原语一致,避免重新引入已弃用的自定义搜索集成,保留 webhook waitUntil 行为。

验证要点:Slack 中渲染正确、优先使用 Chat SDK 文档字段、显式提及路径绕过无回复分类、块消息含充分的顶层回退文本、长任务即时反馈、工具/模型执行期间可观察流式与进度、错误返回可操作响应而非静默卡死。

限制:仅适用于该技能覆盖的 Slack 开发范畴;未提供具体版本、依赖或安装命令等信息。