Agent Skills
返回列表
大为同学商家助手

大为同学商家助手

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,为当前 AI 助手安装 @org-8oiv8bfc/dw-business-assistant,使其在会话中可调用该技能。

技能介绍

商家日常运营往往分散在管理后台多个模块:课程状态靠人盯,学员入班与出勤和课程卡扣减要靠人工核对,门店商品上下架也可能因为误操作直接影响营业。这类操作需要明确的权限、清晰的业务边界,以及尽量小的人工技能负担。

解决方式

大为同学商家助手把高频率、可解释的门店动作收敛到同一个安装单元,并按业务领域拆成不同权限包:

  • COURSE_SCHEDULING:排课、改排课、删除排课。
  • CARD_CONSUMPTION:正常扣卡、修改扣卡、标记单次买课程缺课。
  • BUSINESS_INSIGHTS、CRM_INSIGHTS:只读的经营数据、导师收入、转化分析、线索与跟进记录。
  • CARD_SALES:会员卡订单查询、售卡、转卡、零差价升卡,以及需要支付补差价的付费升卡。
  • STORE_MANAGEMENT:门店商品查询与上下架。
  • COURSE_FEEDBACK:提交与修改课程反馈,不提供删除反馈能力。

核心工作方式

写意图明确后,Agent 应先调用 query_course_data.py --action auth-start --auth-package <包名> 发起员工授权,不读数据库、不调用旧接口、不要求用户提供 Ticket。授权会话会返回“大为同学管理后台”链接和“大为导师端”二维码,Agent 必须在同一轮把链接、二维码、授权截止时间展示给用户,先结束当前轮,再由用户确认授权后运行 auth-wait。缺少有效 Ticket 时,Skill 只创建或恢复原 pending,不继续执行后续动作。

请求进入业务域前,Agent 必须读取对应 references/*.md:接口路由、候选消歧、确认摘要、幂等规则、敏感字段处理,以及返回字段对下一步动作的影响。所有写操作必须携带稳定的 --idempotency-key,同一业务意图重试时复用,不同业务意图使用不同值。

Identity 统一使用公开 handle,例如 memberHandle、coursePlanHandle、cardHandle、courseOrderHandle,不猜测或传递内部 ID。用户可见信息优先展示名称、门店、课程、会员、卡类型、日期时间、剩余课时和状态;handle 只用于 Agent 与脚本之间的下一步操作。

关键边界

课程生命周期规则、排课规则、扣卡确认、反馈 Service、订单结算仍由现有业务 Service 负责。Skill 只根据接口返回的 state、actions 和状态字段决定是否执行,不在本地复制业务规则。新增或替换学员、扣减课时、判定单次买课程缺课、提交反馈,都必须由接口中的结构化动作明确允许后再继续。

容易踩坑的细节

  • 会员卡升卡金额:orderAmount 是升阶后新订单价格,不是补差价;只有 priceDifferenceAmount/priceDifference 才是本次支付金额。priceDifferenceAmount=0 必须走 upgrade-zero-price,不询问支付方式、不生成支付二维码;priceDifferenceAmount>0 才先报价,再选择 WECHAT 并创建付费升卡支付意图。
  • 课次与有效期:时间卡不得传 totalClassHours;只有正式课次卡且用户明确指定时才原样传递合法整数。validityDays 也不能沿用源卡剩余有效期,未指定时由用户明确表达,明确指定时原样传递。
  • 课程计划剩余课时:接口返回的可约课时为 max(剩余课时 - 已预约课时, 0),新增学员或换卡时优先用这个结果做容量判断,不根据卡当前时间或表面描述重新推导。
  • 单次买课程缺课:不能只看课程名称或“待标记缺课”文案,而是先读课程订单的 orderKind 与 actions.markAbsent.allowed,只有结构动作允许时再调用对应动作。
  • 用户可见结果:不要输出 Ticket、pollToken、installationId、完整手机号、内部店员 ID 或底层异常。反馈正文非空时完整展示,图片按宿主能力展示;WorkBuddy 等宿主提供 present_files 时,若遇到 REMOTE_ONLY,应先以 --materialize-images 落盘再传本地绝对路径,不要传远端 URL。

总体来看,这个 Skill 的价值不是把所有规则塞进模型,而是把员工授权、领域路由、幂等重试、结构化动作和门店运营中常见的危险操作拆开,让模型只负责理解用户意图、展示必要信息、按 reference 做下一步。适合已经使用“大为同学”管理后台,并希望用 Agent 安全承接课程、卡务、CRM 与门店商品事务的工程化团队。

使用场景

  • 店长想给本周新学员安排第一次正式课,并同步扣减会员卡里剩余的课次。
  • 销售想给已到店的访客办理会员卡升卡,需确认新订单价格、补差价和支付二维码。
  • 运营想在周五复盘本周经营数据、续费会员和导师课时转化。
  • 门店管理员想下架已售罄的课程教材,避免客户继续下单。

适合人员

  • 教培机构的店长或排课专员,需要按员工身份完成排课、改课、确认升卡和上下架商品。
  • 负责会员卡续费与升卡的销售或运营,需要查询订单、确认补差价并打印付款二维码。
  • 负责周报的经营分析师,需要从多个只读入口汇总门店业绩、CRM 线索与导师收入。
  • 拥有教师权限的课程主管,想查看本周课表、扣卡、标记单次买缺课并提交课程反馈。