大为同学商家助手
将以下提示词粘贴到你的 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 线索与导师收入。
- 拥有教师权限的课程主管,想查看本周课表、扣卡、标记单次买缺课并提交课程反馈。