---
id: gh-ziniao-role
name: "ziniao-role"
url: https://skills.yangsir.net/skill/gh-ziniao-role
author: ziniao-open
domain: automation
tags: ["role-management", "permission", "erp", "employee", "authorization"]
install_count: 5000
rating: 4.40 (120 reviews)
github: https://github.com/ziniao-open/skills/tree/main/skills/ziniao-role
---

# ziniao-role

> 紫鸟角色管理技能，支持通过命令行查询、创建、修改、分配角色及查看权限，帮助团队自动化管理ERP权限配置，显著减少手动操作时间。

**Stats**: 5,000 installs · 4.4/5 (120 reviews)

## Before / After 对比

### 角色分配效率提升

**Before**:

在没有此技能之前，管理员手动为每个员工分配角色，需要逐一查找角色 ID、确认权限，每个员工平均耗时 10 分钟。

**After**:

使用此技能后，管理员只需一条命令即可完成批量分配，10 名员工仅需 1 分钟。

| Metric | Before | After | Change |
|---|---|---|---|
| 分配耗时 | 10分钟 | 1分钟 | -90% |

## Readme

# 角色管理

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../ziniao-shared/SKILL.md`](../ziniao-shared/SKILL.md)**

管理紫鸟 ERP 中的角色（权限组）。角色决定员工能看到哪些功能、能操作哪些店铺。
创建员工时需要传入 `--role-id`，可通过 `role list` 获取。

## Shortcuts

| 命令 | 说明 |
|------|------|
| `role list` | 查询所有角色 |
| `role detail --id` | 查看角色详情（含权限列表） |
| `role create --name --identity-id --permission-ids` | 创建角色 |
| `role update --id --name --identity-id --permission-ids` | 修改角色（需全量提交，不传的字段可能被清空） |
| `role assign --role-id --staff-id` | 将角色分配给员工（`--staff-id` 支持批量） |
| `role staff-roles --staff-id` | 查看某员工已分配的角色列表 |
| `role permissions --identity-id` | 查看指定身份的可用权限项 |

## 核心场景

### 查看角色与权限

```bash
# 查询所有角色（先获取 role-id）
ziniao-cli role list --format table

# 查看某角色详情
ziniao-cli role detail --id 123

# 查看系统支持的全部权限项（创建角色前先查）
ziniao-cli role permissions --identity-id 2
```

### 创建与修改角色

```bash
# 创建角色（权限使用权限 ID，多个权限用逗号分隔）
ziniao-cli role create --name "店铺运营" --identity-id 2 --permission-ids "100,101" --desc "负责日常店铺操作"

# 修改角色（需全量提交，建议先 role detail 查看当前值）
ziniao-cli role update --id 123 --name "高级运营" --identity-id 2 --permission-ids "100,101,102"
```

### 分配角色给员工

```bash
# 将角色分配给单个员工
ziniao-cli role assign --role-id 123 --staff-id 456

# 批量分配给多人
ziniao-cli role assign --role-id 123 --staff-id "456,789,101"

# 查看某员工已分配的角色
ziniao-cli role staff-roles --staff-id 456 --format table
```

### 典型工作流：新建角色并批量分配

```bash
# 1. 查看系统已有角色，避免重复创建
ziniao-cli role list --format table

# 2. 查看普通成员可用权限项
ziniao-cli role permissions --identity-id 2 --jq '.[] | .id'

# 3. 创建新角色
ziniao-cli role create --name "跨境运营" --identity-id 2 --permission-ids "100,101,102"

# 4. 获取新角色 ID（从上一步输出的 data.id 取）
# 5. 批量分配给员工
ziniao-cli role assign --role-id <new-id> --staff-id "201,202,203"
```

## 通用 api 覆盖

```bash
ziniao-cli api /superbrowser/rest/v1/erp/per/role/list
ziniao-cli api /superbrowser/rest/v1/erp/per/role/detail --data '{"roleId":"xxx"}'
ziniao-cli api /superbrowser/rest/v1/erp/per/role/add --data '{"roleName":"xxx","identityId":2,"permissionIds":[100,101]}'
ziniao-cli api /superbrowser/rest/v1/erp/per/role/edit --data '{"roleId":"xxx","roleName":"yyy","identityId":2,"permissionIds":[100,101]}'
ziniao-cli api /superbrowser/rest/v1/erp/staff/change/role --data '{"roleId":"xxx","staffIds":["yyy"]}'
ziniao-cli api /superbrowser/rest/v1/erp/staff/role/list --data '{"staffId":"yyy"}'
ziniao-cli api /superbrowser/rest/v1/erp/per/permission/list --data '{"identityId":2}'
```


---
*Source: https://skills.yangsir.net/skill/gh-ziniao-role*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-ziniao-role/markdown*