前言¶
健身房的日常運營數據散落在 iWOD 後臺裏:今天營收多少、哪些課還沒簽、哪張會員卡快到期、某張卡的修改記錄是什麼。門店店長或運營同學想拿這些數字,通常要登錄後臺、翻菜單、導出 Excel 再自己彙總。多門店的還要切賬號、切門店,一輪下來十分鐘過去了,數據還未必對得上。
下面介紹的 Skill「iWOD 健身門店數據助手」,就是把這類查詢直接放進對話裏完成。對着它說一句「今天營收多少」,它去調 iWOD 的接口,把結果給你;說「本月退款彙總」,它按支付方式拆好再返回。不需要登錄後臺,不需要導出表格。
這是什麼¶
iWOD 健身門店數據助手是一個基於通用 SKILL.md 格式的 Agent Skill,面向使用 iWOD(杭州思勱科技)系統的健身房、工作室與連鎖品牌。
它由社區發佈者 user_8ea7623f 維護,在 SkillHub 的座標是 @user_8ea7623f/iwod-connector,當前版本 0.3.13,來源標記爲 community,分類爲 data-analysis。發佈者提供的簡介是:面向使用 iWOD 系統的健身房、工作室與連鎖品牌,安裝後說「幫我配置 iWOD」即可完成首次設置,隨後用自然語言查詢門店數據,憑據僅保存在本機。
它解決的問題很具體:把「查數據」這一步從後臺操作變成一句話的事,讓不熟悉後臺菜單結構的人也能拿到營收、籤課、耗卡、會員卡與積分這些運營數據。
核心功能¶
根據發佈者提供的簡介,這個 Skill 支持的查詢包括:
- 營收查詢:今日營收、本月流水。
- 籤課相關:未籤課名單。
- 會員卡相關:會員卡明細(到期時間、剩餘次數、購買價值)、會員卡編輯記錄(可用於對賬排查)。
- 會員積分查詢。
- 退款彙總,並支持按支付方式拆分。
同時它支持多門店切換,連鎖品牌下不同門店的數據可以在對話中切換查詢。
一個值得注意的細節是:它明確提到「會員卡編輯記錄(對賬排查)」這個用途。這意味着當某張卡的剩餘次數或金額出現疑問時,可以通過查該卡的編輯記錄來定位變更歷史,而不必回到後臺逐個翻日誌。
憑據方面,發佈者聲明憑據僅保存在本機,Skill 需要 API Key(標籤 requires_api_key=true),也就是首次使用要先完成配置,配置項由 iWOD 側提供,Skill 本身不負責生成賬號體系。
安裝與啓用¶
這個 Skill 託管在 SkillHub 上,官方頁面地址是:
https://api.skillhub.cn/user_8ea7623f/iwod-connector
SkillHub 上的展示頁是:
https://www.skillhub.cn/skills/user_8ea7623f/iwod-connector
座標是 @user_8ea7623f/iwod-connector,版本 0.3.13。
按發佈者說明的啓用方式是:安裝後在對話裏說「幫我配置 iWOD」,Skill 會引導完成首次設置(填入 iWOD 側提供的憑據)。配置完成之後,直接用自然語言提問即可,例如「今天營收多少」「本月退款彙總」「未籤課名單」。
需要說明的是:發佈者資料裏沒有給出具體的安裝命令、運行環境(如 Cursor / Codex CLI / Claude Code 的對應路徑)或配置文件字段清單。所以在拿到 iWOD 憑據之前,先確認你的 Agent 環境能加載 SkillHub 上的這個 Skill,再走「幫我配置 iWOD」這一步。憑據填寫這一步的具體交互以安裝後的引導爲準,這裏不展開。
典型用法¶
發佈者提供的用法示例是配置與查詢兩段式,下面按這個思路複述:
1、首次配置:安裝後說「幫我配置 iWOD」,按引導填入憑據。這一步只在首次需要,之後憑據保存在本機。
2、查詢營收:「今天營收多少」「本月流水」——直接問,Skill 調 iWOD 接口返回數字。
3、查籤課:「未籤課名單」——拿當天或當週還沒簽的課次。
4、查會員卡:「某會員的會員卡明細」——返回到期時間、剩餘次數、購買價值。需要對賬時改問「某會員的會員卡編輯記錄」。
5、查積分:「某會員的積分」——返回當前積分。
6、退款彙總:「本月退款彙總」——需要按支付方式拆分時,在提問裏說明按哪種支付方式拆,例如「本月退款按微信/支付寶拆分」。
7、多門店:有多個門店時,在提問裏指明門店,例如「杭州店今天營收」「本月杭州店與上海店的流水對比」。
以上示例是按發佈者簡介裏列出的能力組織的,具體的門店名、支付方式名以你的 iWOD 系統裏實際配置的爲準。
適用場景與注意¶
適合誰:使用 iWOD(杭州思勱科技)系統的健身房、工作室、連鎖品牌的店長、運營或財務對賬角色,以及替門店做數據分析、需要頻繁拿營收與會員數據的開發者。
限制與坑:
- 它只覆蓋 iWOD 系統的接口範圍,查不到 iWOD 之外的數據。
- 它需要 API Key,且憑據保存在本機;憑據泄露或機器多人共用時要注意權限。
- 門店名、支付方式名這類業務側名稱,要與 iWOD 後臺一致,否則查詢可能落不到正確的門店或支付方式上。
- 版本 0.3.13 仍在迭代,接口字段或返回結構後續可能調整,對賬等正式用途建議先與後臺數據覈對一次。
- 發佈者資料裏沒有寫安裝命令與配置字段,部署前先確認 Agent 環境支持加載 SkillHub 的 Skill。
結尾¶
iWOD 健身門店數據助手做的是一件事:把 iWOD 門店的營收、籤課、耗卡、會員卡與積分查詢,從後臺點擊變成對話裏的一句話,多門店切換與退款拆分也一併覆蓋。對於日常要反覆拿這些數據的門店角色來說,它省掉的是登錄、導表、彙總那一輪重複勞動。
官方地址:https://api.skillhub.cn/user_8ea7623f/iwod-connector