前言¶

商城运营同学日常要回答的问题很集中：昨天卖了多少、哪个商品在跌、这批退款为什么积压、会员资产还剩多少。这些数据散落在商城后台的各个菜单里，平台管理者要么登录后台逐个翻，要么导出表格再手工汇总。做 Agent 应用的开发者要把同样的能力给到自己的系统，就需要一个能讲清楚”该查什么、按什么口径查”的技能定义。

芸众商城运营助手就是针对这个场景的 Skill。它面向平台管理者，把商城经营数据的查询与分析收敛成一条可被 Agent 调用的技能，并在商城显式开启后，支持通过预览和确认执行受支持的业务操作。

下面介绍这个 Skill 的定位、能力范围、启用前提和用法边界。

这是什么¶

芸众商城运营助手是一个基于通用 SKILL.md 格式的 Agent Skill，用于商城经营数据的查询与运营分析。

• 出品与维护：由社区发布者 user_f075d6ac 发布，来源标记为 community
• 当前版本：1.0.3
• 所属分类：business-ops
• 坐标：@user_f075d6ac/yunshop-operation-assistant
• 官方地址：https://api.skillhub.cn/user_f075d6ac/yunshop-operation-assistant
• SkillHub 页面：https://www.skillhub.cn/skills/user_f075d6ac/yunshop-operation-assistant

它解决的问题是：让 Agent 在接到”帮我看下这个月商城情况”这类请求时，知道该走哪条技能路径、该覆盖哪些数据域，而不是临时去猜接口。

核心能力¶

按官方简介，这个 Skill 的触发条件是用户需要查询商城经营情况，或需要了解商品、订单、会员、会员资产、退款、库存、支付、活动、履约、异常、日报、周报、月报，或需要后台操作方法。

把这些域拆开看，能力分三类：

1. 经营概览：日报、周报、月报，以及商城整体经营情况的查询。
2. 业务明细：商品、订单、会员与会员资产、退款、库存、支付、活动、履约、异常。
3. 操作指引：后台操作方法，即当用户问的是”这个功能在哪里点、怎么操作”时，技能给出对应的后台路径说明。

另外一点是执行侧的约束：涉及写操作时，需要商城显式开启，并且流程是先预览、再确认，然后才执行受支持的业务操作。这意味着它不会绕过确认直接改数据。

安装与启用¶

已抓取的 SkillHub 页面给出了技能的身份与前置条件，但没有给出安装命令、配置文件路径或目录约定。以下是页面上可核对的信息：

名称:   芸众商城运营助手
坐标:   @user_f075d6ac/yunshop-operation-assistant
版本:   1.0.3
来源:   community
分类:   business-ops
标签:   requires_api_key=true

requires_api_key=true 说明启用前必须先准备好可用的 API Key。这个 Key 的获取方式和填写位置，页面没有说明，需要向发布者确认后按其给出的方式配置。

安装与启用的具体步骤，建议直接以官方地址的页面说明为准，不要按其他 Skill 的通用命令照抄——不同发布者的目录约定和配置字段并不一致。

典型用法¶

官方简介以”什么时候该用这个技能”的方式描述了用法，而不是给出命令示例。按这个口径，可复现的使用方式是向 Agent 提出上述数据域的查询请求，例如：

• 查经营情况：这个月商城整体经营情况怎么样
• 查明细：这批退款为什么一直没处理完
• 查库存：某商品当前库存还剩多少
• 查会员资产：这批会员的资产情况如何
• 查异常：最近履约有没有异常单
• 问操作：会员等级怎么在后台设置

这些请求命中技能后，Agent 会按技能定义的数据口径去取数，而不是临时拼装查询。带写操作的场景则走预览与确认流程。

适用场景与注意¶

适合的人：平台管理者，以及要给自己的 Agent 应用补上商城数据查询能力、但不想从零梳理后台菜单和口径的开发者。

需要注意的点：

1. 数据域覆盖面以官方简介为准，简介里没列出的能力（例如特定的营销工具、物流商接口）不要假定已支持。
2. 写操作有前置条件：需要商城显式开启，并且要经过预览与确认。如果当前商城没开启，这类操作应直接告知用户，不要反复重试。
3. 版本号为 1.0.3，功能口径可能随版本变化，接入前以当前版本的页面说明为准。
4. 评分与下载量为页面抓取时的展示数据（下载 911 次），会随时间变化，不适合写进方案或对外材料当作稳定指标。
5. 需要 API Key，且该 Skill 来自社区发布者，接入生产环境前建议自己验证一次取数结果与后台数据是否一致。

结尾¶

芸众商城运营助手的价值不在于做新功能，而是把商城经营数据的查询范围和口径固化成一条技能，让 Agent 在接到经营类请求时有明确的取数路径，写操作也保留预览与确认这一层。如果正好需要这类能力，可以从官方地址看当前版本的说明再决定接入方式：

https://api.skillhub.cn/user_f075d6ac/yunshop-operation-assistant