Youzan Staff

---
name: youzan-staff
version: 1.1.37
description: "店铺员工基础档案原始数据查询；支持员工列表和单个员工详情，不提供员工资料的远端数据变更能力，不做绩效、考勤、画像或推荐。"
---

# 店铺员工

使用本 skill 前，确认当前授权范围和店铺上下文。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 分页查询店铺员工列表，读取员工开放标识、姓名、账号、角色、手机号和状态等档案字段。
- 按手机号查询单个员工详情。
- 返回员工原始档案，不据此推导绩效、考勤或人员画像。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单个员工时必须提供员工手机号。

### 非必填信息

- 员工列表的姓名、手机号、部门、角色和状态条件可选；分页参数必须按“查询数量限制”传入。

## 使用案例

- 用户说“查店铺员工列表”时，按当前授权店铺分页返回员工基础档案；未指定状态时不默认只查在职员工。
- 用户提供员工手机号时，查询单个员工详情；姓名相同的员工不能只按姓名猜测。
- 用户问员工绩效、考勤或接待统计时，转到对应业务 skill，不从基础档案推导。
- 用户说“新建员工、停用账号或修改角色”时，说明本 skill 只支持读取。

## 边界

- 员工资料创建、编辑、启停、角色调整和其他远端数据变更不在本入口范围内。
- 员工绩效、接待统计和考勤信息使用对应业务技能；导购资料使用 `youzan-guide`。