# 员工扩展字段（staff-field-def）

员工扩展属性须先登记字段定义，再在 `staff-add` / `staff-update` 写入 `fields_json`。

**字段类型：** 仅支持 `text` | `number` | `enum`（与会员 field-def 一致；勿用 `date`）。

## 子命令

| 子命令 | 用途 |
|--------|------|
| staff-field-def-add | 登记员工扩展字段 |
| staff-field-def-list | 查看已登记字段 |
| staff-field-def-update | 更新字段定义 |
| staff-field-def-delete --yes | 删除字段定义 |

## 登记「擅长项目」字段

默认 seed 已登记 `skills`（擅长项目）。新库可手动登记：

```bash
uv run {baseDir}/scripts/cli.py staff-field-def-add \
  --field-key skills --label "擅长项目" --field-type text
```

## 登记「等级」枚举字段

```bash
uv run {baseDir}/scripts/cli.py staff-field-def-add \
  --field-key level --label "等级" --field-type enum \
  --options-json '["初级","中级","高级"]'
```

## 查看已登记字段

```bash
uv run {baseDir}/scripts/cli.py staff-field-def-list
```

## 建档时写入自定义字段

```bash
uv run {baseDir}/scripts/cli.py staff-add \
  --name "张师傅" --phone "13800138001" \
  --fields-json '{"skills":"基础服务,特色服务","level":"高级"}'
```

## 更新自定义字段

```bash
uv run {baseDir}/scripts/cli.py staff-update \
  --staff-id S001 --set-json '{"fields":{"level":"中级"}}'
```

## 按擅长项目搜索

```bash
uv run {baseDir}/scripts/cli.py staff-query --skill "基础服务"
```
