vps-work 2.0.0 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vps-work",
-  "version": "2.0.0",
+  "version": "2.1.2",
   "description": "VPS Work CLI - tenant-aware domain shortcuts and bundled agent skills for Cursor / Claude Code / Trae.",
   "license": "MIT",
   "author": "he-linyan",

package/skills/vps-attendance/SKILL.md

@@ -22,4 +22,3 @@ description: VPS 原生考勤：日报、排班、请假、出差、外勤、加
 | `attendance +application-cancel --request-id <id>` | 取消本人待审批申请 |
 
 申请体始终使用 `vps-work catalog --domain attendance --json` 当前返回的 `params_schema`。旧版 CLI 使用 `vps-work exec --skill vps-attendance-applications --script <script_key>`，无需升级 npm。
-

package/skills/vps-hr/SKILL.md

@@ -11,7 +11,7 @@ description: |
 | Shortcut | 说明 | 契约 |
 |----------|------|------|
 | [`+me`](../vps-current-user-identity/SKILL.md) | 当前用户身份 | 内建 `vps-work hr +me` |
-| `+org-tree` | 组织部门树；默认一级/二级，`--max-depth 0` 查看全量，`--flat` 输出扁平列表 | Vertu 通讯录 |
+| `+org-tree` | 组织部门树；`--department` 限定子树，`--include-users` 同时返回员工；`--max-depth 0` 查看全量 | Vertu 通讯录 |
 | `+headcount` | 授权范围内的通讯录口径人数统计；返回人数与在职拆分 | 普通员工为本人，部门负责人为负责部门；全公司需要 `hr.profile.all:read` |
 | `+profile` | 本人人事档案；含部门、岗位、上级、入职/转正/离职、工龄、最新合同 | `hr-personnel-directory` data-view |
 | `+tenure` | 本人工龄与入职/转正/离职信息 | `hr-personnel-directory` data-view |
@@ -34,6 +34,7 @@ description: |
 | 用户问法 | 命令 |
 |----------|------|
 | 查组织架构 | `vps-work hr +org-tree` |
+| 查部门组织架构和员工名单 | `vps-work hr +org-tree --department "<完整路径或唯一部门名>" --include-users --max-depth 0` |
 | 查授权范围人数 / 在职多少人 | `vps-work hr +headcount` |
 | 查内部在职员工名单 | `vps-work hr +personnel-info --status "在职" --limit 1000` |
 | 查岗位明细 | `vps-work hr +job-details --job "<岗位关键词>"` |
@@ -45,7 +46,7 @@ description: |
 
 ## 字段与口径
 
-- `+org-tree` 走 Vertu 通讯录部门树，默认显示一级/二级；需要全量时用 `--max-depth 0`。
+- `+org-tree` 走 Vertu 通讯录部门树，默认显示一级/二级；需要全量时用 `--max-depth 0`。`--include-users` 会调用同口径的通讯录人员接口并自动拉完分页；配合 `--department` 时只返回该部门及全部下级部门的在职员工。员工输出不包含手机号等无关个人资料。
 - HR 人员范围由服务端计算：普通员工只能查本人；部门负责人默认查直接负责部门；显式部门管理员映射可通过 `include_children` 纳入下级部门；`hr.profile.all:read` 才能查看全公司。
 - 部门负责人默认字段包为 `basic`（姓名、工号、部门、岗位、上级、在职状态）。任职详情、合同和历史人员分别需要 `hr.profile.employment:read`、`hr.profile.contract:read`、`hr.profile.history:read`；`admin:*` 不自动获得这些人事敏感权限。
 - `+headcount` 是授权范围人数统计入口；不要用 `+personnel-info` 拉明细后本地统计人数。

package/skills/vps-shared/SKILL.md

@@ -41,7 +41,7 @@ Agent 不得读取、输出、复制或修改 `~/.vps-work/vps-service.json` 及
 2. Domain DSL 宏 `@me`、`@my_department` 等（见 `skills/vps-current-user-identity/SKILL.md`）；
 3. `vps-work auth status`。
 
-需要查看组织层级关系时用 `vps-work hr +org-tree`（默认一级/二级部门；全量加 `--max-depth 0`）。
+需要查看组织层级关系时用 `vps-work hr +org-tree`（默认一级/二级部门；全量加 `--max-depth 0`）。需要同时查看某个部门子树及通讯录员工时，加 `--department "<完整路径或唯一部门名>" --include-users`。
 
 细则见 `skills/vps-current-user-identity/SKILL.md`。