mcpField
Z
ziniao-department

ziniao-department

github.com/ziniao-openその他85.0k 回インストール8 週間前に更新
リポジトリ

ziniao-department について

ziniao-departmentは、部門構成の確認と管理に使うziniao-cliのスキルです。ツリー表示や部門の追加・変更、並べ替えに対応し、親部門を削除すると配下の部門も削除されます。

主な機能

  1. 01部門階層のツリー表示
  2. 02部門の作成と更新
  3. 03部門と配下の部門の削除
  4. 04同階層の部門の並べ替え
  5. 05汎用APIによる部門エンドポイント呼び出し

活用シーン

  1. 01会社の部門構成の確認
  2. 02部門や子部門の作成
  3. 03部門名や並び順の変更
  4. 04削除前の階層と従業員所属の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ziniao-open/skills --skill ziniao-department

インストール後、Claude Code で/ziniao-departmentを入力して読み込まれたか確認します。

同梱ファイルreferences/ziniao-department-create.mdreferences/ziniao-department-list.md

詳細

プロジェクトの README より

部门管理

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../ziniao-shared/SKILL.md,其中包含认证、错误处理和安全规则 CRITICAL — 所有 Shortcuts 在执行之前,务必先用 Read 工具读取其对应的 references/ 说明文档,禁止直接盲目调用命令。

核心场景

查看组织架构

用户想了解公司部门结构时,使用 --tree 展示层级关系:

ziniao-cli department list --tree

输出树形结构:

├── 技术部 (id: 15868464646076)
│   ├── 前端组 (id: 15954943062431)
│   └── 后端组 (id: 15954943062432)
└── 市场部 (id: 15868464646077)
创建部门

hierarchy 由 CLI 自动推算(查父部门层级 +1),用户无需关心:

# 在已有部门下创建子部门(parentId 必须为已存在的部门 ID,不支持传 0)
ziniao-cli department create --name "华东区" --parent-id 15868464646076

⚠ --parent-id 不能传 0,必须传已存在的父部门 ID。如需查询可用的父部门 ID,先执行 department list --tree。

危险操作

删除部门是 high-risk-write,会要求确认。删除父部门会级联删除所有子部门,且不可恢复。 删除前建议先检查是否有子部门或员工:

ziniao-cli department list --tree          # 检查子部门
ziniao-cli staff list --department-id xxx  # 检查是否有员工
ziniao-cli department delete --id xxx      # 执行删除(需确认)

Shortcuts

命令说明详细文档
department list查询部门列表references/ziniao-department-list.md
department create新增部门references/ziniao-department-create.md
department update修改部门只发修改字段:--id xxx --name "新名"
department delete删除部门(子部门及员工归属将被清除)high-risk-write,--yes 跳过确认
department reorder调整排序--parent-id xxx --order "id1,id2,id3"

通用 api 覆盖

所有部门接口也可通过通用 api 命令调用:

ziniao-cli api /superbrowser/rest/v1/erp/department/list
ziniao-cli api /superbrowser/rest/v1/erp/department/add --data '{"name":"xxx","parentId":"<父部门ID>","hierarchy":"0"}'
ziniao-cli api /superbrowser/rest/v1/erp/department/update --data '{"id":"xxx","name":"新名"}'
ziniao-cli api /superbrowser/rest/v1/erp/department/delete --data '{"id":"xxx"}'
ziniao-cli api /superbrowser/rest/v1/erp/department/order --data '{"parentId":"xxx","order":["id1","id2"]}'

コメント