| name | setup-im-hook |
| description | 配置 Claude Code 完成任务后自动推送通知到 IM 群（飞书/钉钉/企业微信/Slack/Discord/自定义 webhook）。 将 webhook URL 安全地写入用户 shell rc 文件（~/.zshrc 或 ~/.bashrc），通过环境变量被仓库内已预置的 hook 脚本读取，不在仓库中留明文。 当用户提到"通知""webhook""接入飞书/钉钉/Slack""任务完成提醒""IM 推送""群消息""setup-im-hook"时触发。 即使用户只是模糊地说"做完了能不能告诉我一声"也应该触发此 skill。
|
| allowed-tools | Bash AskUserQuestion Read Edit |
Setup IM Webhook
帮用户把 IM 群的 incoming webhook 接入 Claude Code，实现任务完成后自动发群消息。
核心原理：仓库里的 .claude/hooks/im-webhook-notify.py 脚本在 Claude Code 每次任务完成时自动执行，它从环境变量 $IM_WEBHOOK_URL 读取地址并 POST 通知。这个 skill 要做的就是把用户的 webhook URL 写进 shell rc 文件，让环境变量生效。
第一步：收集信息
用 AskUserQuestion 询问两个问题：
- IM 平台（单选）：飞书/Lark、钉钉、企业微信、Slack/Discord、自定义
- Webhook URL：让用户在"其他"里填入（URL 是敏感信息，不要预设选项）
拿到 URL 后做基本校验：必须以 http:// 或 https:// 开头。不做域名限制——用户可能用自建服务。
第二步：写入环境变量
根据平台选择对应的 payload 模板，写入用户的 shell rc 文件。
检测 rc 文件
echo "$SHELL"
- zsh →
~/.zshrc
- bash →
~/.bashrc（macOS 上先 ls ~/.bash_profile ~/.bashrc 2>/dev/null 确认哪个存在，优先 ~/.bashrc）
- 其他 shell → 告知用户需要手动在对应 rc 文件中添加 export，并给出要添加的内容
写入规则
先 Read 目标 rc 文件，检查是否已有 export IM_WEBHOOK_URL=：
- 已存在 → 用
Edit 替换整行为新值；同时替换 IM_WEBHOOK_PAYLOAD_TEMPLATE 行（如有）
- 不存在 → 用
Edit 在文件末尾追加：
export IM_WEBHOOK_URL="<URL>"
export IM_WEBHOOK_PAYLOAD_TEMPLATE='<模板>'
各平台 Payload 模板
模板是 JSON 字符串，{message} 是运行时占位符。export 时用单引号包裹以避免 shell 转义。
| 平台 | 模板 |
|---|
| 飞书/Lark | {"msg_type":"text","content":{"text":"Claude Code 任务完成✅\n{message}"}} |
| 钉钉 | {"msgtype":"text","text":{"content":"Claude Code 任务完成✅\n{message}"}} |
| 企业微信 | {"msgtype":"text","text":{"content":"Claude Code 任务完成✅\n{message}"}} |
| Slack/Discord | {"text":"Claude Code 任务完成✅\n{message}"} |
| 自定义 | 让用户提供，要求包含 {message} 占位符 |
飞书是默认模板（脚本内置），选飞书时可以省略 IM_WEBHOOK_PAYLOAD_TEMPLATE 的 export。其他平台必须 export 模板。
第三步：激活与验证
环境变量写入 rc 文件后不会立即生效——需要让当前 shell 重新加载。告知用户：
请执行 source ~/.zshrc（或对应的 rc 文件），或者关闭终端重新打开。
如果 Claude Code 已经在运行，需要退出并重启才能读到新的环境变量。
给用户一条测试命令，在 source 后执行：
curl -s -X POST "$IM_WEBHOOK_URL" \
-H 'Content-Type: application/json' \
-d '{"msg_type":"text","content":{"text":"webhook 测试 🎉"}}'
如果不是飞书，替换 -d 的内容为该平台对应的一条简单测试消息。IM 群收到消息即配置成功。
第四步：收尾
告诉用户：
- 仓库
.claude/settings.json 里的 Notification 和 Stop hook 已经配好，无需改动
- 要停用通知：从 rc 文件删掉相关 export 行，source 后重启 Claude Code 即可
- 要换平台：重新运行
/setup-im-hook，会自动替换旧配置
安全边界
- 绝对不要把 webhook URL 写进
.claude/settings.json 或仓库里的任何文件。URL 只能存在于用户 home 目录下的 rc 文件中
- 不要执行任何 git 命令。这个 skill 只操作用户 rc 文件
- 如果用户把 URL 发在对话里，操作完成后提醒他们：URL 会留在对话历史中，建议在 IM 平台侧做好安全设置（如 IP 白名单）
