custom-skills-notify 是一套用于 Claude Code 的通知系统,让使用者能通过 Telegram 或 Discord 接收 Claude Code 的重要事件通知。
用途 本 skill 用于在 Claude Code 运行过程中,将任务完成、任务失败、需要使用者决策、工具被拒绝等事件推送到 Telegram 或 Discord,方便使用者在长时间任务中及时获知状态。
主要能力
- 支持 Telegram 与 Discord 两种通知频道,可多选启用。
- 提供手动发送通知、初始化配置、测试连接、查看配置、开关事件通知等指令。
- 可搭配 plugin hooks 实现自动通知。
使用方式 指令包括:
- /notify init — 初始化设定,引导使用者建立通知配置文件,询问要启用哪些频道。Telegram 需提供 Bot Token(从 @BotFather 取得)与 Chat ID(可用 @userinfobot 取得);Discord 需提供 Webhook URL(从 Discord 频道设定 → 整合 → Webhook 取得)。配置文件路径为 ~/.config/claude-notify/config.json,建立完成后会自动执行 /notify test 验证连线。
- /notify test — 测试连线,执行 node "<skill_path>/scripts/notify.js" --test 发送测试讯息。
- /notify <讯息> — 手动发送通知,执行 node "<skill_path>/scripts/notify.js" --manual --message "<使用者的讯息>"。
- /notify config — 查看目前设定,读取并显示配置文件内容(隐藏 bot_token 和 webhook_url 的中间部分)。
- /notify toggle <event> — 开关事件通知,修改配置文件中的 events 设定。可用 event 名称:task_complete(任务完成通知)、task_failed(工具执行失败通知)、needs_input(需要使用者决策通知)、tool_rejected(工具被拒绝通知)。
自动通知 npx skills 只安装本 skill,不会安装 Claude Code plugin。自动通知由 custom-skills-notify plugin 处理,监听以下 Claude Code hook 事件:Notification(需要权限、闲置提示、需要回答问题)、Stop(Claude 完成回应)、PostToolUseFailure(工具执行失败)。需要自动通知时,另外执行: claude plugin marketplace add https://github.com/ValorVie/custom-skills.git claude plugin install custom-skills-notify@custom-skills 此 plugin 安装是独立操作,不属于 npx skills add 的结果。
脚本路径 通知脚本位于 <skill_path>/scripts/notify.js,使用 <skill_path> 代表此 skill 的根目录路径,执行命令时需用实际绝对路径替换。
限制 自动通知需额外安装 plugin,且该安装独立于 npx skills add。配置文件中若只需其中一个频道,另一个设 "enabled": false 或不写即可。若已有配置文件,会询问是否要新增频道或覆盖。