weaver-work-cli 0.1.40 → 0.1.44

package/skills/weaver-e10-recruit-stage/references/position-templates.md

@@ -0,0 +1,202 @@
+# 岗位模板库（position-templates）
+
+> **用途**：`recruit-stage.jd.create.*` 生成 JD 时，直接从本文件取岗位写法与字段范式，**不再运行时拉取「最近同类职位参考」**。
+> **收益**：省掉 6 次接口请求（列表 1 次 + 详情 5 次），prepare 从约 10.7 秒降到 3 秒内；同时避免脏数据污染新职位字段。
+> **数据来源**：2026-11-05 对当前环境 836 条职位抽样 100 条统计（分布见文末「环境观测」），岗位分类按实测出现频次归纳，非臆测。
+> **维护约定**：公司招聘口径调整时直接改本文件；新增岗位类型追加模板段落即可，不改脚本。
+
+---
+
+## 一、通用字段范式（实测统计得出）
+
+| 字段 | 推荐默认 | 实测依据 |
+|---|---|---|
+| 岗位性质 `position_nature` | **全职**（实习岗选「实习」） | 抽样 100 条中全职 79 条、实习 21 条 |
+| 招聘人数 `recruit_count` | **1** | 抽样中 1 人占 67%、2 人占 19% |
+| 状态 `status` | 招聘中 | 新发布岗位固定用此值 |
+| 招聘类型 `recruit_type` | 社会招聘（实习岗可考虑校园/实习） | — |
+| 薪酬类型 `salary_type` | 月薪 | — |
+| 薪酬月数 `number_of_pay_months` | 12 | — |
+| 招聘负责人 / 用人经理 | 当前登录人 | 由脚本自动填充，模板不指定 |
+
+> **薪资区间按本文件 §1.1 的推荐表取值**（不再从历史职位继承——历史记录可能带脏数据，实测抓到过 300 元月薪）。
+> 用户没说薪资时：按岗位类型 + 经验年限取推荐区间，填进 `sets` 的 `salary_min`/`salary_max`（单位**元/月**，如 15K 写 `15000`），
+> 并在确认摘要里注明「薪资为推荐值」请用户确认；用户明确给了数字就以用户为准。
+
+> ⚠️ **枚举类字段必须与环境字典对齐，否则会被静默跳过**（2026-11-05 实测：`work_years=1年以上` 字典无此选项 → 进 `setSkipped`）：
+> - `work_years`（经验年限）：**优先用「不限」**（已实测可用）；写具体年限前先确认本环境该字段的实际选项值。
+> - `work_location`（工作地点）：✅ **v1.0.20 起可通过 `sets` 指定**——原实现只读 `cache.menus`（该环境缓存无此字段）导致恒取不到，现改为 `lists.all_search` → `cache.menus` → `allMenus` 三级来源；实测传入完整地址后进入 `setApplied`。⚠️ 提交后必须检查 `setApplied`/`setSkipped`，`setSkipped` 非空即未写入；未指定时该字段仍会从历史职位继承，摘要里要核对。
+> - `education`（学历）：用裸名称（「本科」「硕士」），已实测可用。
+>
+> 提交 `sets` 时**务必检查返回的 `setApplied` / `setSkipped`**：`setSkipped` 非空说明该值没写进去，需换值或改用完整名称重试。
+
+---
+
+### 1.1 薪资推荐区间（`salary_min` / `salary_max`）
+
+> **用途**：用户未提薪资时，按「岗位类型 + 经验年限」从本表取推荐区间，填入 `sets` 的 `salary_min`/`salary_max`，并在确认摘要写明「薪资为推荐值」让用户确认。
+> **单位**：元/月（月薪 15K 写 `15000`）。环境字段是数值型，**不要写 "15K" 或 "15000-20000" 这类字符串**。
+> **口径**：ToB 软件/信息化行业、国内一二线城市的常见区间初稿（2026-11）。**换城市/换行业需按当地行情校准**；本表由业务维护，改表即可、不改脚本。
+
+| 岗位模板 | 经验档 | `salary_min` | `salary_max` | 说明 |
+|---|---|---|---|---|
+| Java / 后端开发 | 1-3 年 | 12000 | 18000 | 初级 |
+| Java / 后端开发 | 3-5 年 | 18000 | 30000 | 中级（**默认档**）|
+| Java / 后端开发 | 5 年以上 | 30000 | 45000 | 高级 / 技术负责人 |
+| 实施工程师 | 1-3 年 | 8000 | 13000 | 初级 |
+| 实施工程师 | 3-5 年 | 13000 | 20000 | 中级（**默认档**）|
+| 实施工程师 | 5 年以上 | 20000 | 30000 | 高级 / 项目负责人 |
+| 项目经理 | 3-5 年 | 15000 | 22000 | 中级 |
+| 项目经理 | 5 年以上 | 22000 | 35000 | 高级（**默认档**）|
+| 销售 / 客户经理 | 不限 | 8000 | 15000 | **底薪**，提成另议；摘要里必须注明「仅底薪」 |
+| 实习生 | 在校 | 100 | 200 | **元/天**，`salary_type` 取「日薪」，摘要注明「日薪」 |
+
+> ⚠️ **岗位归属不确定时用「中级（默认档）」并在摘要说明**——不要空着不填（空着会落到历史职位继承，可能带出脏数据），也不要擅自给高档。
+> ⚠️ **销售岗只填底薪**：`salary_min/max` 是底薪区间，提成规则写进 JD 正文，不折算进数值。
+> ⚠️ **`work_years`（经验年限）字段本身**按环境字典填（优先「不限」，已实测可用），本表的「经验档」只用于选薪资档，不直接写入该字段。
+
+
+## 二、岗位模板
+
+### 模板 1：Java / 后端开发工程师（技术类）
+
+**适用**：Java 开发、后端开发、项目开发工程师、FDE 工程师
+
+**职责要点**（4-6 条，按需裁剪）
+1. 负责核心业务系统的后端服务设计与开发，保障系统高可用与高性能运行
+2. 主导关键模块的技术方案设计、评审与落地，输出可维护的技术文档
+3. 负责核心接口与数据模型设计，保障数据一致性与安全性
+4. 参与系统性能优化与线上问题排查，降低故障率与响应时延
+5. 参与技术选型与框架演进，推动技术栈统一与升级
+6. 参与代码评审并指导中初级开发人员，提升团队交付质量
+
+**要求要点**（4-6 条）
+1. 本科及以上学历，计算机、软件工程等相关专业
+2. 精通 Java，熟悉 JVM 原理、多线程与并发编程，具备扎实的数据结构与算法基础
+3. 熟练使用 Spring Boot、Spring Cloud 等主流框架，具备微服务架构实践经验
+4. 熟悉 MySQL、Redis、消息队列等常用中间件，具备数据库设计与性能调优能力
+5. 具备良好的系统设计能力与问题定位能力，能独立承担核心模块开发
+6. 具备良好的沟通协作能力与责任心，有带教经验者优先
+
+**推荐字段**：岗位性质=全职｜招聘人数=1｜学历=本科及以上｜经验=3年以上（高级岗可写 5 年以上）｜职位类别=技术
+
+---
+
+### 模板 2：实施工程师（交付类）
+
+**适用**：实施工程师、项目实施工程师、交付顾问
+
+**职责要点**
+1. 负责客户现场 OA/协同办公系统的实施交付，包括环境搭建、配置调试与上线支持
+2. 对接客户业务部门，梳理业务流程并转化为系统配置方案
+3. 负责系统功能配置、表单与流程搭建，完成客户化需求落地
+4. 开展用户培训与操作指导，编写实施文档与操作手册
+5. 负责上线后的问题响应与运维支持，保障系统稳定运行
+6. 配合项目经理推进项目进度，反馈实施风险
+
+**要求要点**
+1. 本科及以上学历，计算机、信息管理等相关专业
+2. 熟悉数据库基本操作（SQL 查询、数据维护），具备系统实施或运维经验
+3. 具备良好的沟通表达能力，能与客户业务部门有效对接
+4. 具备较强的问题分析与现场应变能力，能适应出差
+5. 有 OA、ERP 等企业管理软件实施经验者优先
+6. 具备良好的服务意识与责任心，能承受一定工作压力
+
+**推荐字段**：岗位性质=全职｜招聘人数=2｜学历=本科及以上｜经验=1年以上｜职位类别=技术
+
+---
+
+### 模板 3：项目经理（管理类）
+
+**适用**：项目经理、项目负责人、交付经理
+
+**职责要点**
+1. 负责项目全生命周期管理，包括立项、计划制定、进度跟踪与验收交付
+2. 统筹项目资源，协调实施、开发、测试等角色，保障项目按期交付
+3. 对接客户关键干系人，管理需求边界与变更，控制项目风险
+4. 负责项目成本与质量的平衡管控，及时识别并上报重大风险
+5. 组织项目例会与阶段汇报，输出项目周报、阶段总结与验收文档
+6. 推动项目复盘与经验沉淀，持续优化交付流程
+
+**要求要点**
+1. 本科及以上学历，计算机、项目管理等相关专业
+2. 具备 3 年以上软件项目实施或项目管理经验，独立负责过完整项目交付
+3. 熟悉项目管理方法论，具备进度、成本、质量、风险的统筹能力
+4. 具备优秀的客户沟通与干系人管理能力，能处理复杂现场情况
+5. 持有 PMP、信息系统项目管理师等证书者优先
+6. 具备较强的抗压能力与责任心，能适应短期出差
+
+**推荐字段**：岗位性质=全职｜招聘人数=1｜学历=本科及以上｜经验=3年以上｜职位类别=技术
+
+---
+
+### 模板 4：销售 / 客户经理（销售类）
+
+**适用**：软件销售、销售代表、客户经理、城市负责人、EBU 负责人
+
+**职责要点**
+1. 负责所辖区域或行业客户的 OA/协同管理软件销售，完成销售业绩指标
+2. 开拓新客户资源，建立并维护客户关系，挖掘客户信息化需求
+3. 对接客户决策层，推动商机立项、方案汇报与商务谈判
+4. 协同售前、实施团队完成方案设计与投标响应
+5. 负责合同签订、回款跟进与客户满意度维护
+6. 收集市场与竞品信息，反馈市场动态支持产品与策略优化
+
+**要求要点**
+1. 本科及以上学历，市场营销、计算机等相关专业
+2. 具备 2 年以上 B 端软件或解决方案销售经验，有独立成单能力
+3. 熟悉企业信息化产品，能快速理解客户业务场景
+4. 具备优秀的商务谈判与客户关系维护能力
+5. 具备较强的目标导向与自我驱动力，能承受业绩压力
+6. 有 OA、ERP、CRM 等行业客户资源者优先
+
+**推荐字段**：岗位性质=全职｜招聘人数=1｜学历=本科及以上｜经验=2年以上｜职位类别=销售
+
+---
+
+### 模板 5：实习生岗（通用）
+
+**适用**：各类实习岗（开发实习、实施实习、客服实习等）
+
+**职责要点**（按方向裁剪）
+1. 协助团队完成日常业务工作，参与项目执行与文档整理
+2. 在指导下完成分配的具体任务，按时交付并主动反馈进展
+3. 参与团队会议与业务学习，快速熟悉公司产品与业务流程
+4. 完成上级交办的其他支持性工作
+
+**要求要点**
+1. 本科及以上在读，每周可保证 4 天以上实习时间，实习期 3 个月以上
+2. 具备良好的学习能力与主动性，能快速上手新任务
+3. 具备良好的沟通协作能力与责任心
+4. 熟练使用 Office 等办公软件
+5. 有相关项目或实习经历者优先
+
+**推荐字段**：岗位性质=**实习**｜招聘人数=1｜学历=本科及以上｜经验=不限｜职位类别=按方向选择
+
+---
+
+## 三、使用方式
+
+生成 JD 时：
+
+1. **先判断岗位归属**：技术 / 交付 / 管理 / 销售 / 实习
+2. **取对应模板的职责与要求**，按用户实际需求裁剪条数（职责 4-6 条、要求 4-6 条）
+3. **字段值直接采用模板「推荐字段」**，涉及薪资时向用户确认，不使用默认值
+4. 用户明确提出与本模板不同的要求时，**以用户为准**，模板只作起点
+
+> 若岗位明显不属于以上五类（如财务、行政、法务），按 `recruit-jd-template.md` 的通用兜底结构生成，不必强行套用。
+
+---
+
+## 四、环境观测（2026-11-05 实测，供参考不复用为默认值）
+
+抽样 100 条 / 系统共 836 条职位：
+
+| 维度 | 分布 |
+|---|---|
+| 岗位性质 | 全职 79、实习 21 |
+| 状态 | 招聘中 49、待发布 49、招聘结束 2 |
+| 招聘人数 | 1 人 67、2 人 19、10 人 8、3 人 3、5 人 1、6 人 1、30 人 1 |
+| 名称重复度 | 100 条中仅 60 个不同名称；"舟山民宿管家" 30 条、"蓝堡舟山普陀区蓝堡" 35 条 |
+
+> ⚠️ **该环境存在大量重复与疑似测试数据**。这正是取消「运行时拉取同类职位作参考」的直接原因——照此取默认值会把重复地点/名称带进新职位。模板库采用人工归纳口径，不依赖该数据分布。

package/skills/weaver-e10-recruit-stage/references/recruit-arrange-interview.md

@@ -0,0 +1,322 @@
+---
+name: recruit-arrange-interview
+description: 创建面试安排，支持现场、电话、视频、AI 面试方式（saveFormData + assignedInterview）
+---
+
+# 安排面试
+
+> **平台兼容**：本文命令示例在 macOS/Linux 与 Windows PowerShell 下均可执行——JSON 用单引号包裹、内部双引号不转义；PowerShell 下不使用反斜杠续行。
+> 本文档中的 `${...}` 形参（表单 objId / 布局 formId / 列表 listId / EB 页面 viewId·pageId / 应用 appId / 动作流 id / 菜单 id cusMenuId）为**租户相关值**：表单 objId 与布局 formId 同由 `getObjsByTag` 一次返回；列表/页面/菜单 id 由部署参数提供（**可经 `allMenus` 菜单树自动发现**，见 `recruit-resolve-metadata.md` §3.1）；**字段 id（`formField.id`）经 `ds/fields` 运行时解析，不写死**（见 `recruit-resolve-metadata.md` §5）。
+
+## 1. 基础信息
+- 接口名称：安排面试（与页面「保存」按钮**等价的动作链**：系统保存 → 各 esb 动作流 → 分配面试 → AI 面试提醒）
+- 请求方式：`POST`
+- 去域名路径：
+  - ① `/api/ebuilder/form/form/core/saveFormData`（保存面试计划表单，formId 见 recruit-resolve-metadata.md）
+  - ② 表单「保存」按钮 actions[] 中的 `actionType=esb` 动作 → `/api/ebuilder/form/esb/runEsb`（按 `showOrder` 顺序逐条执行；**id 运行时解析，不写死**，见 §4.4）
+  - ③ 表单「保存」按钮 actions[] 中的 `actionType=jsCode` 动作（典型实现即调 `/api/recruit/candidate/assignedInterview`）→ 技能侧等价调用该接口（见 §4.5）
+  - 辅助（可选）：`GET /api/ebuilder/form/obj/getObjsByTag?appId={appId}&tag=uf_rcrt_interview_plan`（一次取得面试计划 `objId` 与布局 `formId`；字段 id 经 `ds/fields` 解析）
+  - 辅助（动作链解析）：`POST /api/ebuilder/form/data/getFormButtons`（body 带 `objId` + `layoutId`，取「保存」按钮的 `actions[]`）
+- 所属模块：招聘管理（recruit）
+- 所属分组：面试 / 写操作
+
+## 2. 业务用途
+用户说"给 X 安排一场面试""约个现场/电话/视频/AI 面试""安排面试官 Y 面试 Z"时调用。先保存面试计划（含主题、时间、方式、面试官、职位/应聘者），再按页面「保存」按钮配置的动作链逐条执行（新建日程、分配面试、AI 面试提醒等），使其与人工点保存的结果一致。属写操作，**必须先展示摘要并获明确确认后再提交**。
+
+> **定位候选人**：`--prepare/--commit/--prefill` 均可不带 `--talent-id`，直接 `--mobile <手机号>` 或 `--name <姓名>`（人才库检索；唯一命中自动采用，多条输出 candidates 交用户选择，exit 3）。
+
+## 3. 前置条件
+- 已安装招聘服务（第 0 步闸门通过）。
+- **定位前置（必做）**：写操作前必须先按手机号（叠加姓名/渠道缩小范围）搜索定位候选人（`recruit-search-candidate`）拿到 `talentId` 与应聘批次；命中 0 条→提示未找到、不臆测；命中多条→列出候选清单（姓名/手机/渠道/状态/创建时间/`talentId`）请用户确认，**绝不自动取第一条**（写操作选错对象后果不可逆）。消歧规则见 SKILL.md「自然语言 → 参数映射」。
+- 需目标应聘者 `talentId`（来自搜索/详情）与职位 `positionManageId`（来自职位列表/详情）；面试官为人员门户字段，传其 `userId`（名称→ID 用 `browser/complete/resource` 解析）。
+- 应聘管理记录 id（`candidate_manage_id`）通常与 `talentId` 的应聘批次对应（新建应聘者后即生成；见 §4.3 字段表）。
+- 第①步保存面试计划后拿到 `formDataId`（= 面试计划记录 id），第②③步均依赖它。
+
+## 3.1 字段联动与显示属性联动（EB 能力，运行时获取，不写死）
+面试计划表单用 EB 搭建，字段联动/显示属性联动由表单设计声明，Agent **不写死、不臆造**，统一走运行时获取：
+- `GET /api/ebuilder/form/form/core/getFormLayout?formId=<面试计划表单id>` 返回 `linkageActions`（字段联动）与 `viewLinkages`（显示属性联动：某字段值决定另一字段是否显示/必填/只读）。**部分环境上 GET 返回 405**，需用 POST 同路径（body 带 `module`）；`write-op.mjs::getFormLayout/getFormLayoutMeta` 已做 GET→POST 回退，调用方直接用即可。
+- 运行时联动计算：`POST /api/ebuilder/form/form/linkage/executeFdLinkage`（接口存在），传入联动 id 与上下文返回推导结果。
+- **处理原则**：提交前若不确定某字段是否联动/必填依赖（如"选了某面试方式才要求填地点"），先调 `getFormLayout` 读取声明；选项类联动值用 `executeFdLinkage` 计算后填入；遇到"选 A 才显 B"时先向用户收集 A 再展示 B，不一次性把所有字段甩给用户、也不瞎编联动结果。
+
+## 4. 请求参数
+
+### 4.1 第①步 saveFormData（Query）
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `formId` | query | string | 是 | 面试计划表单 id（运行时解析，见 recruit-resolve-metadata.md） |
+
+### 4.2 第①步 saveFormData（Body 结构，同新建应聘者）
+| 字段 | 位置 | 类型 | 必填 | 说明 |
+|---|---|---|---|---|
+| `module` | body | string | 是 | `ebuilderform` |
+| `appId` | body | string | 是 | 安装闸门 `data[0]` |
+| `customParam.objId` | body | string | 是 | 面试计划对象 id（运行时解析，见 recruit-resolve-metadata.md） |
+| `formData.module` | body | string | 是 | `ebuilderform` |
+| `formData.client` | body | string | 是 | `pc` |
+| `formData.dataStatus` | body | string | 是 | `submit` |
+| `formData.form.id` | body | string | 是 | 面试计划表单 id（同 query `formId`） |
+| `formData.formLayout.id` | body | string | 是 | 面试计划表单布局 id（运行时解析，见 recruit-resolve-metadata.md） |
+| `formData.dataDetails` | body | array | 是 | 各业务字段（见 4.3） |
+
+### 4.3 面试计划表单字段（dataDetails，全字段）
+| 字段 id（运行时解析） | 含义 | 必填 | 值形态（示例） |
+|---|---|---|---|
+| `<面试主题字段id>` | 面试主题 | 是 | `content`（如 `AI工程师-高刚的面试`）；**无职位回退（script 版）**：候选人未挂应聘职位（`positionManageId` 解析不到）时，主题取 `姓名+的面试`，**不得拼出 `undefined-…`/`null-…` 前缀**（新建未挂职位的候选人生成主题时该情况常见） |
+| `<开始时间字段id>` | 开始时间 | 是 | `content`（`2026-08-06 10:30`） |
+| `<结束时间字段id>` | 结束时间 | 是 | `content`（`2026-08-06 11:30`） |
+| `<面试方式字段id>` | 面试方式 | 是 | `dataOptions`（现场面试/视频面试/电话面试/AI面试） |
+| `<面试类型字段id>` | 面试类型 | 是 | `dataOptions`（初试/复试…） |
+| `<面试轮次字段id>` | 面试轮次 | 否 | `dataOptions`（第一轮…） |
+| `<面试官字段id>` | 面试官 | 是 | `dataOptions[].optionObj{userId,name}` |
+| `<应聘职位字段id>` | 应聘职位 | 是 | `dataOptions[].optionId` = `positionManageId` |
+| `<面试地点字段id>` | 面试地点 | 否 | `dataText` |
+| `<手机字段id>` | 手机 | **是（脚本强制）** | `content`：从人才基本信息 `telephone` 取值**显式写入**（页面按 talent_id 联动带出，直接 saveFormData 不会自动带） |
+| `<邮箱字段id>` | 邮箱 | **AI面试必填** | `content`：从人才基本信息 `email` 取值**显式写入**；AI面试服务端按邮箱发通知/录屏链接，缺失则**阻断**（支持 `--email` 当场补录） |
+| `<AI面试方案字段id>` | AI面试方案（`digital_id`） | **AI面试必填** | `dataOptions`：`optionId` = 面试数字人配置表记录的 `form_data_id`；来源见 §4.7（未指定时列出候选让用户选，**不自动取第一条**） |
+| `<人才字段id>` | 人才（talent_id） | 是 | `dataOptions[].optionId` = `talentId` |
+| `<应聘管理字段id>` | 应聘管理（candidate_manage_id） | 是 | `dataOptions[].optionId` = 应聘批次记录 id |
+| `<邮件模板字段id>` | 邮件模板 | 否 | `dataOptions`（默认模板） |
+| `<通知内容字段id>` | 通知内容 | 否 | `dataText`（支持 `{面试方式}` `{开始时间}` `{应聘岗位}` 等占位符） |
+| `<状态字段id>` | 状态 | 否 | `dataOptions`（未开始） |
+| `<反馈状态字段id>` | 反馈状态 | 否 | `dataOptions`（未反馈） |
+| `<系统/开关字段id>`（多个） | 系统/开关字段 | 否 | 照抄表单默认值（默认/关闭/是/0/3 等） |
+
+> 字段 id 不写死：经 `recruit-resolve-metadata.md` §5 的 `ds/fields` 按 `config.dataKey` 解析（结果已并入环境缓存 `fields[objId]` 的 `{dataKey: fieldId}`）。解析不到时停止，不得臆造 fieldId。
+
+> 面试方式枚举：**一律经 `ds/options` 运行时解析，不写死**（实测示例：现场面试=`841052191228968963`、电话面试=`841052191228968961`、视频面试=`841052191228968962`、**AI面试=`841052191228968964`**；各环境/版本可能不同，以实际返回为准）。面试环节/轮次同理，不写死。
+
+### 4.4 动作链中的 esb 动作（runEsb）
+| 字段 | 位置 | 类型 | 必填 | 说明 |
+|---|---|---|---|---|
+| `objId` | query | string | 是 | 面试计划对象 id（运行时解析，见 recruit-resolve-metadata.md） |
+| `dataIds` | body | string | 是 | 第①步返回 `formDataId` |
+| `esbActionIds` | body | string | 是 | **「保存」按钮 actions[] 里 `actionType=esb` 的动作 id**（按 `showOrder` 顺序逐条触发） |
+| `objId` | body | string | 是 | 同 query |
+
+> 注：**不写死**任何 `esbActionIds`。运行时 `getFormButtons(objId, layoutId)` 取 `buttonKey=save` 的按钮，读其 `actions[]`（见 §4.6）——动作数量与名称因环境/版本而异（如「面试管理-新建日程」「AI面试时发送提醒」），有多少条执行多少条。
+
+### 4.5 动作链中的 jsCode 动作 → assignedInterview（分配面试）
+| 字段 | 位置 | 类型 | 必填 | 说明 |
+|---|---|---|---|---|
+| `formDataId` | query | string | 是 | 第①步返回 `data.id`（面试计划记录 id） |
+
+> **无请求体**（POST 仅 Query 传 `formDataId`）。
+> 页面「保存」按钮用一段 jsCode 动作（名称如「安排面试后续动作API」）调本接口；脚本**不执行页面脚本**，而是识别 `ecode` 中的 `/api/recruit/candidate/assignedInterview` 并**等价调用**，位置严格按该动作的 `showOrder`。
+
+### 4.6 「保存」按钮动作链（与页面点保存等价，核心契约）
+页面点「保存」不是只调一次 `saveFormData`，而是**依次执行按钮配置里的整串动作**。抓包实证（2026-08-17）：
+| showOrder | 动作名 | actionType | 实际请求 |
+|---|---|---|---|
+| 0 | 保存 | system | `saveFormData` |
+| 1 | 面试管理-新建日程 | esb | `runEsb`（esbActionIds=动作 id） |
+| 2 | 安排面试后续动作API | jsCode | `assignedInterview?formDataId=…`（脚本内 ecode 显式调用） |
+| 3 | AI面试时发送提醒 | esb | `runEsb`（esbActionIds=动作 id） |
+
+> 某环境实测（2026-10-21）动作链是 4 条，且多一条「**创建视频会议**」：新建日程 → 创建视频会议 → 面试安排后续动作API → AI面试时发送提醒。
+> **另一环境实测（2026-10-21）也是 4 条，但第 4 条是「面试管理-新建EB日程」**（8 月抓包时只有 3 条，说明期间配置有更新）。
+> 结论：**条数与名称随环境、随配置变更而变化**，一律以 `getFormButtons` 返回为准，不得按名称写死执行清单。
+
+**技能执行规则**
+1. `getFormButtons` 取 `buttonKey=save` 的按钮 → `actions[]` 按 `showOrder` 升序（跨环境自适应，不写死 id / 名称 / 条数）；
+2. **`enable=0` 的动作一律跳过**（页面上被禁用的动作不会执行，脚本也不能执行；实测人才表单 7 条动作里 3 条为禁用态）；
+3. 跳过 `actionType=system`（已由第①步 `saveFormData` 完成）；
+4. `actionType=esb` → `runEsb`，**逐条按序**；任一失败即中断并报错（与页面一致，后续动作不再执行）；
+5. `actionType=jsCode` 且 `ecode` 含 `assignedInterview` → 等价调用；**其它自定义 jsCode 无法等价执行 → 跳过并写入 `warnings`**（不静默）；
+6. 若整串动作里**没有** `assignedInterview`（部分环境未把它配成保存动作）→ 在动作链之后**兜底调用一次**并写入 `warnings`；
+7. `--skip-save-actions` 仅用于排查：只保存表单、不执行任何后续动作（记录不进入面试流程）。
+
+> 说明：面试通知由**服务端动作流**发出（不是技能自己拼消息）。技能只要把 `esb` 动作按页面顺序触发，通知/日程/AI 面试提醒就与人工点保存完全一致。
+
+### 4.7 AI面试方案（面试数字人配置表）：运行时定位 + 必填选择
+
+**为什么必须动态**：`digital_id` 的候选来自「面试数字人配置」列表，该表在不同环境 **objId / listId / 记录 id 全不同**（某环境实测 listId=`1274931191811432873`、objId=`1274931183271831435`，不同环境完全不同）。
+
+**定位链路（全部运行时解析，不写死）**
+1. **首选：关联字段候选接口**（不依赖菜单/列表，标准包未配菜单也能用）
+   `POST /api/ebuilder/form/common/browser/complete/ebuilder`
+   ```json
+   { "browserMultiple": false, "newly": 1, "searchValue": "",
+     "formParam": "{\"formId\":\"<面试计划formId>\",\"layoutId\":\"<layoutId>\",\"fieldId\":\"<digital_id字段id>\",\"filterItems\":[],\"module\":\"ebuilderform\",\"dataDetails\":[]}",
+     "openScroll": true, "controlId": "<digital_id字段id>", "businessId": "<formId>", "variableMap": {} }
+   ```
+   响应 `data.data[] = { id, name, ebObjId }`，`id` 即提交用的 `optionId`，`name` 即方案名。
+2. **兜底：菜单列表**（`cache.lists.digital_human` → `listInit` 取 `objid` → `getListDatas?passid={objid}&cid={objid}`）。
+
+> 跨环境实测：**部分环境**有「面试数字人配置表」菜单（listId `1274931191811432873`，2 个方案，默认「大模型面试」）；**部分环境没有该菜单**（36 个 SEARCH 菜单里都没有），只能走接口 ①——实测返回唯一方案「大模型岗位」（`1324570620131057673`），且 部分环境 **没有** `digital_id` 默认值（`defaultDetails` 无此项）。所以不能把「默认方案」当成通用前提。
+
+**选择规则**
+- 传了 `--ai-plan <方案名或id>`：id 精确 → 名称全等 → 名称包含；**命中多条视为歧义**并列出，绝不自动取第一条。
+- 没传：`--prepare` 输出 `aiPlans` 候选清单 + `needAiPlan=true`；`--commit` 直接**阻断**（不落库、不执行动作链），提示用户选定后重试。
+- 候选里 `isDefault=true` 的那条是**页面默认方案**（来自 `defaultDetails.digital_id`，实测为「大模型面试」），同时单独输出 `defaultAiPlan`；用户说"用默认"时按该值传 `--ai-plan` 即可。
+
+### 4.8 联动必填核对（`getFormLayout` 元数据，只读）
+
+`GET /api/ebuilder/form/form/core/getFormLayout?formId=<面试计划formId>` 返回：
+- `viewRelateConfig[]`：字段级 `required/readOnly/display`（**静态必填**）；
+- `viewLinkages[]`：条件必填/显隐（`linkageProp` 含 `show`/`edit`/`required`/`readonly`/`hide`），条件形如 `interview_type EQUAL <枚举名>`；
+- `defaultDetails[]`：页面默认值（有默认值的字段不写也会被带上）。
+
+`--prepare` 会据此输出 `requiredHint`：当前面试方式下**必填、但本次未提供且无默认值**的字段（dataKey + 中文名）。
+
+> 某环境实测（2026-08-17 抓包，`getFormLayout?formId=840751242946035714`）：
+> - 静态必填 10 个：应聘管理、应聘职位、人才、面试主题、面试方式、面试轮次、面试官、开始时间、关联日程、状态（后两个有默认值）；
+> - **`AI面试`（= 数字人面试）→ `digital_id`（AI面试方案）+ `email` 必填**，同时**隐藏**关联日程、发送渠道与两个开关字段；
+> - `AI面试(小程序)` → `interview_paper_id`（面试试卷）+ `send_channel`（发送渠道）必填（与数字人版是两种形态，不要混）；
+> - `send_channel = 邮件` → `notice_mould`（通知模板）必填（有默认模板）。
+>
+> **枚举改名/换 id 的坑（已处理）**：联动条件绑的是 optionId。数字人面试原来的枚举项 `AI面试(数字人)`（optionId `841052191228968964`）已被删除，新增的 `AI面试`（optionId `1274947951008702504`）就是它。若按名称直接比对会判成"条件不命中"、得出"页面不要求方案"的错误结论。
+> 判定规则见 `computeRequiredHint`：条件 optionId **仍在枚举** → 严格按当前名比较；**已不在枚举** → 仅当用户所选是「裸名」时按去括号比较（`AI面试(数字人)` ≈ `AI面试`，而 `AI面试(小程序)` 这类带括号取值不参与），从而既兼容改名又不会串到小程序版。
+>
+> 页面默认方案：`digital_id` 的 `defaultDetails` = **「大模型面试」**（记录 id `1274944914469281862`，在面试数字人配置表内）。`--prepare` 会把该默认方案标成 `isDefault=true` 并输出 `defaultAiPlan`。
+>
+> **某环境实测（2026-10-21，POST 取布局）**：
+> - 静态必填 10 个：人才、应聘职位、面试主题、面试方式、面试轮次、**面试表格（`interview_table`，部分环境特有）**、面试官、开始时间、关联日程、状态；
+> - `AI面试` → 联动 `required digital_id` + `required email`（与另一环境实测结论一致），并隐藏 `adjutant_interviewer`；
+> - `AI面试(小程序)` → 面试试卷 + 发送渠道（同另一环境）；
+> - `defaultDetails` **没有** `digital_id` → 部分环境无页面默认方案，必须由用户选。
+> - 部分环境的联动条件里 optionId 是旧值（`841052191228968964` / `841052191228968960`），枚举已换成 `937153879646070190…` / `1320966047218835460`，同样靠上述「optionId 在不在枚举 + 裸名去括号」规则识别。
+
+## 5. 响应数据结构
+- 第①步：`data.id` = 面试计划记录 id（后续步骤入参）。
+- 动作链中的 esb 动作：`data.successNum` / `data.failNum` / `data.successMsg` = 动作流触发结果（`status=false` 即失败）。
+- 动作链中的分配面试：`data.msg`（操作成功）、`data.finalBatchId`（新应聘批次 id）、`data.needRefresh` / `data.refreshCard`（页面刷新标记）。
+
+## 6. 请求示例
+```json
+// ① 保存面试计划
+POST /api/ebuilder/form/form/core/saveFormData?formId=<面试计划 formId，getObjsByTag 同响应返回>
+{ "module": "ebuilderform",
+  "customParam": { "objId": "${INTERVIEW_PLAN_FORM_OBJID}", "name": "面试管理-<主题> <时间>", "firstDataName": "面试管理-<主题> <时间>",
+                   "isFlowEnd": false, "otherOperator": "", "dataStatus": "submit", "rightType": "0", "appId": "<data[0]>" },
+  "appId": "<data[0]>",
+  "formData": { "module": "ebuilderform", "client": "pc", "dataStatus": "submit",
+                "form": { "id": "<面试计划 formId，getObjsByTag 同响应返回>" },
+                "formLayout": { "id": "<面试计划 formLayout.id，getFormLayout 响应>" },
+                "dataDetails": [
+                  { "formField": { "id": "<面试主题字段id>" }, "content": "AI工程师-高刚的面试" },
+                  { "formField": { "id": "<开始时间字段id>" }, "content": "2026-08-06 10:30" },
+                  { "formField": { "id": "<结束时间字段id>" }, "content": "2026-08-06 11:30" },
+                  { "formField": { "id": "<面试方式字段id>" }, "dataOptions": [{ "optionId": "841052191228968963", "content": "现场面试" }] },
+                  { "formField": { "id": "<面试类型字段id>" }, "dataOptions": [{ "optionId": "841052191228968964", "content": "初试" }] },
+                  { "formField": { "id": "<面试官字段id>" }, "dataOptions": [{ "optionId": "<面试官userId>", "content": "<面试官姓名>" }] },
+                  { "formField": { "id": "<应聘职位字段id>" }, "dataOptions": [{ "optionId": "<positionManageId>", "content": "<职位名>" }] },
+                  { "formField": { "id": "<人才字段id>" }, "dataOptions": [{ "optionId": "<talentId>", "content": "<姓名>" }] },
+                  { "formField": { "id": "<应聘管理字段id>" }, "dataOptions": [{ "optionId": "<candidate_manage_id>", "content": "<id>" }] },
+                  { "formField": { "id": "<状态字段id>" }, "dataOptions": [{ "optionId": "841052191228968972", "content": "未开始" }] },
+                  { "formField": { "id": "<反馈状态字段id>" }, "dataOptions": [{ "optionId": "0", "content": "未反馈" }] }
+                ] } }
+
+// ②③④ 动作链：从「保存」按钮 actions[] 按 showOrder 逐条执行（下方为 某环境实例，id 均为运行时解析结果）
+POST /api/ebuilder/form/esb/runEsb?objId=${INTERVIEW_PLAN_FORM_OBJID}
+{ "dataIds": "<formDataId>", "esbActionIds": "<showOrder=1 的 esb 动作 id>", "objId": "${INTERVIEW_PLAN_FORM_OBJID}" }
+
+// 分配面试（无 body）——对应 showOrder=2 的 jsCode 动作
+POST /api/recruit/candidate/assignedInterview?formDataId=<formDataId>
+
+POST /api/ebuilder/form/esb/runEsb?objId=${INTERVIEW_PLAN_FORM_OBJID}
+{ "dataIds": "<formDataId>", "esbActionIds": "<showOrder=3 的 esb 动作 id>", "objId": "${INTERVIEW_PLAN_FORM_OBJID}" }
+```
+
+## 7. 响应示例
+```json
+// ①
+{ "code": 200, "status": true, "data": { "id": "1300448559071436804" } }
+// ②
+{ "code": 200, "status": true, "data": { "successNum": 2, "failNum": 0, "successMsg": "1条数据执行esb接口完成", "needRefresh": true } }
+// ③
+{ "code": 200, "status": true, "data": { "msg": "操作成功", "needRefresh": true, "finalBatchId": "1300447863211237411", "refreshCard": true, "fromPoolBatch": false } }
+```
+
+脚本 `--commit` 输出示例（含动作链执行结果与卡片单页链接）：
+```json
+{ "mode": "commit", "result": "success",
+  "interviewFormId": "1328644967777771668",
+  "interviewCardUrl": "{baseUrl}/sp/ebdfpage/card/0/<面试计划 objId>/1328644967777771668",
+  "saveActions": [
+    { "order": 1, "name": "面试管理-新建日程", "type": "esb", "ok": true, "msg": "【面试管理-新建日程】执行成功！" },
+    { "order": 2, "name": "安排面试后续动作API", "type": "jsCode", "ok": true, "msg": "等价调用 assignedInterview（分配面试）" },
+    { "order": 3, "name": "AI面试时发送提醒", "type": "esb", "ok": true, "msg": "【招聘recruit-新建AI面试后按钮事件发送提醒】执行成功！" }
+  ],
+  "warnings": [],
+  "assigned": { "msg": "操作成功", "finalBatchId": "1318436783908855811" } }
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 非 200 | 认证/参数错误 | 提示检查认证（`weaver-work-cli auth status`） / 参数；参数缺失先反问 |
+| 分配面试 400 | `formDataId` 缺失或无效 | 确认第①步返回的 `data.id` 已正确透传 |
+| 动作链 esb `status=false` | 日程/提醒等动作流执行失败 | 按动作名报错并**中断**（后续动作不执行，与页面一致）；检查该动作流配置 |
+| 本地阻断：AI面试缺邮箱 | `--email` 未提供且人才资料无邮箱 | **不创建**；提示用户提供邮箱（`--email`）或在人才资料补全后重试 |
+| 本地阻断：邮箱格式错 / 缺手机 | 取值不合法 | 提示用户提供有效值后重试，不静默写空 |
+
+## 9. 调用参考
+- 用户场景："给 X 安排面试"。
+- **流程**：收集（应聘者/职位/面试官/时间/方式）→ 展示摘要（含将执行的动作链清单）→ 用户确认 → ① 保存 → ②③④ 按「保存」按钮 actions[] 顺序执行 → 输出结果（动作链明细 + 新应聘批次 `finalBatchId`）。
+- 面试官名称→ID：走 `browser/complete/resource`（fieldId 按门户字段规则）；命中多个列出选项让用户确认。
+- **确认摘要模板（提交前必展示，必须带出定位键）**：
+  > 即将为 **姓名（手机：XXX ｜ `talentId=XXX`）** 安排面试：
+  > - 职位：XXX ｜ 方式：现场/视频/电话/AI ｜ 时间：XXX
+  > - 面试官：XXX
+  > 请确认对象与参数无误（确认后才会保存并分配）。
+
+## 10. 注意事项
+- **写操作确认**：必须展示摘要并获用户明确确认后再提交。**提交时默认执行「保存」按钮的完整动作链**（含服务端发出的面试通知/日程/提醒），与人工点保存一致；`--prepare` 会先把动作清单列出来供确认。
+- **不得"只保存表单"**：只调 `saveFormData` 会留下「有表单、无日程、无分配、无通知」的半成品（页面看不到、流程不生效）。必须走完动作链；`--skip-save-actions` 仅限排查。
+- **定位前置**：提交前必须先按手机号/姓名搜索定位到唯一候选人（见 §3），命中多条先消歧，绝不自动取第一条。
+- 面试官/职位/人才/应聘管理均为**门户字段**，`dataOptions[].optionObj` 内含 `userId`/`name`，展示取 `name`，提交传 `optionId`（= userId / positionManageId / talentId / candidate_manage_id）。
+- 面试字段 id 经 `ds/fields` 按 `dataKey` 解析（`interviewer`/`position_manage_id`/`mobile`/`talent_id`/`candidate_manage_id`/`email`，已并入环境缓存 `fields[objId]`），如需动态确认字段 id 可查 `recruit-resolve-metadata.md` §5。
+- **面试官默认 = 当前登录用户**：`--interviewer` 可省略；省略时经 `POST /api/baseserver/layout/teamsCheck` 取 `currentUser` 作为面试官（与页面「选 AI面试 后联动带出当前人」一致）。**不得**用"人员候选列表第一条"当默认（可能是任意人；2026-10-21 已修）。
+- **手机号 / 邮箱必须显式写入**（2026-10-21 修）：页面操作时表单按 `talent_id` **联动带出**手机/邮箱，但**直接调 `saveFormData` 不触发表单联动** → 不写就落空。脚本从 `getCandidateCardBaseInfo` 的 `talent.telephone` / `talent.email` 取值写入；也支持 `--mobile` / `--email` 当场补录（补录优先）。
+- **AI 面试邮箱为必填**：`type` 含 `AI`（兼容「AI面试 / AI 面试」命名差异）时，若人才资料与 `--email` 都没有邮箱，**直接阻断创建**，提示用户提供邮箱后重试；邮箱格式不合法同样阻断。**不得静默写空、不得降级创建**。
+- **AI面试方案（`digital_id`）为必填**：未传 `--ai-plan` 时 `--prepare` 输出 `aiPlans` 候选、`--commit` 直接阻断；候选来自「面试数字人配置」列表，**objId/listId/记录 id 全部运行时解析，不写死**。用户选定后带 `--ai-plan` 重试；多条命中先消歧，**绝不自动取第一条**。
+- **联动必填以表单配置为准**：`--prepare` 的 `requiredHint` 会列出「当前面试方式下必填但未提供且无默认值」的字段。若出现 `interview_paper_id`（面试试卷）/`send_channel`（发送渠道），说明该环境页面还要求这两项，需先与用户确认后再补写（见文档末尾「未闭环」）。
+- **记录卡片单页链接**：`--commit` 输出 `interviewCardUrl = {baseUrl}/sp/ebdfpage/card/0/{objId}/{formDataId}`（objId 运行时从环境缓存取，dataId 为 saveFormData 返回值）；供 Agent 在回答里给出可点击链接。
+- 时间格式：`YYYY-MM-DD HH:mm`（含空格）。
+- **AI面试（数字人）**：当 面试方式 = `AI面试` 时，服务端按数字人配置（`uf_rcrt_zego_config` 即构云端录制 / `uf_rcrt_digital_human` 面试方案，管理员一次性配置，详见 `recruit-business-map/references/ai-interview-manual.md`）自动驱动数字人面试与通知（`uf_rcrt_dhi_notify_log`）；技能侧只需正确选择「AI面试」方式并走 ①②③ 三步编排，**无需额外操作**。数字人自动约面（机器人自动约面）的 HR 操作与 admin 配置要点见 `recruit-business-map/references/ai-interview-manual.md` 操作手册备份；手动模式已验证 OK，视为功能支持。
+
+## 11. 预填模式（打开人才卡片 → 面试安排表单 → 选面试方式；人工保存，不落库）
+
+**用途**：对齐"人工安排面试"的操作路径，支撑「AI面试邀约」演示链路（原始需求：**打开人才卡片 → 安排AI面试 → 打开面试管理页面**）。与 §1–§10 的 `--prepare/--commit`（**直接落库**）并列——本模式**不落库**，只"打开页面 + 在表单里选面试方式"，由 HR 核对后保存。
+
+**用法**
+```bash
+node scripts/recruit-arrange-interview.mjs --prefill --talent-id <id> [--type AI面试]
+```
+输出：`talentCardUrl`（人才卡片）、`interviewListUrl`（面试管理列表）、`jsExpr`（在表单上选「面试方式=<type>」）、`steps`。
+
+**执行步骤（Agent 编排，依赖浏览器自动化 browser-skill/bsk）**
+1. 打开 `talentCardUrl` → 进入该候选人卡片；
+2. 点卡片上的「**安排面试**」→ 打开面试安排表单（**主题 / 候选人 / 职位由表单默认值自动带入**，无需预填）；
+3. 在页面执行 `jsExpr`（例：`bsk evaluate "<jsExpr>"`）→ 选中「面试方式=`<type>`」，**触发表单联动**；
+4. 由 HR 核对（可按需调整）后点「**保存**」完成面试安排；
+5. （可选）打开 `interviewListUrl` 查看面试管理列表。
+
+**AI面试联动（2026-10-21 核对）**
+- **「AI面试」= 数字人面试**：联动条件里的 `AI面试(数字人)`（旧 optionId `841052191228968964`）就是它，只是后来枚举项换了 id 与显示名（新 `1274947951008702504`「AI面试」）。
+- 选中「面试方式=AI面试」后，页面联动带出：**AI面试方案（默认「大模型面试」）**、面试官=当前登录人、开始/结束时间；并**隐藏**关联日程、发送渠道。
+- `--commit` 路径**不依赖联动**：方案由 `--ai-plan` 显式指定（未指定时 `--prepare` 给候选、`--commit` 阻断），避免"默认值静默生效"而用户不知情。
+
+**字段与枚举（运行时解析，不写死）**
+- 字段 id：环境缓存 `cache.fields[面试计划 objId]`（如 `interview_type`）；
+- 「面试方式」optionId：`getDsOptions(objId, interview_type, appId)` 按名称取（实测示例：现场=`841052191228968963`、视频=`…962`、电话=`…961`、**AI面试=`…964`**）。
+
+**通知与后续动作（两条路径结果一致）**
+- **页面点「保存」= 依次执行按钮配置的动作链**：系统保存 → esb（新建日程）→ jsCode（分配面试）→ esb（AI面试提醒）。`--commit` 已按**同一动作链**执行（见 §4.6），所以脚本落库与人工保存效果一致。
+- 本 `--prefill` 模式把"填表 + 点保存"交给页面/人工，技能不落库；通知仍由服务端动作流发出，技能不自己拼消息。
+
+**边界**
+- 本模式依赖浏览器自动化（WorkBuddy 桌面端 `bsk`，或具备表单注入能力的客户端）；小E 端若只能打开页面，可只打开 `talentCardUrl` / `interviewListUrl`，第③步由 HR 手点。
+- **AI面试闭环不可全链自动化**：技能止于"面试安排"，通知/候选人录制/视频归集均由服务端与候选人侧完成；HR 后续在面试管理里查台账、`recruit-detail-interview` 看面试与反馈、`recruit-edit-interview-feedback` 填反馈。
+
+## 12. 未闭环（2026-10-21 核对联动必填得出）
+
+| # | 事项 | 现状 | 影响 |
+|---|---|---|---|
+| 1 | 面试试卷 `interview_paper_id` / 发送渠道 `send_channel` | 仅 **`AI面试(小程序)`** 形态必填（数字人版会隐藏这两项）；脚本未写、也未提供候选查询 | 若在对话里选「AI面试(小程序)」，页面会要求这两项；当前建议统一走「AI面试」（数字人） |
+
+> 结论：**「AI面试」= 数字人面试**，必填项是 **AI面试方案 + 邮箱**，不需要面试试卷/发送渠道（那两项属于「AI面试(小程序)」）。
+>
+> **部分环境已实测（2026-10-21）**：动作链解析出 4 个动作（各环境动作集不同，以运行时解析为准）；AI 面试方案候选可用（「大模型岗位」）；缺方案时 `--commit` 正确阻断；视频面试路径不受影响。
+
+> **--commit 成功产物（2026-10-22 定稿）**：两个 Markdown 链接——① `viewLink`（面试安排详情页）② `listLocateLink`（面试管理列表并滑出本次安排，listId 取环境缓存动态组合）。