WhatsApp Skill

本 skill 通过 wacli CLI 控制 WhatsApp。所有操作必须遵守以下规则。

1. 执行前检查清单

每次执行 wacli 命令前必须运行以下检查：

1. 查阅 references/safety.md 中的读写分类表。未列出的命令运行 wacli <command> --help；如果它会向 WhatsApp 发送数据、修改本地 store DB 或拉取实时数据并更新本地 store，则归类为写操作。
2. 读操作追加 --read-only；写操作确保 --read-only 不存在。
3. 默认追加 --json，除非用户明确要求人类可读输出或命令是交互式（如 QR 码 wacli auth）。
4. 如果用户指定或之前使用过 --account NAME 或 --store DIR，则加上。
5. 所有全局标志放在 wacli 之后、子命令之前：顺序为 wacli [--json] [--read-only] [--account NAME] [--store DIR] [--timeout DURATION] [--full] [--events] <subcommand> ...。
6. 接收方是否明确？如不明确，使用 --pick N（N 从 1 开始）或询问用户。
7. 文件路径参数是否存在？发送前用 ls / test -f 验证。
8. media download 与 --read-only 一起使用时，必须提供 --output <PATH> 且路径在 store media 目录之外。
9. 网络/store 密集型写命令使用 --timeout 5m：send、sync、history backfill、groups info/refresh、channels list/info、profile *、auth、accounts add。轻量写命令使用 --timeout 1m：messages edit/delete/revoke/forward、contacts refresh/import-system、chats archive/pin/mute、groups participants、presence。
10. 写命令因 store is locked 失败时，使用 --lock-wait 30s 重试一次；仍失败则提示用户停止 wacli sync 或换 account/store。
11. 禁止臆造 wacli --help 或本 skill 未记录的子命令或标志。