Menu
当用户请求查询唯品会促销活动时使用此 skill。执行 vipshop CLI 获取当前促销活动列表，并对活动进行分析总结。
Read, write, append, and list local files in the session's working directory. Use when you need to persist output to disk, read input files, or manipulate file system safely. Supports text files, JSON, CSV, Markdown.
Generate images using Google Gemini models (Nano Banana 2 / gemini-3-pro-image-preview). Use when the user asks to create, generate, or make an image, picture, photo, or visual from a text description. Also supports image-to-image generation (modify/edit existing images). Supports multiple aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4) and resolutions up to 4K. Triggers on phrases like "generate an image", "create a picture", "make me a photo", "draw", "visualize", "edit this image", "modify this picture", or any request to produce or transform visual content.
Notion via notion-cli — a Rust CLI + MCP server for Notion API 2025-09-03+. Safety-first agent integration with rate limiting, response-size cap, untrusted-source output envelope, read-only MCP default, JSONL audit log, and --check-request dry-runs. Supports the new data-source model, 22 property types, 12 block types, and one-shot page+body creation.
Build multi-panel storyboards programmatically — create projects, upload images/audio to boards, composite annotations, export PDFs, share via public URL. Invoke when the user wants a storyboard, pre-visualization, shot breakdown, animatic, or any ordered sequence of visual panels with text. Hosted at https://agentboard.fly.dev. Works over REST from any agent; MCP tools (mcp__agentboard__*) available in compatible runtimes. If you have your own image/audio generator, use it and UPLOAD the bytes — optional server-side generation endpoints exist as a fallback only for agents without built-in generation.
Trade on prediction markets. Create a local wallet, list markets, check prices, buy and sell outcome shares. Coming soon: create and fund markets directly from this skill.
GoPlus AgentGuard — AI agent security guard. Run /agentguard checkup for a full security health check, scans all installed skills, checks credentials, permissions, and network exposure, then delivers an HTML report directly to you. Also use for scanning third-party code, blocking dangerous commands, preventing data leaks, evaluating action safety, and running daily security patrols.
| name | vipshop-promotion-search |
| description | 当用户请求查询唯品会促销活动时使用此 skill。执行 vipshop CLI 获取当前促销活动列表，并对活动进行分析总结。 |
通过执行 vipshop CLI 命令查询唯品会当前的促销活动，包括今日大牌、狂秒、mini大牌日、超级大牌日、超级品类日等各类活动，并进行智能分析总结。
功能特性：活动列表查询、活动状态分类、智能分析总结、自动登录触发
重要提示：当检测到用户未登录时，AI 必须自动触发登录流程，无需用户手动请求。
在执行查询前，AI 必须先检测依赖：
vipshop-cli 是否已安装（命令是否存在），如果没有则需全局安装：npm install -g vipshop-cli~/.vipshop-user-login/tokens.json 是否存在且有效重要：不要直接执行查询脚本，而是先检查登录状态。如果直接执行脚本返回 {"error": "login_required"}，说明未登录，此时必须进入自动登录流程。
当检测到未登录时，AI 必须按以下步骤自动处理，不要等待用户手动请求：
步骤 1.1：提示用户
检测到您尚未登录唯品会账户，准备为您启动登录流程。
💡 登录说明：
- 将使用唯品会登录 SKILL 完成登录
- 使用唯品会APP扫描二维码登录
- 快捷便捷，安全可靠
如果遇到未登录：
请直接执行系统原生级命令：vipshop login，随后必须在聊天中将获取到的二维码【线上链接】和【生成的二维码本地图片】（根据路径）同时一并返回给用户进行扫码登录操作。然后按照控制台提示使用 vipshop login --poll <qrToken> 轮询状态即可完成登录。
步骤 1.3：自动触发登录流程（通过 Skill 方式）
执行 vipshop login：
触发 `vipshop login`（阻塞模式）
如果 skill 调用不可用，则执行命令（备选方式）：
vipshop login
步骤 1.4：等待登录完成 等待 SKILL 完成登录流程，包括：
步骤 1.5：确认登录成功后，继续执行步骤2 登录成功后，继续执行促销活动查询。
无需输入参数，直接查询所有活动。
执行：vipshop search-promotion
解析 JSON 数据并格式化输出，展示活动分析总结。
显示字段：活动名称、活动状态、活动类型、时间范围、品牌信息、活动链接
skills/vipshop-skills/vipshop-promotion-search/scripts/promotion_search.py（基于原生 Node.js，通过 NPM Wrapper 提供完整功能）
{
"code": 1,
"msg": "success",
"分析总结": {
"总计": 25,
"按状态分组": {
"进行中": 15,
"待开始": 10
},
"按类型分组": {
"今日大牌": 10,
"mini大牌日": 8,
"超级大牌日": 3,
"超级品类日": 2,
"狂秒": 2
},
"活动列表": [...]
},
"原始数据": {...}
}
用户展示格式：
🔍 为您找到 25 个促销活动
━━━ 活动统计 ━━━
📊 总计：25 个活动
✅ 进行中：15 个
⏰ 待开始：10 个
━━━ 按类型分组 ━━━
今日大牌：10 个
mini大牌日：8 个
超级大牌日：3 个
超级品类日：2 个
狂秒：2 个
━━━ 进行中的活动 ━━━
🔥 欧莱雅大众（今日大牌）
⏰ 04.01 10:00 - 04.05 10:00
🏷️ 品牌：三熹玉,适乐肤,欧莱雅男士等13个品牌
🔗 链接：https://t.vip.com/iby5me
🔥 狂秒2026年3月31日20点场（狂秒）
⏰ 03.31 20:00 - 04.01 20:00
🏷️ 品牌：ELLE,苏泊尔
🔗 链接：https://t.vip.com/7baqm2
...
━━━ 待开始的活动 ━━━
⏰ 好奇20260402（今日大牌）
⏰ 04.02 10:00 - 04.03 10:00
🏷️ 品牌：好奇
🔗 链接：https://t.vip.com/mMJRVf
...
用户输入： "查询促销活动" 或 "有什么促销"
执行： vipshop search-promotion
输出：
{
"code": 1,
"msg": "success",
"分析总结": {
"总计": 25,
"按状态分组": {
"进行中": 15,
"待开始": 10
},
"按类型分组": {
"今日大牌": 10,
"mini大牌日": 8,
"超级大牌日": 3,
"超级品类日": 2,
"狂秒": 2
},
"进行中的活动": [...],
"待开始的活动": [...]
},
"原始数据": {...}
}
用户输入： "查询促销活动"
AI 响应（必须执行）：
检测未登录（tokens.json 不存在或无效）
立即自动执行（不要等待用户请求）：
检测到您尚未登录唯品会账户，准备为您启动登录流程。
💡 登录说明：
- 将使用唯品会登录 SKILL 完成登录
- 使用唯品会APP扫描二维码登录
- 快捷便捷，安全可靠
正在为您生成登录二维码...
通过 skill 方式触发登录（优先方式）：
调用 use_skill 工具触发 `vipshop login`
如果 skill 调用不可用，则执行命令（备选方式，相对于项目根目录）：
vipshop login
然后等待用户扫码确认后，使用 --poll 参数完成登录：
vipshop login --poll <qrToken>
等待用户扫码确认并完成登录
登录成功后，自动继续执行（相对于项目根目录）：
vipshop search-promotion
向用户展示查询结果
关键点：
当检测到用户未登录时，AI 必须：
vipshop login（优先）或执行 vipshop login 触发登录（备选，相对于项目根目录）vipshop login：
vipshop login执行前必须验证：
~/.vipshop-user-login/tokens.json 是否存在且包含 cookies 字段vipshop login 从 CLI 生成二维码vipshop search-promotion
无参数要求
执行脚本后：
vipshop login 登录URL： https://api.union.vip.com/vsp/common/getActListForAI
方式： POST
请求体： 空对象 {}
返回： code, msg, data.actList[]
actList 字段说明：
actStatusDesc：活动状态（进行中、待开始）actName：活动名称actTypeDesc：活动类型（今日大牌、狂秒、mini大牌日、超级大牌日、超级品类日）startTime：开始时间endTime：结束时间brandDesc：品牌描述actLink：活动链接vipshop login 获取登录态~/.vipshop-user-login/tokens.jsonQ: 如何查看活动的详细信息？ A: 每个活动都有对应的链接，可以点击链接查看详细商品。
Q: 活动会实时更新吗？ A: 是的，每次查询都会获取最新的活动列表。
Q: 狂秒是什么活动？ A: 狂秒是唯品会的限时秒杀活动，通常持续时间较短。
Q: 今日大牌和超级大牌日有什么区别？ A: 今日大牌通常是单品牌或少数品牌的促销，超级大牌日则是大型品牌集团的集中促销活动。
Q: 需要登录才能查看活动吗？
A: 是的，必须先执行 vipshop login 获取登录态。