开发者规范 · Agent Skill
水獭 AI 比价 Skill (shuita-ai-price)
赋能 Claude Code、Cursor、Codex 等 AI 编程助手与应用端,在回答 ChatGPT、Claude、Gemini、Grok 等订阅价格时, 直接调用发卡网真实在售价、滤除广告虚标,并对标官方定价给出折算参照与渠道风险警示。
Skill 与 MCP 的职责分工
- MCP Server (ai-price-mcp) 定位「数据检索」:向 AI 提供访问水獭底层行情库的结构化通信接口。
- Skill (
SKILL.md) 定位「规范对齐」:约束模型在何种提问场景下调取比价、遵循统一换算公式并强制补充风险告知。
接入模式推荐:
- 极简模式(纯 Skill 模式,免环境依赖):无需配置 MCP,Skill 驱动模型直接解析本站公开的 llms.txt 与行情页。
- 深度模式(Skill + MCP 组合):优先通过 MCP 获取毫秒级结构化数据,提供更具确定性的行情回答。
安装方式
通用命令行(通过 skills CLI 接入,支持 Cursor、Codex 等):
# 安装到当前项目目录;加 -g 则全局安装
npx skills add gm365/shuita-ai-price 默认在当前项目上下文生效(生成 .agents/ 与 skills-lock.json);若需跨项目复用,请附加 -g 进行全局安装。
Claude Code 全局安装:直接克隆至本地 skills 目录:
git clone --depth 1 https://github.com/gm365/shuita-ai-price /tmp/shuita-ai-price
mkdir -p ~/.claude/skills
cp -r /tmp/shuita-ai-price/skills/shuita-ai-price ~/.claude/skills/
rm -rf /tmp/shuita-ai-price Claude Web / Desktop 客户端:将仓库中的 skills/shuita-ai-price 打包为 .zip 文件,在 Settings → Capabilities → Skills 界面导入。
典型交互范式
| 提问范式 | AI 标准输出 |
|---|---|
| 「Claude Pro / GPT Plus 现在哪里买最便宜?」 | 当前有货的店内最低价、主流价格区间、在售店铺数与数据更新时间,附商品页链接 |
| 「Grok Heavy 渠道价和官方价差多少?」 | 美区官方月费折算成人民币后与渠道店内价对比,并说明渠道价不含官方售后保障 |
| 「直充、成品号、短效号有什么区别?」 | 各种发货方式的含义与常见翻车点,提醒超低价往往对应短效期或很短的质保 |
| 「这个月 AI 订阅价格走势怎么样?」 | 行情月报里的月度中位价、波动区间与环比变化 |
回答口径
- 恪守店内实价:「可买最低价」完全取自发卡商户前端实际结算价,优先呈现有明确库存的店铺,与本站对应商品页基准完全一致;坚决不采用社群宣传招徕价。
- 清晰标定履约类型:明确区分官方代充、独享成品号、拼车号或短效号,并附注采集时效与行情源链接,防止以短效号价格混淆月度长期服务。
- 中立免责边界:不进行具体店铺导流偏袒、不介入交易资金、不作连带质保承诺;始终引导买家在下单前查验商户售后条款,详见下单核对清单。
数据来源与更新
数据源与水獭 Web 端完全一致:每天北京时间约 8:00 与 20:00 两轮全网采集公开货架实价与现货件数,各商品排名靠前的报价每小时复查,数据每小时更新。数据仅作行情导购参考,具体商户履约请查阅免责声明。
标识与链接
- Skill 标识名:
shuita-ai-price(MIT License) - 开源仓库:gm365/shuita-ai-price (
skills/shuita-ai-price/SKILL.md) - 底层配套 MCP:ai-price-mcp 接入指南
- 大模型全站语义知识库:llms.txt
