SuperAPI AI 工具集

slack-manifest

部署与运维

查看项目

更新于 10-15 22:38

技能介绍

用途:本技能用于指导修改 Slack 应用 manifest,涵盖增删机器人 scope、事件订阅、斜杠命令、快捷方式及 OAuth 配置,确保配置集中管理。

主要能力:所有 Slack 应用配置集中于 packages/agents-work-apps/src/slack/slack-app-manifest.json。slack-scopes.ts 在导入时导出 BOT_SCOPES / BOT_SCOPES_CSV,oauth.ts 使用 BOT_SCOPES_CSV 处理安装流程;setup-slack-dev.ts 运行时读取 manifest,用于本地开发应用设置;dispatcher.ts 负责将收到的 Slack 事件路由到处理器。

使用方式:修改 scope 时编辑 manifest 的 oauth_config.scopes.bot,无需改其他代码;本地开发应用重跑 pnpm setup-slack-dev,脚本会检测 scope 漂移并在变更时触发 OAuth 重装;生产 Slack 应用需在 https://api.slack.com/apps → OAuth & Permissions 手动更新,manifest 仅为含 <YOUR_API_DOMAIN> 占位符的模板,不会自动同步。为 agents-work-apps 创建变更集:pnpm bump patch --pkg agents-work-apps "Add <scope-name> bot scope for <feature>"。事件订阅编辑 settings.event_subscriptions.bot_events,添加后需确保 dispatcher.ts 处理;斜杠命令与快捷方式分别编辑 features.slash_commands 和 features.shortcuts,开发脚本会将命令重命名为 /inkeep-<devId>。查看当前 scope:node -e "console.log(require('./packages/agents-work-apps/src/slack/slack-app-manifest.json').oauth_config.scopes.bot.join('\n'))"。

限制与注意事项:不要在其他文件硬编码 scope;不要只改 manifest 而不更新生产 Slack 应用;删除 scope 前检查事件处理器与 API 调用。生产环境需替换占位符为实际 API 域名,本地开发由脚本自动处理。