# 1688 AI Message Push

> 1688 AI 消息推送 Skill —— 向当前用户自己推送通知，支持微信通知和 APP 系统通知两种渠道。 核心工具能力：微信通知推送（发给自己）、APP 系统通知推送（发给自己）。 触发词：微信通知、发微信、微信推送、APP通知、系统通知、APP推送。

- Skill: `lord1egypt/1688-ai-message-push` (Agent Skill, multi-file: 23 files)
- Install (CLI): `npx get-skill add lord1egypt/1688-ai-message-push`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/1688-ai-message-push/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/lord1egypt/1688-ai-message-push

---


# 1688-ai-message-push

统一入口：`python3 {baseDir}/cli.py <command> [options]`

## 命令速查

| 命令 | 说明 | 示例 |
|------|------|------|
| `wx_push` | 发送微信通知 | `cli.py wx_push --text "您的订单已发货，请注意查收"` |
| `app_push` | 发送 APP 系统通知 | `cli.py app_push --text "您的订单已发货，请注意查收"` |
| `configure` | 配置 AK | `cli.py configure YOUR_AK` |

所有命令输出 JSON：`{"success": bool, "markdown": str, "data": {...}}`

**展示时直接输出 `markdown` 字段，Agent 分析追加在后面，不得混入其中。**

## 使用流程

Agent 根据用户意图**直接执行对应命令**。
各命令在 AK 缺失等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。

**发送消息使用指引**：
- 当用户要求发送微信通知时，使用 `wx_push`
  - 若用户未提供通知内容，应先补齐：`text`
- 当用户要求发送 APP 系统通知时，使用 `app_push`
  - 若用户未提供通知内容，应先补齐：`text`

## 安全声明

| 风险级别 | 命令 | Agent 行为 |
|---------|------|-----------|
| **写入** | wx_push | 当通知内容明确时直接执行；内容缺失时先追问补齐 |
| **写入** | app_push | 当通知内容明确时直接执行；内容缺失时先追问补齐 |

**全局写入规则（适用于所有写操作）**：
1. 发送类操作属于写入，通知只会发送给用户自己，无需指定接收人。
2. 当通知内容明确时，可直接执行。
3. 当通知内容缺失时，先向用户追问补齐后再执行。
4. 不擅自扩写、改写用户希望发送的通知内容；如需润色，应明确告知并征得用户认可。

## 环境变量（.env）

项目根目录的 `.env` 文件存储 skill 基础信息，供埋点上报等模块读取。发布到不同环境时可直接替换该文件中的变量值。

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `SKILL_NAME` | `1688-open-skill-template` | skill 名称 |
| `SKILL_VERSION` | `1.0.0` | skill 版本号 |
| `SKILL_CHANNEL` | `clawhubai` | 发布渠道 |

> 已存在的系统环境变量优先级高于 `.env`，CI/CD 注入的变量不会被覆盖。

## 埋点上报

每次 CLI 命令执行时，自动向 skill 网关上报一次调用记录，用于统计 skill 调用次数。

- **实现位置**：`scripts/_tracker.py` → `report_skill_usage()`，在 `cli.py` 的 `main()` 中每次命令执行后自动调用
- **上报接口**：`POST /api/alibaba.1688.report.skills.usage/1.0.0`
- **上报参数**：

  | 参数 | 值来源 | 说明 |
  |------|--------|------|
  | `apiName` | 固定 `null` | 固定传 null |
  | `skillsName` | `.env` `SKILL_NAME` | skill 名称 |
  | `version` | `.env` `SKILL_VERSION` | skill 版本号 |
  | `scene` | 固定 `CLI` | 固定值 |
  | `channel` | `.env` `SKILL_CHANNEL` | 发布渠道 |

- **失败处理**：上报失败静默忽略，不影响主流程

## 异常处理

任何命令输出 `success: false` 时：

1. **先输出 `markdown` 字段**（已包含用户可读的错误描述）
2. **再根据关键词追加引导**：

| markdown 关键词 | Agent 额外动作 |
|----------------|--------------|
| "AK 未配置" 或 "AK 无效或已过期" | 提示用户当前发送能力所需鉴权未就绪，请补充有效 AK 或检查鉴权配置后重试 |
| "该用户没有与AI业务类型机器人的有效好友关系" | 提示用户到1688AI版工作台绑定微信账号 |
| "请求参数不合法" | 提示用户补充缺失参数后重试 |
| "请求被限流" | 建议用户等待 1-2 分钟后重试 |
| 其他 | 仅输出 markdown 即可 |

## 执行前置（首次命中能力时必须）
- 首次执行 `configure` 前：先完整阅读 `references/capabilities/configure.md`
- 首次执行 `wx_push` 前：先完整阅读 `references/capabilities/wx_push.md`
- 首次执行 `app_push` 前：先完整阅读 `references/capabilities/app_push.md`

## 参数补齐引导话术

**微信通知**：
> "发送微信通知需要通知内容 text。你可以直接告诉我，例如：微信通知"您的订单已发货，请注意查收"。"

**APP 系统通知**：
> "发送 APP 系统通知需要通知内容 text。你可以直接告诉我，例如：APP 通知"您的订单已发货，请注意查收"。"
