技能介绍

解决的问题

在 Claude Code 这类终端式 Agent 环境里，工程师经常需要把构建结果、发布状态或告警通知推到企业微信，但不想手动登录后台、复制 UserID，也不想把企业微信凭证散落在项目目录中。wecom-send-message 的目标很具体：把企业微信 API 的常见动作封装成一组可被 Agent 调用的命令，包括查人、发消息、群发预览和查看审计日志。

核心能力与工作方式

技能通过本地 Python 工具 wecom_client.py 与企业微信 API 交互。配置阶段会先执行 check，再根据结果引导写入 corp-id、agent-id、secret，随后用 verify 验证连接。凭证默认放在 Skill 私有目录，避免误读当前项目的 .env。

日常使用通常按这条链路走：

找目标用户：支持 search-name、search-mobile、search-email，也可用 user-info 查看用户详情。
发送消息：支持 send-text、send-markdown、send-card，文本卡片可带跳转链接。
群发场景：可用部门列表 dept-list 和成员查询 dept-users 找到目标范围；多人发送用 | 分隔，@all 默认先预览，确认后追加 --yes。
发送后追踪：每次真实发送会写入 .state/message_audit.json，可用 history 查看最近记录。

适用边界与注意点

它适合在可信终端环境中做企业微信通知，但不适合替代正式的消息中台。使用前需要企业微信应用的有效凭证，并保证应用可见范围、通讯录权限和网络可达性。若返回 60020、60011 或 40014，通常分别对应接收者不可见、缺少通讯录权限和 token 过期。群发和 @all 要谨慎，因为默认预览不等于已发送；真正触发发送必须显式确认。