Agent Skills
Agent Skills 是按业务域划分的 SKILL.md 指引文件——每个域一个——它们教会智能体每个任务该运行哪条命令,以及该域的字段、边界和安全规则。CLI 不装技能也能用,但技能会显著提升智能体的准确度。
安装
shell
npx skills add Shoplazza/shoplazza-cli -g
这条命令会把技能安装到 ~/.agents/skills/,并软链到你的 agent 技能目录,全局跨项目生效。
可用技能
| 业务域 | 技能 | 覆盖范围 |
|---|---|---|
| 地基 | shoplazza-common | 认证、命令分层、输出格式,以及安全协议。自动加载。 |
| 商品 | shoplazza-products | 建品 / 改价 / 库存 / 标签 / 上架、变体、合集、礼品卡 |
| 折扣 | shoplazza-discounts | 满减、折扣码、闪购 |
| 订单 | shoplazza-orders | 查订单、发货、退款、改运单号、标记已支付 |
| 客户 | shoplazza-customers | 客户资料、标签、地址 |
| 店铺 | shoplazza-shop | 店铺设置、元字段、媒体、分析、博客、页面 |
| Webhook | shoplazza-webhook | 事件订阅 |
| 计费 | shoplazza-billing | 应用收费:一次性、订阅、用量 |
如何调用技能
在请求前加上 /shoplazza-<域> 前缀,再用自然语言描述任务:
/shoplazza-products 上架一个新品:夏季印花T恤,卖 129
前缀会在智能体动手前,先把该业务域的命令与注意事项装进上下文。
提示
前缀非强制——每个技能也内置了触发词——但显式带上更确定。因此文档统一使用 /shoplazza-<域>。
选对业务域
每个技能只管一个域。按任务匹配对应的域:
| 做什么 | 用哪个技能 |
|---|---|
| 上新 / 改价 / 补库存 / 礼品卡 | /shoplazza-products |
| 满减 / 折扣码 / 闪购 | /shoplazza-discounts |
| 发货 / 退款 / 查订单 | /shoplazza-orders |
| 客户资料与地址 | /shoplazza-customers |
| 店铺设置、元字段、媒体、分析 | /shoplazza-shop |
| 事件订阅(webhook) | /shoplazza-webhook |
| 应用计费——一次性 / 订阅 / 用量 | /shoplazza-billing |
需要留意的域边界
有些任务位于两个域的交界处,技能这样路由:
- 礼品卡在
products,不在discounts。 - 按邮箱查订单在
orders;客户资料本身在customers。 - 买家退款在
orders,不在 billing。
安全协议
地基技能 shoplazza-common 会自动加载,并对任何写操作强制执行安全协议:
- 预览 —— 用
--dry-run运行命令,只打印请求而不发送。 - 复述 —— 概述该操作会改动什么。
- 确认 —— 等你明确确认后再执行。
这对不可逆或资金类操作(退款、取消、批量删除)尤为重要。协议实操见退款与删除示例。