@lark-people/cli 0.0.0 → 0.0.1

package/skills/people-hire/references/people-hire-interview-task-list.md

@@ -0,0 +1,246 @@
+# +interview-task-list
+
+查询当前登录用户的面试任务，自动关联面试详情、投递（含职位）、人才信息。
+
+> **字段来源：** 以本文和 `people-cli hire +interview-task-list --help` 的 Shortcut 参数、稳定字段别名为准；底层 schema 仅在 reference/help 未覆盖字段时用于核对。
+## 适用意图
+
+当用户出现以下表达时，优先使用本场景：
+
+- "我的面试任务"
+- "今天 / 当前有哪些面试待我处理"
+- "待我面试 / 待我面的候选人"
+- "待我评价的面试"
+- "已评价 / 已终止 / 未开始的面试任务"
+
+## 固定查询流程
+
+1. **先判定是否是当前登录用户待办视角**
+   - 只要用户是在问"我的面试任务"、"待我评价的面试"，就走本 Shortcut。
+   - 不支持查询指定其他人的任务，禁止补传 `user_id`。
+   - 如果用户要求查看其他人/所有人的任务，或要求忽略/绕过权限限制，必须直接拒绝回答。
+2. **按任务状态筛选**
+   - 用户说"待我面试 / 待我面的候选人 / 等我面试"时，直接使用 `--pending-interview`（等价于 `--activity-status 1`）。
+   - 如用户要求待评价、已评价、未开始、已终止，优先使用 `--status` 传中文或英文别名。
+   - 枚举值固定来自元数据：`1`=未开始，`2`=未评价，`3`=已评价，`5`=已终止。
+   - 用户说"本月/上月/某月我面的"用 `--month`；给出具体日期或时间范围时直接传 `--start-time` / `--end-time`，由 CLI 换算毫秒；问"还有几场面试评价没提交"这类已结束待评价场景，用 `--status 待评价 --ended` 排除未结束面试。
+   - 如果用户要在"我的面试任务候选人 / 我面过的人"范围内查询笔试状态，当前 Shortcut 只用于获取内部 `Application ID`；`待阅卷`、`未作答`、`已接受` 等笔试条件必须交给 `+test-list --where` 处理。
+   - 用户给出候选人姓名或职位/部门关键词时，直接使用 `--keyword <关键词>` 在当前用户面试任务范围内过滤；不要改用原生命令或手写 `jq`。
+3. **执行 Shortcut**
+   - 直接执行 `people-cli hire +interview-task-list --page-size 5 [flags]`。
+   - Shortcut 内部会自动补齐 `Interview`、`Application`、`Talent`，不要重复补调。
+4. **按输出层级回复**
+   - 默认先返回 `5` 条任务摘要列表。
+   - 默认回复用户时展示候选人、职位名称、部门、任务状态、面试开始时间、面试结束时间、面试轮次；Shortcut 返回中仍保留 `Interview ID`、`Talent ID`、`Application ID`、`Job ID` 供后续调用。
+   - CLI 表格列和 `--fields` / `--where` 优先使用英文稳定字段别名，最终回复用户时再整理为中文展示名；不要手写 `Interview.xxx`、`Application.xxx`、`Talent.xxx` 这类嵌套 jq 路径。
+   - 候选人姓名使用纯文本展示。
+   - 除非用户明确指定，否则不要展示任何 ID 类型字段。
+   - 如果当前页之外还有更多数据，CLI/Shortcut 输出的 `page_token` 供 skill/agent 内部继续翻页；最终回复用户时只提示"还有更多数据"，不要展示 `page_token`。
+   - 如果用户明确指定查询后过滤条件（如 `XX天内`、`全部`、`XX状态`、`我的XXX`），使用 Shortcut 的 `--where` / `--mode` / `--limit` / `--scan-page-limit` 受控扫描；不要手动循环 `page_token`。
+   - 不要在本 Shortcut 上过滤 `test_status` / `reply_status`；这些不是面试任务字段。需要笔试状态时，先保留 `application_id` 供 `+test-list --application-id` 使用。
+   - `Interview` 裁剪对象可能包含 `interview_record_list` 的轻量摘要；默认回复用户时不要展开面评详情，用户需要新版面评详情时，使用该面试的 `interview_id` 调 `+interview-record-detail --interview-id`。
+   - 用户明确要求完整结构时，优先使用 `--view full`（兼容旧参数 `--no-trim`）。
+   - 用户只要少数字段时，使用 `--fields` 精确提取，禁止为了字段裁剪手写 `--jq`。
+
+## 用法
+
+```bash
+people-cli hire +interview-task-list [flags]
+```
+
+## 参数
+
+| Flag | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `--activity-status` | int | 否 | - | 任务状态筛选：`1`=未开始，`2`=未评价，`3`=已评价，`5`=已终止 |
+| `--status` | string | 否 | - | 任务状态别名：`未开始`、`待评价`/`未评价`、`已评价`、`已终止`、`已结束`；与 `--activity-status` 冲突时会报错。`已结束` 等价于 `--ended` |
+| `--pending-interview` | bool | 否 | `false` | 待我面试/未开始面试任务，等价于 `--activity-status 1` |
+| `--to-interview` | bool | 否 | `false` | `--pending-interview` 别名 |
+| `--start-time` | string | 否 | - | 最早面试开始时间，支持毫秒时间戳或日期字符串；Shortcut 内部受控扫描 |
+| `--end-time` | string | 否 | - | 最晚面试开始时间，支持毫秒时间戳或日期字符串；Shortcut 内部受控扫描 |
+| `--time-from` / `--start-date` | string | 否 | - | `--start-time` 别名 |
+| `--time-to` / `--end-date` | string | 否 | - | `--end-time` 别名 |
+| `--month` | string | 否 | - | 面试月份，支持 `YYYY-MM`、`本月`/`current`、`上月`/`last` |
+| `--keyword` | string | 否 | - | 在当前用户面试任务范围内按候选人、职位、部门、阶段等关键词过滤 |
+| `--ended` | bool | 否 | `false` | 仅保留已结束面试，常用于"待评价但已结束" |
+| `--page-size` | int | 否 | `5` | skill 默认分页大小（最大 20） |
+| `--page-token` | string | 否 | - | 分页 token，首次查询不传 |
+| `--view` | enum | 否 | `summary` | 输出视图：`summary` 裁剪视图，`full` 原始字段视图 |
+| `--fields` | string | 否 | - | 逗号分隔字段名，如 `interview_id,application,talent` |
+| `--where` | string | 否 | - | 查询后过滤表达式，如 `department contains Brand` |
+| `--limit` | int | 否 | - | 最多返回的匹配行数，默认等于 `--page-size` |
+| `--scan-page-limit` | int | 否 | - | 查询后过滤最多扫描源页数 |
+| `--mode` | enum | 否 | `list` | `list` / `exists` / `count` / `aggregate` |
+| `--group-by` | string | 否 | - | `--mode aggregate` 时按哪个字段聚合 |
+| `--no-trim` | bool | 否 | `false` | 禁用输出裁剪，返回 API 原始完整数据 |
+
+### 说明
+
+- 该命令**无需传入 user_id**，默认查询当前登录用户的面试任务。
+- 自动关联查询以下信息，**无需再单独调用对应 API**：
+  - **Interview**：面试详情（通过 `interview.list` + interview_id 查询）
+  - **Application**：投递详情（通过 `application.get` + `with_job` option 查询，同时返回职位信息）
+  - **Talent**：人才详情（通过 `talent.detail` 查询）
+
+## 标准输入
+
+以下输入字段由当前 Shortcut flag 固定，按本文和 `people-cli hire +interview-task-list --help` 使用：
+
+| 输入项 | 来源 | 类型 | 说明 |
+|------|------|------|------|
+| `activity_status` | `interview-task.list` query / `--activity-status` | int | 任务状态，`1/2/3/5` |
+| `status` | Shortcut 扩展 / `--status` | string | 任务状态中文或英文别名，会映射为 `activity_status` |
+| `pending-interview` / `to-interview` | Shortcut 扩展 | bool | 待我面试语义别名，会映射为 `activity_status=1` |
+| `start-time` / `end-time` / `time-from` / `time-to` / `start-date` / `end-date` / `month` / `ended` | Shortcut 扩展 | string/bool | 面试开始/结束时间相关受控过滤；时间由 CLI 换算 |
+| `keyword` | Shortcut 扩展 | string | 当前用户任务范围内的候选人、职位、部门、阶段关键词过滤 |
+| `page_size` | `interview-task.list` query / `--page-size` | int | skill 默认 `5`，最大 `20` |
+| `page_token` | `interview-task.list` query / `--page-token` | string | 翻页 token |
+| `view` | Shortcut 扩展 / `--view` | enum | `summary` / `full` |
+| `fields` | Shortcut 扩展 / `--fields` | string | 逗号分隔输出字段 |
+| `where` / `mode` / `limit` / `scan-page-limit` / `group-by` | Shortcut 扩展 | string/int | 查询后过滤、计数和聚合控制 |
+| `no-trim` | Shortcut 扩展 | bool | 是否返回完整未裁剪结构 |
+
+> `interview-task.list` 原始接口包含 `user_id`、`user_id_type`，但本 Shortcut 已固定为"当前登录用户任务查询"，调用时禁止传入。
+> 时间范围优先用 `--month` 或 `--start-time` / `--end-time`，也兼容 `--time-from` / `--time-to`、`--start-date` / `--end-date`。时间 flag 支持毫秒时间戳、`YYYY-MM`、`YYYY-MM-DD`、`YYYY-MM-DD HH:mm[:ss]`、`近/最近 N 天/周/月/季度/年`、`今天/today`、`昨天/yesterday`、`本月/current`、`上月/last`；不要让模型自行计算毫秒。`--where` 中时间字段使用稳定别名 `begin_time` / `end_time`；CLI 兼容 `interview_time`、`interview_start_time`。多条件优先用分号分隔，CLI 兼容英文 `AND`，但不支持 `OR`。
+
+## 标准输出
+
+本场景输出分两层：
+
+1. **内部关联字段层**：来自 `interview-task.list`
+2. **自动补齐层**：来自 `interview.list`、`application.get`、`talent.detail`
+
+内部关联字段默认只供后续查询和状态映射使用，不直接展示给用户：
+
+| 字段 | 来源 | 类型 | 说明 |
+|------|------|------|------|
+| `Interview ID` | `interview-task.list.items[].id` | string | 面试 ID |
+| `Job ID` | `interview-task.list.items[].job_id` | string | 职位 ID |
+| `Talent ID` | `interview-task.list.items[].talent_id` | string | 人才 ID |
+| `Application ID` | `interview-task.list.items[].application_id` | string | 投递 ID |
+| `Activity Status` | `interview-task.list.items[].activity_status` | int | 任务状态。枚举：1=未开始, 2=未评价, 3=已评价, 5=已终止 |
+
+## 所需权限
+
+| Scope |
+|-------|
+| `hire:interview:readonly`、`hire:application:readonly`、`hire:talent:readonly` |
+
+## 默认回复与字段别名
+
+### 默认展示字段
+
+默认回复应优先整理为列表，字段固定如下：
+
+| 用户回复字段 | CLI 字段 / 稳定别名 | 说明 |
+|------|------|------|
+| 候选人 | `Candidate Name` / `Talent.basic_info.name` / `candidate` | 候选人姓名，以纯文本展示 |
+| 职位名称 | `Application.job.name` / `job` / `job_name` | 投递职位名称 |
+| 部门 | `Application.job.department.name` / `department` | 部门名称，通常取 `zh_cn` |
+| 任务状态 | `Activity Status` / `activity_status` | 面试任务状态 |
+| 面试开始时间 | `Interview.begin_time` / `begin_time` | 面试开始时间 |
+| 面试结束时间 | `Interview.end_time` / `end_time` | 面试结束时间 |
+| 面试轮次 | `Interview.round` / `round` | 面试轮次 |
+
+> Shortcut 默认保留 `Interview ID`、`Job ID`、`Talent ID`、`Application ID` 作为内部关联字段，但除非用户明确指定，不要在回复中直接展示这些 ID。若用户要求完整嵌套结构，使用 `--view full`。
+> 自行分组或重排面试任务表格时，候选人名使用纯文本；不要在最终回复里展示 ID 列。
+
+### 补齐对象与字段别名
+
+Shortcut 会自动补齐 `Interview`、`Application`、`Talent` 三个对象。默认摘要只保留关键字段；完整结构使用 `--view full`。
+
+| 对象 / 别名 | 默认含义 |
+|------|------|
+| `Interview` / `interview` | 面试详情，默认含 `begin_time`、`end_time`、`round`、`interview_record_list` 轻量摘要 |
+| `Application` / `application` | 投递详情，默认含 `active_status`、`stage`、`job` |
+| `Talent` / `talent` | 人才详情，默认含 `talent_id`、`basic_info.name` |
+| `candidate` / `candidate_name` | 候选人姓名过滤或字段选择别名 |
+| `job` / `job_name` | 职位名称过滤或字段选择别名 |
+| `department`、`stage`、`active_status`、`job_category` | 来自投递/职位的查询后过滤别名 |
+| `begin_time`、`end_time`、`round`、`interview_type` | 来自面试记录的查询后过滤别名 |
+| `search` / `keyword` | 候选人、职位、部门、阶段等摘要文本的过滤别名 |
+
+> `interview_record_list` 是轻量摘要，不等同于新版面评详情；需要完整面评内容时，用 `+interview-record-detail --interview-id <interview_id>`。面试任务里的 `Talent` 只作为轻量摘要；用户明确需要教育/项目/工作经历等履历时，可使用 `+talent-detail --talent-id <talent_id>` 查询裁剪后的候选人详情。
+> 不要在面试任务列表上过滤 `conclusion`、`evaluation`、`test_status`、`reply_status`：面试结论去 `+interview-record-detail`，笔试状态先保留 `Application ID` 再用 `+test-list --application-id`。
+
+### 输出格式
+
+默认使用表格输出，和其它招聘列表 Shortcut 保持一致。显式传 `--format json` 时数据被 Envelope 包装：
+
+```json
+{
+  "ok": true,
+  "identity": "user",
+  "data": [ ... ],
+  "meta": { "count": N }
+}
+```
+
+`--format table` 时嵌套对象会被扁平化为点号分隔的列显示；这是默认格式。精确字段裁剪使用 `--fields`。
+
+## 输出裁剪
+
+**默认行为**：自动裁剪输出，只返回关键字段，减少模型幻觉风险。裁剪后每条记录约 0.3KB（裁剪前约 3-5KB）。
+
+- 默认裁剪无需额外参数；完整结构使用 `--view full`（兼容旧参数 `--no-trim`）。
+- `--fields`、`--where`、`--group-by` 使用上方稳定字段别名，不要手写 jq 路径。
+
+## 使用 --fields 精确提取
+
+当只需要特定字段时，用 `--fields` 过滤，避免返回大量无关数据：
+
+```bash
+# 5 条 + 仅提取展示字段和关联 ID
+people-cli hire +interview-task-list --page-size 5 --fields interview_id,job_id,talent_id,application_id,interview,application,talent
+
+# 只提取待评价的面试摘要
+people-cli hire +interview-task-list --status 待评价 --fields interview_id,talent,application
+
+# 提取面试时间摘要
+people-cli hire +interview-task-list --fields talent,interview
+
+# 给后续笔试查询取投递 ID，ID 只作内部关联，不展示给用户
+people-cli hire +interview-task-list --fields application_id,candidate,job,interview --limit 100 --scan-page-limit 10
+```
+
+> **提示**：`--fields` 使用稳定字段别名，如 `interview_id`、`application_id`、`talent`、`interview`、`application`，不要手写 jq 路径。
+
+## 示例
+
+```bash
+# 查询当前用户面试任务摘要（默认 5 条 + 默认表格输出）
+people-cli hire +interview-task-list --page-size 5
+
+# 只查询待我面试/未开始的面试任务
+people-cli hire +interview-task-list --pending-interview
+
+# 只查询待评价的面试任务
+people-cli hire +interview-task-list --status 待评价
+
+# 按候选人或职位关键词在我的面试任务中查询
+people-cli hire +interview-task-list --keyword 蒋零零 --fields application_id,talent_id,candidate,job,interview
+
+# 查询已结束但待提交评价的面试
+people-cli hire +interview-task-list --status 待评价 --ended --limit 5
+
+# 查看本月我的面试数量
+people-cli hire +interview-task-list --month 本月 --mode count
+
+# 查看近两个月我的面试任务，时间由 CLI 换算
+people-cli hire +interview-task-list --start-time 近两个月 --end-time 今天 --fields application_id,candidate,job,interview
+
+# 只查询已评价的面试任务
+people-cli hire +interview-task-list --status 已评价
+
+# 用户明确要求更多条数时再调整分页大小
+people-cli hire +interview-task-list --page-size 20
+
+# 用户明确要求继续时再翻页
+people-cli hire +interview-task-list --page-token <token>
+
+# 获取完整未裁剪数据
+people-cli hire +interview-task-list --view full
+
+# 以表格格式输出
+people-cli hire +interview-task-list --format table
+```

package/skills/people-hire/references/people-hire-interview.md

@@ -0,0 +1,142 @@
+# interview
+
+## 这是"查面试信息"场景的核心模块，覆盖按投递或面试 ID 获取面试记录与面评信息。
+
+> **字段来源：** 本文中的输入输出字段以 `people-cli hire +interview-list --help` 为准；底层 schema 仅在 reference/help 未覆盖字段时用于核对。
+> **强制约束：** 面试记录列表必须使用 `people-cli hire +interview-list`，禁止直接调用原生 `people-cli hire interview list`。
+## 适用意图
+
+当用户出现以下表达时，优先使用本场景：
+
+- "查某次投递的面试记录"
+- "查某个 interview_id 的面试详情"
+- "基于面试记录继续查速记或新版面评详情"
+
+### 意图和命令索引
+
+| 用途 / 何时使用  | 命令                               | 说明                                                    |
+| ---------------- | ---------------------------------- | ------------------------------------------------------- |
+| 查询面试记录列表 | `people-cli hire +interview-list` | 可按 `application_id`、`interview_id`、时间范围筛选 |
+| 查询面试速记文本 | `people-cli hire +minutes-detail` | 需要先有 `interview_id`，详见 [`people-hire-minutes.md`](people-hire-minutes.md) |
+| 查询新版面评详情 | `people-cli hire +interview-record-detail` | 可传 `interview_record_id`，或在面试仅有一条面评记录时传 `interview_id`，详见 [`people-hire-interview-record.md`](people-hire-interview-record.md) |
+
+### 常见问法示例
+
+- "查这次投递的面试记录"
+- "看这个 `interview_id` 的面试详情"
+- "看这场面试的速记"
+- "看这条面评记录详情"
+
+### 面试查询调用流程
+
+1. **确认查询主键**
+   - 有 `interview_id` 时优先按 `interview_id` 查。
+   - 否则有 `application_id` 时按投递查对应面试列表。
+2. **执行查询**
+   - 使用 `people-cli hire +interview-list`，不要手写原生 `--params` / `--jq`。
+   - 默认 `--page-size 5`、`--view summary`；需要特定字段时用 `--fields`。
+   - 列表类查询默认只查当前页；如需查询后过滤、存在性判断、计数或聚合，使用 Shortcut 的 `--where` / `--mode` / `--limit` / `--scan-page-limit`。
+4. **按层级输出**
+   - 默认使用 Shortcut 裁剪视图，只取面试主信息，以及用于后续查询的 `interview_id`、`application_id` 等内部关联字段。
+   - 先输出面试主信息（时间、轮次、阶段、状态），默认不展示 ID。
+   - 如果当前页之外还有更多数据，CLI/Shortcut 输出的 `page_token` 供 skill/agent 内部继续翻页；最终回复用户时只提示"还有更多数据"，不要展示 `page_token`。
+   - 如果用户明确指定查询后过滤条件（如 `XX天内`、`全部`、`XX状态`、`我的XXX`），使用 Shortcut 受控扫描参数；不要手动循环 `page_token`。
+   - `+interview-list` 的 summary 会保留 `Interview ID`、`Interview Record IDs`、`Interviewers`、`Record Status Summary` 以及提交/未提交数量，供判断每轮是否有面评；默认回复用户时不要展示这些 ID。只有一条面评记录时可把 `Interview ID` 传给 `+interview-record-detail --interview-id`；有多条时必须明确传 `--interview-record-id`。
+5. **按需衔接新接口**
+   - 用户要"面试速记 / 逐字稿 / 根据速记生成面评初稿"时，切到 [`people-hire-minutes.md`](people-hire-minutes.md)。
+   - 用户要"新版面试评价详情 / 面评内容 / 面试结论 / 面评打分"时，切到 [`people-hire-interview-record.md`](people-hire-interview-record.md)。只有一条面评记录时可用 `+interview-record-detail --interview-id <interview_id>`，有多条时要求明确指定 `--interview-record-id`。
+
+### 不要误走
+
+- 用户问"我的待评价面试"时，不要误走 `interview.list`，必须用 `+interview-task-list`。
+- 用户只有职位 ID 或人才 ID 时，不要直接猜测能查到唯一面试记录；优先通过投递链路拿到 `application_id`。
+- 用户只要单条面试的流程上下文时，不要只给面试记录，可根据需要继续衔接 `application.get`。
+- 用户要速记文本时，不要用 `+interview-list` 的字段编造，应使用 `+minutes-detail`。
+- 用户要新版面评详情时，不要把 `interview_id` 当成 `interview_record_id`；有 `interview_id` 时传 `+interview-record-detail --interview-id <interview_id>`。
+
+## 标准输入
+
+以下字段来自 `+interview-list`：
+
+| 参数                  | 对应接口字段  | 类型   | 说明                   |
+| --------------------- | ----- | ------ | ---------------------- |
+| `--page-size`         | `page_size` | int    | 默认 `5`，最大 `100` |
+| `--page-token`        | `page_token` | string | 翻页 token             |
+| `--application-id`    | `application_id` | string | 投递 ID                |
+| `--interview-id`      | `interview_id` | string | 面试 ID                |
+| `--start-time`        | `start_time` | string | 最早开始时间，支持毫秒时间戳或日期/相对时间字符串 |
+| `--end-time`          | `end_time` | string | 最晚开始时间，支持毫秒时间戳或日期/相对时间字符串 |
+| `--time-from` / `--start-date` | `start_time` | string | 最早开始时间别名，由 CLI 换算时间 |
+| `--time-to` / `--end-date` | `end_time` | string | 最晚开始时间别名，由 CLI 换算时间 |
+| `--job-level-id-type` | `job_level_id_type` | enum | `people_admin_job_level_id` / `job_level_id` |
+| `--user-id-type`      | `user_id_type` | enum | `user_id` / `union_id` / `open_id`，默认 `open_id` |
+| `--view`              | - | enum | `summary` 默认裁剪视图；`full` 原始字段视图 |
+| `--fields`            | - | string | 逗号分隔字段名，如 `interview_id,begin_time,round` |
+| `--where`             | - | string | 查询后过滤表达式 |
+| `--limit`             | - | int | 最多返回的匹配行数，默认等于 `--page-size` |
+| `--scan-page-limit`   | - | int | 查询后过滤最多扫描源页数 |
+| `--mode`              | - | enum | `list` / `exists` / `count` / `aggregate` |
+| `--group-by`          | - | string | `--mode aggregate` 时按哪个字段聚合 |
+
+## 标准输出
+
+`+interview-list --view summary` 默认返回以下稳定字段：
+
+| 字段                        | 类型   | 用途 | 说明                                                                  |
+| --------------------------- | ------ | ---- | --------------------------------------------------------------------- |
+| `id`                      | string | 内部关联 | 面试 ID，默认不展示                                                   |
+| `application_id`          | string | 内部关联 | 投递 ID，默认不展示                                                   |
+| `stage_id`                | string | 内部关联 | 面试关联阶段 ID，默认不展示                                           |
+| `stage`                   | object | 默认展示 | 阶段信息                                                              |
+| `begin_time`              | int    | 默认展示 | 面试开始时间（ms）                                                    |
+| `end_time`                | int    | 默认展示 | 面试结束时间（ms）                                                    |
+| `round`                   | int    | 默认展示 | 面试轮次                                                              |
+| `interview_round_summary` | int    | 默认展示 | 面试状态汇总                                                          |
+| `feedback_submit_time`    | int    | 按需展示 | 面评提交时间                                                          |
+| `interview_type`          | int    | 按需展示 | 面试类型                                                              |
+| `interview_record_list[].id` | string | 内部关联 | 面评记录 ID，Shortcut summary 映射为 `Interview Record IDs`，默认不展示 |
+| `interview_record_list[].interviewer` | object | 默认摘要 | Shortcut summary 映射为 `Interviewers` |
+| `interview_record_list[].commit_status` | int/string | 默认摘要 / 过滤 | Shortcut summary 映射为 `Record Status Summary`、`Submitted Record Count`、`Unsubmitted Record Count` |
+
+> `+interview-list` summary 只保留面试主信息、面试官和面评提交状态摘要；需要新版面评详情时，单条面评记录可使用 `+interview-record-detail --interview-id <interview_id>`，多条记录必须明确传 `--interview-record-id`。
+
+分页状态字段（CLI/Shortcut 需要输出给 skill/agent 内部判断和续查，默认不对用户展示 `page_token`）：
+
+| 字段           | 类型   | 说明         |
+| -------------- | ------ | ------------ |
+| `has_more`   | bool   | 是否有下一页 |
+| `page_token` | string | 内部翻页 token，CLI 可见，最终回复用户时默认隐藏 |
+
+## 所需权限
+
+| 方法               | Scope                       |
+| ------------------ | --------------------------- |
+| `interview.list` | `hire:interview:readonly` |
+
+## 示例
+
+```bash
+# 按投递 ID 查询面试记录
+people-cli hire +interview-list --application-id 7046315599510833452 --page-size 5
+
+# 按 interview_id 精确查询
+people-cli hire +interview-list --interview-id 6989202908470446380 --page-size 5
+
+# 按面试开始时间范围查询
+people-cli hire +interview-list --time-from 1704067200000 --time-to 1706659200000 --page-size 5
+
+# 只取 AI 需要消费的字段，避免手写 jq
+people-cli hire +interview-list --application-id 7046315599510833452 --fields interview_id,application_id,stage,begin_time,end_time,round
+
+# 查看每轮面试是否已有面评
+people-cli hire +interview-list --application-id 7046315599510833452 --fields stage,round,interviewers,record_status_summary,submitted_record_count,unsubmitted_record_count
+
+# 用户明确要求完整结构时
+people-cli hire +interview-list --interview-id 6989202908470446380 --view full --format json
+```
+
+## 选路提醒
+
+- 查询"我的待办面试"时必须用 `+interview-task-list`，不要误用 `+interview-list`。
+- `+interview-list` 是记录视角，不等价于任务待办视角。
+- `+minutes-detail` 和 `+interview-record-detail` 是更细的下钻接口；拿到对应 ID 后按需调用，最终可见数据仍由服务端权限控制。

package/skills/people-hire/references/people-hire-job-process.md

@@ -0,0 +1,92 @@
+# job-process
+
+招聘流程查询场景，覆盖招聘流程列表和阶段配置。
+
+> **字段来源：** 本文中的输入输出字段以 `people-cli hire +job-process-list --help` 为准；底层 schema 仅在 reference/help 未覆盖字段时用于核对。
+> **强制约束：** 招聘流程列表必须使用 `people-cli hire +job-process-list`，禁止直接调用原生 `people-cli hire job-process list`。
+
+## 适用意图
+
+当用户出现以下表达时，优先使用本场景：
+
+- "查招聘流程"
+- "有哪些招聘流程"
+- "查看流程阶段 / 阶段列表"
+- "这个流程包含哪些阶段"
+
+## 意图和命令索引
+
+| 用途 / 何时使用 | 命令 | 说明 |
+| --- | --- | --- |
+| 查询招聘流程列表与阶段配置 | `people-cli hire +job-process-list` | 返回流程名称、流程类型、阶段列表 |
+
+## 固定查询流程
+
+1. **确认是流程配置视角**
+   - 用户问流程、阶段配置、流程类型时走本接口。
+   - 用户问某职位的招聘进度时，优先走 `+job-detail` 或投递链路，不要误用流程配置接口。
+2. **执行查询**
+   - 使用 `people-cli hire +job-process-list`，不要手写原生 `--params` / `--jq`。
+   - 默认 `--page-size 5`、`--view summary`；需要特定字段时用 `--fields`。
+   - 列表类查询默认只查当前页；如需按流程类型、阶段名称等返回字段过滤、计数或聚合，使用 Shortcut 的 `--where` / `--mode` / `--limit` / `--scan-page-limit`。
+4. **结构化输出**
+   - 默认展示流程中文名、英文名、流程类型、阶段名称与阶段类型。
+   - `id`、阶段 `id` 默认仅作内部关联，不直接展示。
+   - 如果还有更多数据，CLI/Shortcut 输出的 `page_token` 供 skill/agent 内部继续翻页；最终回复用户时只提示"还有更多数据"，不要展示 `page_token`。
+
+## 标准输入
+
+| 参数 | 对应接口字段 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `--page-size` | `page_size` | int | 默认 `5`，最大 `100` |
+| `--page-token` | `page_token` | string | 翻页 token |
+| `--view` | - | enum | `summary` 默认裁剪视图；`full` 原始字段视图 |
+| `--fields` | - | string | 逗号分隔字段名，如 `process_id,process_type,stages` |
+| `--where` | - | string | 查询后过滤表达式，如 `process_type=社招` |
+| `--limit` | - | int | 最多返回的匹配行数，默认等于 `--page-size` |
+| `--scan-page-limit` | - | int | 查询后过滤最多扫描源页数 |
+| `--mode` | - | enum | `list` / `exists` / `count` / `aggregate` |
+| `--group-by` | - | string | `--mode aggregate` 时按哪个字段聚合 |
+
+## 标准输出
+
+`+job-process-list --view summary` 默认返回以下稳定字段：
+
+| 字段 | 类型 | 用途 | 说明 |
+| --- | --- | --- | --- |
+| `process_id` | string | 内部关联 | 流程 ID，默认不展示 |
+| `chinese_name` / `zh_name` | string | 默认展示 | 中文名称 |
+| `english_name` / `en_name` | string | 默认展示 | 英文名称 |
+| `process_type` | int/string | 默认展示 | 流程类型，`1`=社招流程，`2`=校招流程 |
+| `stages` / `stage_list` | string/array | 默认展示 | 阶段列表 |
+
+分页状态字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `has_more` | bool | 是否有下一页 |
+| `page_token` | string | 内部翻页 token，CLI 可见，最终回复用户时默认隐藏 |
+
+## 所需权限
+
+| 方法 | Scope |
+| --- | --- |
+| `job-process.list` | `hire:job_process:readonly` |
+
+## 示例
+
+```bash
+# 查询招聘流程列表
+people-cli hire +job-process-list --page-size 5
+
+# 只取流程类型和阶段
+people-cli hire +job-process-list --fields process_id,process_type,stages
+
+# 用户明确要求完整结构时
+people-cli hire +job-process-list --view full --format json
+```
+
+## 选路提醒
+
+- 本接口返回的是流程配置，不是某个职位或投递的实时进度。
+- 用户问具体职位进展时，先用 `+job-detail`、投递列表 Shortcut `+application-list` 或投递详情接口。