用途
configure-notifications 是一个交互式、自然语言驱动的配置技能,用于为 OMC(oh-my-claudecode)设置通知集成。配置完成后,OMC 可以在会话结束、需要用户输入或完成后台任务时向用户发送提醒。
主要能力
- 支持三种通知渠道:Telegram、Discord、Slack。
- 根据用户请求或参数中的关键词(telegram / discord / slack)自动路由到对应配置流程;未指定时通过 AskUserQuestion 询问用户选择。
- 自动检测已有配置(读取 ~/.gemini/antigravity/.omc-config.json),并允许用户更新或重新配置。
- 支持选择触发通知的事件:会话结束(session-end)、需要输入(ask-user-question)、会话开始(session-start)、会话持续(session continuing)。默认选择 session-end 与 ask-user-question。
- 配置写入后提供测试通知功能,验证设置是否生效。
- 支持通过环境变量替代配置文件,通知系统会自动检测环境变量。
使用方式
该技能通过自然语言交互逐步引导用户完成配置,主要步骤包括:检测现有配置、创建或获取渠道凭证、收集必要参数、选择消息格式与事件、写入配置文件、发送测试通知、显示最终配置摘要。
Telegram
需要 Telegram 机器人 token 和 chat ID。用户需通过 @BotFather 创建机器人获取 token,并通过 getUpdates API 获取 chat ID。可选择 Markdown 或 HTML 消息格式。配置写入 .omc-config.json 的 notifications.telegram 字段。也可通过环境变量 OMC_TELEGRAM_BOT_TOKEN 和 OMC_TELEGRAM_CHAT_ID 设置。
Discord
支持两种方式:Webhook(推荐,只需粘贴 webhook URL)或 Bot API(需要 bot token + channel ID)。可配置是否 @ 提及用户或角色,以及自定义机器人显示名称。配置写入 notifications.discord 或 notifications["discord-bot"] 字段。环境变量包括 OMC_DISCORD_WEBHOOK_URL、OMC_DISCORD_MENTION、OMC_DISCORD_NOTIFIER_BOT_TOKEN、OMC_DISCORD_NOTIFIER_CHANNEL。
Slack
需要 Slack incoming webhook URL。资料中 Slack 部分在创建 webhook 的说明处中断,后续步骤暂未提供。
适用场景
- 长时间运行的任务:当 OMC 等待用户输入时及时提醒。
- 会话结束时接收通知,无需持续盯守。
- 后台任务完成时获得提醒。
- 希望通过移动端或桌面端即时通讯工具接收 OMC 状态更新的用户。
限制
- 配置文件路径固定为 ~/.gemini/antigravity/.omc-config.json。
- Telegram 需要用户自行创建机器人并获取 chat ID。
- Discord Bot API 方式需要创建 bot 应用并开启开发者模式获取 ID。
- Slack 配置流程在资料中未完整提供。
- 资料未提供收费、价格、平台兼容性等具体信息。