notify-wecom

/notify-wecom

Send a single message to a WeCom group bot.

Human confirmation boundary

Read the explicit recipient_scope and recipient_label from the shared config.

self is the user's own delivery channel and may send without authorization.

others requires the active human-confirmation gate with the exact label and

message. Missing/invalid scope is a configuration error: stop and classify the

target; do not guess. A local alert/outbox item still needs identity/content

validation before either route.

Usage

/notify-wecom Claude Code 备份完成 ✅

The skill reads the webhook URL from the shared config file:

~/.config/setup-notifications-via-wecom/config.json

If the config is missing, it prints the one-line setup command and stops.

Prerequisite

This skill is a lightweight companion to setup-notifications-via-wecom. Either:

• Install setup-notifications-via-wecom first (recommended — it provides the webhook setup steps and its bundled sender), or
• Create the config file manually as shown below.

What It Does

1. Reads ~/.config/setup-notifications-via-wecom/config.json for webhook_url, recipient_scope, and recipient_label.
2. Inherits the host/project HTTP(S) proxy and no_proxy policy; never forces direct access.
3. If scope is self, sends without an authorization prompt. If scope is others, presents the exact label and message for human confirmation.
4. Sends via the WeCom webhook using the sender from setup-notifications-via-wecom (or an equivalent inline curl call).
5. Reports success or the exact WeCom error; authorization alone is not delivery proof.

Examples

/notify-wecom 服务上线成功 🚀
/notify-wecom 告警：build 失败，请检查
/notify-wecom 今日同步完成，0 缺失 0 滞后

Multi-line Messages

For multi-line messages, wrap in triple quotes or use a file:

/notify-wecom "第一行
第二行
第三行"

Failure Modes

• Config missing: Run the setup step from setup-notifications-via-wecom, or create the config file manually.
• Recipient or sender identity missing/invalid: Use setup-notifications-via-wecom's set_recipient.py command; never infer self versus others from the webhook URL, and never trust a script merely because its basename is send_wecom.py.
• Webhook key invalid: WeCom returns an errcode; the skill prints it.
• Network failure: Inspect the approved route; do not clear required proxies or switch paths automatically. Follow the sender Skill’s network guidance.

Limitations

• Plain text only. No markdown cards, images, or @mentions.
• Message length limit is 4096 bytes (UTF-8).
• No templating — use setup-notifications-via-wecom for structured backup/alert/status messages.
• A prepared pending item is not a delivery receipt; a zero errcode proves API acceptance. Recipient receipt and native SLS delivery require their own evidence.