@lark-people/cli 0.0.13 → 0.0.14-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-people/cli",
-  "version": "0.0.13",
+  "version": "0.0.14-beta.2",
   "description": "The official CLI for People open platform",
   "bin": {
     "people-cli": "scripts/run.js"

package/skills/people-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: people-cli
 version: 1.0.0
-description: "当用户需要处理飞书人事或飞书招聘数据时使用；覆盖 CoreHR 员工、部门组织、待入职、异动、离职、续约/续签、编制/HC，以及 Hire 职位、招需、投递、候选人、面试、评估、人才查询；也适用于 CLI 安装、升级、登录授权、Permission denied 和 scope 权限问题。"
+description: "当用户需要处理飞书人事或飞书招聘数据时使用；覆盖 CoreHR 员工、组织（部门、成本中心和自定义组织）、入职流程、异动、离职、续约/续签、编制/HC，以及 Hire 职位、招需、投递、候选人、面试、评估、人才查询；也适用于 CLI 安装、升级、登录授权、Permission denied 和 scope 权限问题。"
 metadata:
   requires:
     bins: ["people-cli"]
@@ -88,25 +88,19 @@ people-cli auth status --verify
 - 未配置应用：执行 `people-cli config init --new`，把命令输出的配置链接原样发给用户，等待用户完成。
 - 未登录、token 不存在、token 过期或服务端拒绝：先根据业务域执行用户授权。
 
-用户授权命令必须指定范围：
 
 ```bash
-people-cli auth login --domain corehr
-people-cli auth login --domain hire
-people-cli auth login --scope "<missing_scope>"
+people-cli auth login --domain all
 ```
 
-优先使用错误中的缺失 scope 做最小权限授权；不知道具体 scope 但已确定业务域时，才用 `--domain`。授权链接必须原样转发给用户，不要改写、解码、截断或补全。
+授权链接必须原样转发给用户，不要改写、解码、截断或补全。
 
 ### Step 4: 严禁 bot 身份
 
 People CLI 在本 Skill 体系中只能使用用户身份。
 
-- 业务命令必须使用或保持 `--as user`。
-- 严禁使用 `--as bot`。
-- 严禁建议用户申请 bot scope、配置 bot 权限或切换到应用身份来解决业务查询失败。
-- 如果命令输出显示 `[identity: bot]` 或等价信息，立即停止业务操作，改用用户身份重新处理。
-- Permission denied 只能按用户身份补授权；不能切换到 bot。
+- 在拼接业务命令必须使用或保持 `--as user`，严禁使用 `--as bot`。
+- 即使发现当前是 bot 身份，也不要重新执行登录授权流程，因为 Step3 你已经确认过了，只需要保证在执行命令的时候保持 `--as user` 即可。
 
 ### Step 5: 根据用户 query 确认实际业务域
 
@@ -114,7 +108,7 @@ People CLI 在本 Skill 体系中只能使用用户身份。
 
 #### 👤 员工信息查询 (employee)
 
-搜索员工、查询当前登录员工基本信息、查询员工可筛选字段、按条件筛选员工。适用于员工搜索、按姓名找人、查我自己、员工列表、部门员工、职级员工、员工字段、`employee search`、`employee filter`。不覆盖待入职、异动、离职、任职历史、审批、导出。
+搜索员工、查询当前登录员工基本信息、查询员工可筛选字段、按条件筛选员工。适用于员工搜索、按姓名找人、查我自己、员工列表、部门员工、职级员工、员工字段、`employee search`、`employee filter`。不覆盖待入职、入职名单、入职记录、入职流程、异动、离职、任职历史、审批、导出。
 
 → 详见 [people-corehr-employee](references/people-corehr-employee/SKILL.md)
 
@@ -136,9 +130,9 @@ People CLI 在本 Skill 体系中只能使用用户身份。
 
 → 详见 [people-corehr-organization](references/people-corehr-organization/SKILL.md)
 
-#### 🧾 待入职查询 (prehire)
+#### 🧾 入职流程查询 (prehire)
 
-查询 CoreHR 待入职数据。适用于待入职、入职前、pre-hire、onboarding candidate、入职阶段、预入职筛选字段。招聘候选人、投递、面试、评估走招聘域；已入职员工信息走员工域。
+查询对象是入职名单、入职记录或入职流程时走这里，覆盖待入职、入职准备、已完成入职和撤回等流程阶段。日期、地点、部门等只是筛选条件，不改变业务域。招聘候选人、投递、面试、评估走招聘域；员工花名册、当前员工资料走员工域。
 
 → 详见 [people-corehr-prehire](references/people-corehr-prehire/SKILL.md)
 
@@ -162,17 +156,25 @@ People CLI 在本 Skill 体系中只能使用用户身份。
 
 #### 🎯 招聘查询 (hire)
 
-查询飞书招聘数据，包括职位、招聘需求/招需、投递、面试、评估、人才、招聘流程与进度。CoreHR 待入职信息走待入职域；已入职员工信息走员工域。
+查询飞书招聘数据，包括职位、招聘需求/招需、投递、面试、评估、人才、招聘流程与进度。CoreHR 入职名单、入职记录和入职流程走入职流程域；员工花名册和当前员工资料走员工域。
 
 → 详见 [people-hire](references/people-hire/SKILL.md)
 
-#### 特殊说明
-
-- 优先使用用户明确说出的业务词：续约、异动、离职、编制、待入职、招聘、组织、员工。
-- 如果两个业务域都会查不同数据源且无法判断，问一个简短澄清问题。
+#### 路由判定规则
+
+- 必须先识别用户最终想查询的对象，再把日期、地点、部门、状态等识别为筛选条件；禁止仅按句中出现的单个词路由。
+- 用户最终想查入职名单、入职记录、入职流程、入职进度或待入职人员时，路由到 `prehire`。
+- 用户最终想查员工、员工名单、员工花名册、员工档案或在职人员时，路由到 `employee`。
+- 用户最终想查投递、候选人、面试、职位或招聘需求时，路由到 `hire`；想查调动、晋升、转岗或异动记录时，路由到 `job-change`。
+- 用户最终想查组织对象的字段、节点、是否存在、上下级关系、路径、组织树或聚合时，路由到 `organization`；具体组织家族和租户配置的组织类型由子 Skill 根据真实元数据确认。
+- 用户最终想查编制方案、HC、预增、预减、缺编数、满编率、方案维度、编制汇总或明细时，路由到 `workforce-plan`；组织只作为编制规划的筛选或分组维度时仍走 `workforce-plan`。
+- 一个词同时可能是业务域提示和实体名称的一部分时，不得拆词触发；必须以用户最终要求返回的对象或指标判定业务域。
+- 续约、离职等其他对象继续按上方各业务域定义路由。描述中的话术是可判别示例，不是需要穷举的关键词白名单。
+- 如果多个业务对象都成立且无法确定主对象，问一个简短澄清问题。
 - 每次用户新的 query 都要重新判断业务域，不能沿用上一轮路由。
 - 子 Skill 的命令结构互不通用。不能把 A Skill 的命令、字段、分页、search-option、schema 或元数据流程套到 B Skill。
 - 选定业务域后读取对应子 Skill 的 `SKILL.md`，再按该子 Skill 执行。如果对应子 Skill 不可用，停止并说明缺失，不要自行拼接命令。
+- 子 Skill 加载后发现其能力与主业务对象不匹配时，可以携带明确的不匹配原因回到本路由表重新判定一次。空结果、权限错误或字段不可筛选不代表路由错误，禁止因此跨业务域试探；重新判定后仍有歧义时必须询问用户。
 - 读取嵌入子 Skill 后，子 Skill 内的相对 reference 路径必须以该子 Skill 的 `SKILL.md` 所在目录为基准解析。例如 `references/foo.md` 应解析为 `references/<child-skill>/references/foo.md`，不是主 Skill 的 `references/foo.md`。
 - 嵌入子 Skill 要求读取 reference 时，必须读取该子 Skill 自己的 reference 文件。例如 `people-corehr-employee/SKILL.md` 中的 `references/people-corehr-employee-search.md` 必须解析到 `people-corehr-employee/references/people-corehr-employee-search.md`。
 

package/skills/people-cli/references/people-corehr-employee/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: people-corehr-employee
 version: 1.0.0
-description: "飞书人事 - 员工信息查询：搜索员工、查询当前登录员工基本信息、查询员工可筛选字段、按条件筛选员工。触发词：员工搜索、按姓名找人、查我自己、员工列表、部门员工、职级员工、员工字段、employee search、employee filter。适用边界：仅处理 employee search、basic info、fields、filter，不覆盖待入职、异动、离职、任职历史、审批、导出。"
+description: "飞书人事 - 员工信息查询：搜索员工、查询当前登录员工基本信息、检查员工应用权限、查询员工可筛选字段、按条件筛选员工。触发词：员工搜索、按姓名找人、查我自己、员工列表、员工权限、部门员工、职级员工、员工字段、employee search、employee filter、employee permission。适用边界：仅处理 employee search、basic info、permission check、fields、filter，不覆盖待入职、异动、离职、任职历史、审批、导出。"
 metadata:
   requires:
     bins: ["people-cli"]
@@ -12,14 +12,15 @@ metadata:
 
 ## Scope
 
-只处理以下四类员工查询能力：
+只处理以下五类员工查询能力：
 
 1. `+employee-search`：按姓名、工号、邮箱搜索员工。
 2. `+employee-basic-info-query`：查询当前登录员工的基本信息。
-3. `+employee-fields-query`：查询员工字段元数据，确认哪些字段可筛选、可排序、可展示。
-4. `+employee-filter`：按字段条件筛选员工列表。
+3. `+employee-perm-check`：检查当前登录用户的员工应用权限。
+4. `+employee-fields-query`：查询员工字段元数据，确认哪些字段可筛选、可排序、可展示。
+5. `+employee-filter`：按字段条件筛选员工列表。
 
-不处理待入职、异动、离职、任职历史、审批/修改、导出文件、跨模块复杂统计。命中这些边界时，停止使用本 skill，改走对应 skill 或直接说明当前能力不覆盖。
+不处理待入职、入职名单、入职记录、入职流程、异动、离职、任职历史、审批/修改、导出文件、跨模块复杂统计。命中这些边界时，停止使用本 skill，改走对应 skill 或直接说明当前能力不覆盖。
 
 ## Required Flow
 
@@ -27,11 +28,17 @@ metadata:
 2. **最短路径执行**：
    - 按姓名/工号/邮箱找员工：直接执行 `+employee-search`。
    - 查我自己、查我的工号、查我的 `employment_id`：直接执行 `+employee-basic-info-query`。
+   - 查当前账号是否有员工相关应用权限：直接执行 `+employee-perm-check`。
    - 问哪些字段可筛选/可排序/可展示：直接执行 `+employee-fields-query`，该命令本身就是终点。
    - 按部门、职级、序列、工作地点、上级、团队等条件查员工：先执行 `+employee-fields-query` 校准字段，再执行 `+employee-filter`。
-3. **字段校准**：凡是要构造 `+employee-filter` 的 `--filters`、`--sort-fields`、`--display-fields`，字段名都必须来自本轮真实 `+employee-fields-query` 返回的 `api_name`，禁止猜字段、禁止省略命名空间前缀。
-4. **真实执行**：条件一旦可落地，必须执行对应的最终命令。不要停在字段解释、命令草稿或搜索预演。
-5. **完成态校验并回答**：答案必须来自最后一次真实命令返回。若结果分页，必须明确说明当前页数量和是否还有下一页；不要静默截断。
+3. **权限场景选择**：`+employee-search`、`+employee-filter`、`+employee-fields-query` 会先执行 `+employee-perm-check` 等价的权限检查并选择 `app_key`。
+   - 同时有 `team` 和 `members` 权限：默认使用 `team`（团队成员），并提示用户同时具备团队成员和花名册权限；如需花名册场景，用户必须显式指定 `--app-key members`。
+   - 只有 `team` 权限：直接使用 `team`，并告知当前按团队成员场景查询。
+   - 只有 `members` 权限：直接使用 `members`，并告知当前按花名册场景查询。
+   - 指定 `--app-key` 但无该场景权限：停止查询并返回无权限错误。
+4. **字段校准**：凡是要构造 `+employee-filter` 的 `--filters`、`--sort-fields`、`--display-fields`，字段名都必须来自本轮真实 `+employee-fields-query` 返回的 `api_name`，禁止猜字段、禁止省略命名空间前缀。
+5. **真实执行**：条件一旦可落地，必须执行对应的最终命令。不要停在字段解释、命令草稿或搜索预演。
+6. **完成态校验并回答**：答案必须来自最后一次真实命令返回。若结果分页，必须明确说明当前页数量和是否还有下一页；不要静默截断。
 
 ## Route Templates
 
@@ -39,6 +46,7 @@ metadata:
 | --- | --- |
 | 按姓名、工号、邮箱找员工 | 直接 `+employee-search` |
 | 查我自己当前账号对应的员工信息 | 直接 `+employee-basic-info-query` |
+| 查当前账号员工应用权限 | 直接 `+employee-perm-check` |
 | 问哪些字段能筛选/排序/展示 | 直接 `+employee-fields-query` |
 | 查某部门、某职级、某序列、某地点的员工 | `+employee-fields-query` → `+employee-filter` |
 | 查我的团队 / 我的下级 | `+employee-basic-info-query` 取自己的 `employment_id` → `+employee-filter` |
@@ -48,6 +56,8 @@ metadata:
 ## Hard Rules
 
 - 禁止用本 skill 处理待入职、异动、离职、任职历史、审批、导出文件；这些都不属于 employee 能力边界。
+- `+employee-search`、`+employee-filter`、`+employee-fields-query` 不要绕过权限检查直接假定 `app_key=team`；运行时必须以权限检查结果或用户显式 `--app-key` 为准。
+- 当用户说“团队成员”时使用 `--app-key team`；当用户说“花名册”时使用 `--app-key members`。用户未指定且双权限都存在时默认不追问，使用 `team` 并提示可显式指定花名册。
 - 对 `+employee-filter` 而言，所有 `field_api_name` 都必须来自 `+employee-fields-query` 返回结果，且必须使用完整字段名，例如 `employment.department`，禁止写成 `department`、`job_level`、`workforce_type` 这类省略前缀的形式。
 - 若用户要求的筛选字段不存在，或 `filterable=false`，必须停止并明确告知该字段不支持筛选；不要尝试其他接口、相邻字段、组合字段或本地兜底。
 - 若用户要求排序字段不存在，或 `sortable=false`，必须停止并重新按 `+employee-fields-query` 返回值校准；不要凭经验继续执行。
@@ -71,12 +81,14 @@ metadata:
 
 - `+employee-search`：按 `姓名`、`工号`、`employment_id` 的顺序输出候选结果。
 - `+employee-basic-info-query`：输出 `常用姓名`、`工号`、`employment_id`、`邮箱`。
+- `+employee-perm-check`：输出 `app_key`、`has_permission`。
 - `+employee-fields-query`：保留字段元数据的核心列，至少包含 `name`、`api_name`、`type`、`filterable`、`sortable`、`displayable`、`operators`。
 - `+employee-filter`：
   - 默认只展示姓名和工号。
   - 用户显式要求的展示字段，按用户诉求追加。
   - 若接口返回 `Count`、`Has more`、`Next page` 等分页信息，答复中必须体现当前已返回多少条，以及是否还能继续查看下一页。
 - 若命令报错、字段不支持、名称解析失败或结果不具备唯一性，必须清楚说明失败类型，禁止编造人数或员工名单。
+- 对 `+employee-search`、`+employee-filter`、`+employee-fields-query` 的回答必须包含当前实际使用的查询场景：团队成员或花名册；双权限默认 `team` 时还要说明如需花名册需显式指定。
 
 ## Command Patterns
 
@@ -84,12 +96,21 @@ metadata:
 # 按姓名、工号、邮箱搜索员工
 people-cli corehr +employee-search --keyword <关键词>
 
+# 明确使用花名册场景搜索员工
+people-cli corehr +employee-search --keyword <关键词> --app-key members
+
 # 查询当前登录员工基本信息
 people-cli corehr +employee-basic-info-query --format json
 
+# 检查当前账号员工应用权限
+people-cli corehr +employee-perm-check --format table
+
 # 查询员工字段元数据
 people-cli corehr +employee-fields-query --format table
 
+# 查询花名册场景的员工字段元数据
+people-cli corehr +employee-fields-query --app-key members --format table
+
 # 默认场景：只返回姓名 + 工号
 people-cli corehr +employee-filter \
   --filters '[{"field_api_name":"employment.department","operator":"in","value_names":["技术部"],"is_strand_id_in":true}]' \
@@ -101,11 +122,19 @@ people-cli corehr +employee-filter \
   --filters '[{"field_api_name":"employment.department","operator":"in","value_names":["技术部"],"is_strand_id_in":true}]' \
   --display-fields '["employment.person.preferred_name","employment.employee_number","employment.department","employment.job_level"]' \
   --format table
+
+# 明确使用花名册场景筛选
+people-cli corehr +employee-filter \
+  --app-key members \
+  --filters '[{"field_api_name":"employment.department","operator":"in","value_names":["技术部"],"is_strand_id_in":true}]' \
+  --display-fields '["employment.person.preferred_name","employment.employee_number"]' \
+  --format table
 ```
 
 ## Minimal References
 
 - [people-corehr-employee-search.md](references/people-corehr-employee-search.md)：员工搜索的输入识别、输出字段顺序与基本示例。
 - [people-corehr-employee-basic-info-query.md](references/people-corehr-employee-basic-info-query.md)：当前登录员工基本信息查询与常见联动场景。
+- [people-corehr-employee-perm-check.md](references/people-corehr-employee-perm-check.md)：当前登录用户员工应用权限检查。
 - [people-corehr-employee-fields-list.md](references/people-corehr-employee-fields-list.md)：字段元数据、字段类型、可用操作符与筛选/排序/展示能力判断。
 - [people-corehr-employee-filter.md](references/people-corehr-employee-filter.md)：员工筛选、默认展示字段铁律、`value_names` 解析与分页约束。

package/skills/people-cli/references/people-corehr-employee/references/people-corehr-employee-fields-list.md

@@ -10,9 +10,10 @@ people-cli corehr +employee-fields-query [flags]
 
 ## 参数
 
-| Flag | 类型 | 必填 | 默认值 | 说明 |
-|------|------|------|--------|------|
-| `--accept-language` | string | 否 | `zh-CN` | 响应语言：`zh-CN`（中文）、`en-US`（英文） |
+| Flag | 类型 | 必填 | 默认值 | 说明                                                    |
+|------|------|------|--------|-------------------------------------------------------|
+| `--app-key` | string | 否 | 自动选择 | 查询场景：`team`（团队成员）或 `members`（花名册）；不传时先鉴权，双权限默认 `team` |
+| `--accept-language` | string | 否 | `zh-CN` | 响应语言：`zh-CN`（中文）、`en-US`（英文）                          |
 
 ### accept-language 选择策略
 

package/skills/people-cli/references/people-corehr-employee/references/people-corehr-employee-filter.md

@@ -116,6 +116,7 @@ people-cli corehr +employee-filter --help
 | `--display-fields` | string (JSON) | 否 | - | 展示字段，JSON 数组格式                                               |
 | `--limit` | int     | 否 | `30` | 返回结果数量上限（最大 100）                                             |
 | `--search_after` | string  | 否 | - | 分页游标，用于分页（首次请求为空，后续请求使用上次返回的 search_after 值,返回结果数量上限（最大 100） |
+| `--app-key` | string  | 否 | 自动选择 | 查询场景：`team`（团队成员）或 `members`（花名册）；不传时先鉴权，双权限默认 `team`        |
 | `--accept-language` | string  | 否 | `zh-CN` | 响应语言：`zh-CN`（中文）、`en-US`（英文）                                 |
 
 ### accept-language 选择策略

package/skills/people-cli/references/people-corehr-employee/references/people-corehr-employee-perm-check.md

@@ -0,0 +1,71 @@
+# +employee-perm-check
+
+检查当前登录用户的 CoreHR 员工应用权限。
+
+## 用法
+
+```bash
+people-cli corehr +employee-perm-check [flags]
+```
+
+## 参数
+
+无业务参数。支持通用 `--format` 输出控制。
+
+## 所需权限
+
+| Scope |
+|-------|
+| `corehr:employment_info_filter:read` |
+
+## 输出
+
+| 字段 | 说明 |
+|------|------|
+| `app_key` | 应用标识 |
+| `has_permission` | 当前登录用户是否有该应用权限 |
+
+## 场景语义
+
+| app_key | 场景   |
+|---------|------|
+| `team` | 团队成员 |
+| `members` | 花名册  |
+
+`+employee-search`、`+employee-filter`、`+employee-fields-query` 在执行前会先做同等权限检查：
+
+- 同时有 `team` 和 `members` 权限：默认使用 `team`，并提示用户如需花名册场景请显式传 `--app-key members`。
+- 只有 `team` 权限：使用团队场景。
+- 只有 `members` 权限：使用花名册场景。
+- 用户显式传入无权限的 `--app-key` 时停止查询。
+
+## 输出示例
+
+```json
+{
+  "ok": true,
+  "data": [
+    {
+      "app_key": "team",
+      "has_permission": true
+    },
+    {
+      "app_key": "members",
+      "has_permission": false
+    }
+  ],
+  "meta": {
+    "count": 2
+  }
+}
+```
+
+## 示例
+
+```bash
+# 表格格式输出
+people-cli corehr +employee-perm-check --format table
+
+# JSON 格式输出
+people-cli corehr +employee-perm-check --format json
+```

package/skills/people-cli/references/people-corehr-employee/references/people-corehr-employee-search.md

@@ -10,10 +10,11 @@ people-cli corehr +employee-search --keyword <关键词> [flags]
 
 ## 参数
 
-| Flag                | 类型     | 必填 | 默认值     | 说明                           |
-| ------------------- | ------ | -- | ------- | ---------------------------- |
-| `--keyword`         | string | 是  | -       | 搜索关键词（员工姓名、工号或邮箱）            |
-| `--accept-language` | string | 否  | `zh-CN` | 响应语言：`zh-CN`（中文）、`en-US`（英文） |
+| Flag                | 类型     | 必填 | 默认值     | 说明                                                    |
+| ------------------- | ------ | -- | ------- |-------------------------------------------------------|
+| `--keyword`         | string | 是  | -       | 搜索关键词（员工姓名、工号或邮箱）                                     |
+| `--app-key`         | string | 否  | 自动选择 | 查询场景：`team`（团队成员）或 `members`（花名册）；不传时先鉴权，双权限默认 `team` |
+| `--accept-language` | string | 否  | `zh-CN` | 响应语言：`zh-CN`（中文）、`en-US`（英文）                          |
 
 ### accept-language 选择策略
 
@@ -61,6 +62,9 @@ people-cli corehr +employee-search --keyword user
 
 # 英文输出
 people-cli corehr +employee-search --keyword 李 --accept-language en-US
+
+# 明确按花名册场景搜索
+people-cli corehr +employee-search --keyword 李 --app-key members
 ```
 ### 查看帮助
 

package/skills/people-cli/references/people-corehr-prehire/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: people-corehr-prehire
 version: 3.1.0
-description: "Use when querying CoreHR pre-hire data via people-cli: first inspect option fields, then inspect filter fields/options, then run pre-hire searches with selected return fields and filter conditions."
+description: "查询 CoreHR 入职流程数据：当用户要查询入职名单、入职记录、入职流程或待入职人员时使用；覆盖待入职、入职准备、已完成入职和撤回阶段，不处理员工信息或招聘投递数据。"
 metadata:
   requires:
     bins: ["people-cli"]
@@ -10,7 +10,7 @@ metadata:
 
 # people-corehr-prehire
 
-> **调用边界**：本 skill 只覆盖待入职（pre-hire）场景，统一使用 `people-cli corehr +prehire-*` Shortcut。
+> **调用边界**：本 skill 覆盖 CoreHR 入职流程记录，包括待入职、入职准备、已完成入职和撤回阶段，统一使用 `people-cli corehr +prehire-*` Shortcut。员工花名册和当前员工资料走 `people-corehr-employee`；招聘投递、候选人和面试走 `people-hire`。
 >
 > **元数据流程（最严格）**：
 > - 搜索前必须先调用 `+prehire-fields-query` 获取 Option Fields，确定可返回字段及 `--fields` 别名。
@@ -41,14 +41,16 @@ metadata:
 
 ## 何时使用
 
-只在以下场景使用：
+只在用户要查询以下内容时使用：
 
-- 获取待入职可返回字段或可筛选字段。
-- 按条件搜索待入职数据，并指定返回字段。
+- 查询入职名单、入职记录、入职流程、入职进度或待入职人员。
+- 获取入职流程可返回字段或可筛选字段。
+- 按条件搜索入职流程数据，并指定返回字段。
 
 不要使用：
 
-- 查询正式员工、异动、离职、编制。
+- 查询员工花名册、当前员工资料、异动、离职、编制。
+- 查询招聘投递、候选人、面试、职位或招聘需求。
 - 用户没有查询意图，只是讨论字段含义或业务规则。
 
 ## 标准流程（3 阶段）
@@ -87,7 +89,7 @@ people-cli corehr +prehire-filter-options-query --accept-language zh-CN --format
    - `keyword` / `stage_id`：右值透传，不加 `:name`。
 3. 用户给纯数字 ID 或 option ID 时用裸 `api_name`；用户给名称时用 `<api_name>:name`。
 4. 不在本次 Filter Fields 中、但在 Option Fields 中的字段，只能作为返回字段，不能直接筛选；按 [`troubleshooting.md`](references/troubleshooting.md) 的“可看不可筛”流程处理。
-5. 用户未显式指定 `stage_id` 时，依赖命令默认 `["preboarding","day_one"]`；用户显式指定时按用户值覆盖。
+5. 必须按 [`templates.md`](references/templates.md#stage_id-语义) 解析明确或未说明的入职阶段。日期只生成日期筛选条件，禁止根据过去、今年或未来推断 `stage_id`。
 
 ### 阶段 3：整理后调用 Search，获取筛选条件下的指定字段
 
@@ -149,7 +151,7 @@ people-cli corehr +prehire-search \
 - [ ] 筛选字段：`api_name` 精确匹配；歧义已澄清。
 - [ ] **`:name` 后缀已按用户输入选对**：纯数字 ID 用裸 `api_name`；名称用 `<api_name>:name`。
 - [ ] `--common-filters` 每项都是 `{"api_name": "...", "values": [...]}`。
-- [ ] 用户未指定 `stage_id` 时依赖命令默认值；指定时已确认覆盖默认。
+- [ ] `stage_id` 已按用户明确状态或入职流程名单的缺省口径处理；日期没有被用于推断阶段。
 - [ ] 真实执行后检查了 `has_more` / `page_token`。
 - [ ] **本轮只调用了一次** `+prehire-search`；未自行翻页 / 复跑 / 调大 `--page-size`，除非用户显式要「全部 / 翻页 / 继续」。
 - [ ] 用户**显式**要「导出全部字段 / 所有字段 / `all` / `*`」时，已按 [`return-fields.md` 全字段导出](references/return-fields.md#全字段导出) 把本次 Option Fields 支持且非默认的别名一次性拼到 `--fields`，并配 `--page-size 100`，**未**报告"无法一次导出"。

package/skills/people-cli/references/people-corehr-prehire/references/templates.md

@@ -26,7 +26,7 @@ people-cli corehr +prehire-filter-options-query \
 - 用途：确定 `+prehire-search --common-filters` 的筛选左值、右值来源和本地枚举 options。
 - 搜索前必须在 Option Fields 之后执行；不要根据经验猜测筛选字段或枚举值。
 
-### 3. 查询待入职数据
+### 3. 查询入职流程数据
 
 ```bash
 people-cli corehr +prehire-search \
@@ -66,12 +66,13 @@ people-cli corehr +prehire-search \
 
 口径：
 
-- 「今年入职的员工」→ `completed`，按需扩展。
-- 「今年已入职的员工」→ `completed`，按需扩展。
-- 「入职流程全部走完」→ `completed`。
-- 「放弃入职/撤回」→ `withdrawn`。
-- 用户**未显式**指定 → 用命令默认（不要自行覆盖）。
-- 用户**显式**指定 → 直接传，不再附加默认。
+- 明确「待入职 / 即将入职」→ `["preboarding","day_one"]`。
+- 明确「已入职 / 完成入职 / 入职流程全部走完」→ `["completed"]`。
+- 明确「放弃入职 / 撤回」→ `["withdrawn"]`。
+- 查询入职流程名单且未说明状态 → 显式传 `["preboarding","day_one","completed"]`，查询全部未撤回的有效入职记录，不使用命令默认值缩窄口径。
+- 日期、年份以及过去/今年/未来等时间关系只决定日期筛选条件，禁止据此推断 `stage_id`。
+- 只有查询语义已经明确是待入职、且没有更细阶段要求时，才可以依赖命令默认 `["preboarding","day_one"]`。
+- 用户显式指定阶段时直接传入，不再附加默认。
 
 ## 强约束消歧规则
 

package/skills/people-cli/references/people-corehr-workforce-plan/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: people-corehr-workforce-plan
 version: 1.1.0
-description: "当需要用 people-cli 操作 CoreHR 编制规划时调用：适用于查询编制方案、当前生效方案、编制 HC、在职人数、预增、预减、缺编数、满编率、编制汇总、维度分组、Top N、编制明细和原始行数据。用户提到编制、HC、headcount、预增、预减、缺编、满编率、workforce plan、预算方案、方案维度、编制明细时必须使用本 skill。"
+description: "当需要用 people-cli 操作 CoreHR 编制规划时调用：适用于查询编制方案、当前生效方案、编制 HC、在职人数、预增、预减、缺编数、满编率、编制汇总、维度分组、Top N、编制明细和原始行数据。"
 metadata:
   requires:
     bins: ["people-cli"]
@@ -18,7 +18,7 @@ metadata:
 
 使用：查询编制方案 / 当前生效方案 / 方案维度；查询编制 HC、在职人数、预增、预减、缺编数、满编率；按方案维度筛选、分组、Top N、分布、占比、对比、趋势；查询编制明细、原始行、缺维度行、过滤全零行；导出编制汇总或明细到 Excel。
 
-不要使用（应转其他 skill）：搜索员工、员工基本信息、任职记录、待入职、异动、离职、员工字段筛选 → `people-corehr`；纯认证 / 初始化 / 切换 `--as` / 处理 scope；用户只是泛化讨论组织设计或预算管理，并未要求查询编制数据。
+不要使用（应转其他 skill）：搜索员工、员工基本信息、任职记录、待入职、异动、离职、员工字段筛选 → `people-corehr`；查询组织对象本身的字段、节点、上下级关系或组织树 → `people-corehr-organization`；纯认证 / 初始化 / 切换 `--as` / 处理 scope；用户只是泛化讨论组织设计或预算管理，并未要求查询编制数据。只有组织作为编制规划的筛选或分组维度时，才留在本 skill。
 
 ## 路由表