AI Spark 知识库

外观

新手如何做一个商家 Skill ​

新手如何做一个商家 Skill ​

可以按 7 步做。

第 1 步：先列业务，不要先写代码 ​

先回答这些问题：

Plain
我的商家是谁？
用户为什么会找我？
用户最常问哪 10 个问题？
哪些问题每天都一样？
哪些问题经常变化？
哪些事情可以让 AI 帮用户执行？
哪些事情必须人工确认？

比如一家餐馆：

Plain
固定信息：
- 门店地址
- 营业时间
- 联系方式
- 招牌菜
- 人均价格区间

动态信息：
- 今日活动
- 今日推荐
- 是否排队
- 是否有包间
- 是否售罄

动作：
- 预约
- 排队取号
- 到店自取
- 取消预约

第 2 步：把用户问题变成能力表 ​

不要只写“我们是一家餐馆”。

要写成“AI 可以帮用户做什么”。

示例：

这一步做完，你的 Skill 雏形就出来了。

第 3 步：写 SKILL.md ​

SKILL.md 解决的是：

AI 应该在什么场景使用这个 Skill？

AI 应该如何回答？

AI 不应该做什么？

建议结构：

Markdown
---
name: your-store-skill
description: 查询某某店的信息、服务、预约和最新动态。
version: 0.1.0
alwaysApply: false
keywords:
  - 某某店
  - 预约
  - 营业时间
---

# 某某店 Skill

## 你是谁

你是某某店的 AI 助手。

## 你能做什么

- 查询门店信息
- 查询营业时间
- 查询推荐产品
- 查询最新活动
- 说明预约流程

## 触发场景

当用户询问某某店相关问题时使用。

## 重要规则

1. 具体信息优先调用工具。
2. 不知道就说不知道。
3. 不要编造价格、库存、活动。
4. 预约、下单、取消等动作必须先确认。

第 4 步：写 skill.json ​

skill.json 解决的是：

这个 Skill 有哪些工具？

每个工具叫什么？

输入参数是什么？

它是不是只读？

建议新手先写 3 个只读工具：

Plain
get_store_info
get_recommended_items
get_latest_news

等只读工具跑通后，再写动作工具：

Plain
create_booking
cancel_booking
check_booking_status

只读工具的 annotations 可以像这样：

JSON
"annotations": {
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

动作工具要更谨慎，比如预约、取消、下单，不要标成普通查询。

第 5 步：准备数据源 ​

新手可以不用一开始就写数据库。

可以从简单数据源开始：

比如先建一个 data/store.json：

JSON
{
  "name": "某某店",
  "hours": "10:00-22:00",
  "address": "某某市某某区某某路 1 号",
  "phone": "010-xxxx-xxxx",
  "recommended_items": [
    "招牌产品 A",
    "招牌产品 B"
  ],
  "latest_news": [
    {
      "date": "2026-06-08",
      "title": "本周正常营业"
    }
  ]
}

第 6 步：先做信息型 Skill，再做动作型 Skill ​

新手最稳的路径是：

Plain
信息查询
↓
动态查询
↓
预约/排队/下单

不要一开始就做最复杂的动作。

第一版只要让 AI 准确回答：

  • 你是谁。
  • 你在哪里。
  • 你什么时候营业。
  • 你推荐什么。
  • 用户下一步该怎么做。

这就已经比大多数商家信息更适合 AI 读取了。

第二版再接动态信息：

  • 最新活动。
  • 今日推荐。
  • 名额/库存/排队状态。

第三版再做动作：

  • 预约。
  • 排队。
  • 下单。
  • 取消。
  • 查询进度。

第 7 步：写清楚安全边界 ​

商家 Skill 最容易出问题的地方，不是不会回答，而是回答过头。

你要明确写进 Skill：

  • 不知道就说不知道。
  • 不编造价格。
  • 不编造活动。
  • 不替用户直接下单。
  • 任何操作都需要通知用户。
  • 不在用户未确认时预约或取消。
  • 不暴露内部 token、cookie、账号密码。
  • 涉及金钱、排队等操作必须需要用户确认。
  • 涉及第三方平台时，遵守平台规则和用户授权。

尤其是动作型 Skill，比如排队、预约、下单，一定要有：

Plain
查询状态
↓
展示选项
↓
用户确认
↓
执行动作
↓
返回结果

一个最小商家 Skill 模板 ​

如果你要从 0 开始，可以先建这个目录：

Plain
my-store-skill/
├── SKILL.md
├── skill.json
├── data/
│   └── store.json
├── scripts/
│   └── server.js
├── README.md
└── LICENSE

第一版只做 3 个能力：

Plain
get_store_info
get_recommended_items
get_latest_news

等跑通后再加：

Plain
create_booking
cancel_booking
get_booking_status

如果你是餐馆：

Plain
先做：地址、营业时间、菜单、推荐菜、活动。
再做：排队、预约、到店自取。

如果你是培训机构：

Plain
先做：课程介绍、适合人群、学习路径、常见问题。
再做：预约试听、报名、查询班期。

如果你是工作室：

Plain
先做：服务介绍、报价范围、交付周期、案例说明。
再做：预约咨询、提交需求、查询进度。

新手最容易误解的 5 件事 ​

第一，Skill 不是宣传页。

宣传页是写给人看的，Skill 是写给 AI 调用的。

第二，Skill 不是知识库。

知识库只能回答，Skill 还可以调用工具、完成动作。

第三，Skill 不是越复杂越好。

第一版先让 AI 准确回答 5 个高频问题就够了。

第四，动作能力不要急。

预约、排队、下单都要确认流程和安全边界。

第五，真正难的不是技术，而是把业务说清楚。

如果商家自己都说不清用户常问什么、哪些信息会变化、哪些动作要确认，AI 也帮不了你。

最后 ​

金谷园这个案例最值得学习的地方，不是“饺子馆也会写代码”。

而是它给传统商家打了一个样：

一家店可以被整理成 AI 能读懂的说明书。

一组服务可以被整理成 AI 能调用的工具。

一个真实流程可以被整理成 AI 能执行的动作。

普通人做商家 Skill，可以先从最小版本开始：

Plain
1. 写清楚商家是谁。
2. 列出用户最常问的问题。
3. 把问题整理成能力表。
4. 写 `SKILL.md`。
5. 写 `skill.json`。
6. 准备数据源。
7. 先做查询，再做动作。

先让 AI 读懂你。

再让 AI 回答你。

最后才让 AI 调用你。

这就是一个商家 Skill 的基本路径。

免责声明： ​

本文是基于公开案例整理的新手教程，主要用于理解“商家 Skill”应该如何拆解信息、工具和动作流程，不是一个可直接安装上线的成品模板。

文中的 SKILL.md、skill.json、工具名称和目录结构示例，只用于说明设计思路。不同平台对 Skill、MCP、插件清单、工具声明和发布流程的要求可能不同，实际使用前请按目标平台文档调整。

需要特别注意：SKILL.md 只是 AI 的行为说明，不会自动产生预约、下单、排队、取消等真实业务能力。凡是涉及用户操作、订单、预约、支付、排队、取消、个人信息和第三方平台账号授权的功能，都必须补充真实工具实现、二次确认、权限校验、错误处理和安全测试。

发布前请务必删除或脱敏真实手机号、token、cookie、后台链接、内部经营数据、用户信息和任何不适合公开的配置。本文适合作为学习和教程参考，不建议原样作为商用成品发布。