用途
feishu-notify 用于在任务完成后向飞书(Feishu)Webhook 发送通知。当用户要求发送飞书通知、使用 /feishu-notify 命令、请求任务完成后通知,或 Claude 完成特定任务且用户此前指示通过飞书通知时,激活该技能。
主要能力
该技能可让 Claude:
- 向已配置的飞书 Webhook 发送通知
- 配置飞书 Webhook URL
- 检查 Webhook 配置状态
- 自动生成有意义的标题和正文,概括已完成的任务
使用方式
首次设置需要配置 Webhook URL:
~/.claude/skills/feishu-notify/feishu-notify.sh config <webhook_url>
检查当前配置:
~/.claude/skills/feishu-notify/feishu-notify.sh status
在 Claude Code 中,任务完成后发送通知:
- 根据完成的内容生成简洁、有意义的标题和正文
- 发送通知:
~/.claude/skills/feishu-notify/feishu-notify.sh send "<title>" "<body>"
发送到 Webhook 的 JSON 载荷为:
{
"title": "<generated title>",
"body": "<generated body>"
}
生成通知内容的准则
- title:任务的简短摘要(例如「代码重构完成」「Bug 修复: 登录页面」「新功能已部署」)
- body:简要描述做了什么、关键变更或结果。保持信息量但简洁。
示例
# After fixing a bug
~/.claude/skills/feishu-notify/feishu-notify.sh send "Bug 修复完成" "修复了用户登录时 token 过期未刷新的问题,已提交到 main 分支"
# After deploying
~/.claude/skills/feishu-notify/feishu-notify.sh send "部署完成" "v2.1.0 已成功部署到生产环境,包含 3 个新功能和 2 个 bug 修复"
# Test the webhook
~/.claude/skills/feishu-notify/feishu-notify.sh test
配置
配置存储在 ~/.claude-feishu-notify.json:
{
"webhook_url": "https://www.feishu.cn/flow/api/trigger-webhook/..."
}
行为准则
- 发送前始终检查配置——不确定时运行 status
- 用用户使用的语言生成内容——匹配用户正在使用的语言
- 保持通知简洁——标题少于 20 字符,正文少于 200 字符
- 包含可操作信息——做了什么、哪个分支、发生了什么变更
- 不要发送重复通知——每个完成的任务只发送一次
限制
- 需要 Python 3(使用 urllib,无外部依赖)
- 首次使用前必须手动配置 Webhook URL
- 访问飞书 API 需要网络访问
allowed-tools
- Bash(*) — 执行通知脚本所需