Agent Skills
返回列表
三体云智能AI助手

三体云智能AI助手

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-e8gr6xve/santi。

技能介绍

它解决什么问题

三体云动 SaaS 暴露出上百个接口,而账号体系天然区分「品牌态」与「门店态」。把 endpoint + 参数 直接塞进 Agent 会撞上三件事:多门店账号登录后必须先查门店列表再切店;意图相近的能力(如「某个会员的课包余额」与「门店未消课负债」)口径完全不同,路由错了结果就是假的;最致命的是,Agent 在拿不到真实返回时会倾向于把猜测值当成业务数据输出。

技能如何工作

SKILL.md 本身不含业务逻辑,它只做路由与门禁:

  • 加载固定从顶层 santi 进入,业务域落在 auth / member / course / finance / order / operation / export;在 Hermes 里可能表现为 santi/member,也可能只有 category=santi + skill_name=member 的裸条目。
  • MCP 优先:调用 mcp_santi_memberCall、mcp_santi_courseCall、mcp_santi_financeCall、mcp_santi_orderCall、mcp_santi_operationCall、mcp_santi_exportCall 等域级通用工具,靠 method 白名单区分能力;登录、状态检查、切店、会员详情等强状态动作另有一等工具。
  • method 不确定时先查 mcp_santi_listCapabilities(domain),再读 mcp_santi_getCapability(method),最后才 Call(name, method, params)。
  • 脚本 fallback 只在 MCP 不可用时启用,统一走 gateway_api.py call + method;不允许手写 curl,也不允许直接读 token 文件。

门禁很硬:只有 ok=true、api_response_verified=true 且带 request_id 的调用才算一次真实业务请求,否则本轮不得回答金额、次数或状态。切换门店必须先在本轮拿到 getShopList 返回的真实 shop_id,再调 switchShop 确认,绝不能从输入里的店名自行拼 ID。

边界与注意点

  • shop_id=0 表示 access_token 仍停留在品牌态,不是登录失败;调用门店明细接口前必须先切店。
  • 同名裸接口只有在其 category 确为 santi 时才算本包;santi.bak:* 不是合法命名空间,备份目录不应出现在 skills 目录内。
  • skill_view 只能读当前 skill 目录,scripts/gateway_api.py 必须通过 run_in_terminal 执行。
  • 模糊意图要么依据上下文推断,要么输出编号列表让用户确认,禁止并发试探;会员卡、子女、到店记录一律走 member.* 专用接口,memberDetail 只用于确认唯一会员。

使用场景

  • 健身房前台按用户提供的手机号查会员详情,确认其储值卡剩余次数与到期时间
  • 连锁瑜伽馆店长每日早会前查本店昨日新增会员数与营收汇总
  • 会员中心客服回答家长询问 '名下孩子还有多少课时' 需先确认唯一会员再查询子女关联
  • 老板问'本月销售排行榜前五名',需按财务域销售排行而非课程消课统计返回结果

适合人员

  • 健身房前台会籍顾问:日常需要按手机号或姓名查会员卡余额和课程次数
  • 连锁瑜伽馆店长:每天要切换到具体门店后查看本店经营概览与营收统计
  • 会员中心客服:需要帮家长查询其未成年子女关联的课程包与课时
  • 门店管理层或老板:定期查看各门店的销售排行榜和消课负债