weaver-work-cli 0.1.40 → 0.1.44

package/skills/weaver-e10-recruit-stage/references/recruit-capability-check.md

@@ -0,0 +1,127 @@
+# 环境能力探测（运行时自适应，不写死版本）
+
+>
+> **核心原则：不判断"是哪个版本"，而是运行时探测"这个环境有哪些能力"**。探测结果驱动路由——能力可用才执行，未启用/未部署 → 友好提示并终止，**绝不猜测、不硬凑、不假装成功**。
+
+## 1. 为什么需要（背景）
+
+不同应用版本的功能差异是**离散且未知的**（全功能版本有 需求/职位/人才库/面试/Offer/入职/统计 全套；部分版本有 需求/职位/人才库/面试，但**无 Offer、无入职管理、无统计看板**，且菜单命名不同）。技能不得硬编码"某版本全 / 某版本简"，因为：
+- 未来可能有第三个版本（功能组合又不同）；
+- 同一版本不同租户可能因授权/配置不同而有差异；
+- 菜单名会变（人才管理→人才库、招聘职位→职位列表、入职管理→应聘管理是不同业务、Offer管理→offer设置是配置页）。
+
+## 2. 能力探测流程（每次会话开始时执行一次，结果缓存于本次会话）
+
+```
+第 0 步 安装闸门：GET /api/bs/ebuilder/app/tags/getAppIds?tag=weaver-recruit-service
+  ├─ 失败/空 → ⚠️ 未安装招聘服务，终止（不进入任何招聘接口）
+  └─ 成功 → appId
+
+第 1 步 表单存在性：对每个业务 tag 调 GET /api/ebuilder/form/obj/getObjsByTag?appId={appId}&tag={tag}
+  tag 清单：uf_rcrt_talent_pool(人才库) / uf_rcrt_demand_manage(需求) / uf_rcrt_position_manage(职位)
+           / uf_rcrt_interview_plan(面试) / uf_rcrt_entry_manage(入职) / uf_rcrt_offer(Offer)
+  → 每个 tag：objId 解析到 = 表单存在；解析不到 = 表单未部署
+
+第 2 步 菜单入口：GET /api/cusapp/app/allMenus（递归 children[]）
+  → 对每个业务用「候选关键词组 + pageType=SEARCH」语义匹配（见 recruit-resolve-metadata.md §3.1）
+  → 命中 = 有列表入口；不命中 = 无入口（可能是未启用，也可能是换名/配置页混淆）
+
+第 3 步 汇总能力清单：
+  功能         表单(objId)   菜单(listId)   判定
+  ─────────────────────────────────────────
+  人才搜索/详情  有           有(或无也可)   可用（详情不依赖列表菜单）
+  需求列表       有           有            可用
+  职位列表       有           有            可用
+  面试（安排/查） 有           —            可用（写操作/卡片接口不依赖菜单；安排面试需 `getObjsByTag` + `ds/fields` 再确认）
+  入职（名单/办/取消）有      有            可用
+               有           无             ⚠️ 未启用（表单在但无入口）→ 拦截
+               无           —             ⚠️ 未部署 → 拦截
+  Offer（发/查） 有           有            可用
+               有           无             ⚠️ 未启用 → 拦截（部分版本：表单在、仅 offer设置 配置页）
+ 招聘统计       有看板 PAGE 菜单          可用（nchart）
+               无看板 PAGE 菜单           ⚠️ 未启用 → 拦截（部分版本：仅 EDC 报表，不在本技能范围）
+```
+
+## 3. 判定矩阵（每类功能统一规则）
+
+| 场景 | 判定 | 输出 |
+|---|---|---|
+| 表单 objId 解析不到 | **未部署** | `⚠️ 当前环境未部署「X」功能，无法执行。` + 说明 + 停止 |
+| 表单在、但菜单匹配不到（且该功能依赖列表入口） | **未启用** | `⚠️ 当前环境未启用「X」功能（未找到对应菜单）。` + 说明「不顶替」+ 停止 |
+| 菜单匹配到**配置页/近似业务**（设置/配置/复制/开发排查等） | **不算命中** | 继续匹配；全不中按上一条处理 |
+| 表单+菜单都在，但接口调用失败/业务码失败 | **调用失败** | 按接口文档错误码解释，如实提示，停止；不假装成功 |
+| 表单+菜单都在，接口正常 | **可用** | 正常执行 |
+
+**红线（严禁）**：
+- 菜单匹配不到 → **不得用近似业务菜单硬凑**（如 部分版本用「应聘管理」顶入职、用「offer设置」顶 Offer）；
+- 字段/枚举拿不到 → 不得臆造 id（按 data-dictionary 原样回退，或反问用户）；
+- 接口 HTTP 200 但业务码失败 → 不得仅凭状态码判成功；
+- 写操作某步失败 → 如实上报「已完成 X / 失败 Y」，不谎称整体成功；
+- 网络超时写操作不自动重试（防重复写入）。
+
+## 4. 各功能能力探测细则
+
+### 4.1 人才搜索 / 详情
+- 依赖：`uf_rcrt_talent_pool` objId（tag 解析）。
+- 详情编排不依赖列表菜单（卡片接口直接收 talentId+batchId）；但「搜索」需要列表 `getListDatas`（listId 经 allMenus 发现，或 L2 dataset/v2 降级）。
+- 人才库菜单候选词：`人才管理`/`人才库`。
+
+### 4.2 需求 / 职位列表
+- 依赖：`uf_rcrt_demand_manage`/`uf_rcrt_position_manage` objId + 对应 SEARCH 菜单。
+- 菜单候选词：需求=`招聘需求`/`需求`；职位=`招聘职位`/`职位列表`。
+- 菜单匹配不到 → 未启用拦截。
+
+### 4.3 面试（安排 / 查询 / 催评）
+- 依赖：`uf_rcrt_interview_plan` objId + 布局 formId（同由 `getObjsByTag` 一次返回）+ 字段 id（经 `ds/fields` 按 `dataKey` 解析）。
+- 查询/反馈卡片不依赖菜单；安排面试走 saveFormData→runEsb→assignedInterview（不依赖列表菜单）。
+- **判定要点**：objId 解析到 = 表单在 = 可用；解析不到 = 未部署拦截。
+- 面试通知/催评动作流：`esbActionIds` 跨环境不同，须运行时按按钮配置解析（面试计划表单 `getFormButtons` / 面试反馈列表 `getListButtons`，见 recruit-resolve-metadata.md §4）——**解析不到时反问用户提供，不臆造 id**。
+
+### 4.4 入职（名单 / 办入职 / 取消改期）
+- 依赖：`uf_rcrt_entry_manage` objId + SEARCH 菜单（候选词：`入职管理`）。
+- **部分版本**：表单在（objId 可解析）但**无「入职管理」菜单**（「应聘管理」是应聘者管理、非入职）→ 判定**未启用**，拦截提示，不顶替。
+- 办入职/取消入职虽走表单接口，但定位名单/入口依赖菜单 → 同样拦截。
+- **取消/改期入职另依赖中间表 tag（`uf_rcrt_entry_cancel` / `uf_rcrt_entry_change`）**：**tag 解析不到（`data:[]`）= 该环境未启用取消/改期入职** → 阻断该动作并友好提示「当前环境未启用取消入职/改期入职功能」，不执行、不兜底、不臆造（用户决策：不清晰的动作，宁可不执行，也不能乱执行）。
+
+### 4.5 Offer（发 Offer / 查询记录）
+- 依赖：`uf_rcrt_offer` objId + SEARCH 菜单（候选词：`录用管理`——实名；`offer有效期设置`/`offer设置` 是配置页不算）。
+- **部分版本**：表单在但无「录用管理」菜单（仅 offer设置 配置页）→ 判定**未启用**，拦截，不顶替。
+
+### 4.6 招聘统计（nchart 看板）
+- 依赖：`招聘数据看板`/`招聘工作统计` 等 **PAGE 型看板菜单**（allMenus pageType=PAGE 且菜单名含 统计/看板）。
+- **部分版本**：无任何统计 PAGE 看板（仅 EDC REPORT 报表：面试出席/创建/沟通统计）→ 判定**未启用**，拦截（EDC 报表不在本技能范围）。
+- 全功能版本：存在 `招聘数据看板` PAGE（pageId 经 allMenus 自动发现），nchart 可用。
+
+### 4.7 简历解析（OCR）
+- 依赖：`/api/recruit/ocr/checkRpaValid` 等接口路由（POST 空参返回业务响应即路由存在）。
+- 路由不存在（404）→ 未部署拦截；存在 → 可用（仅解析不写库）。
+
+## 5. 执行时容错（每步都要）
+
+1. **接口调用前**：确认该功能在能力清单中「可用」，否则直接输出拦截提示，不发起调用。
+2. **接口调用失败**（非 200 / 业务码失败）：按文档错误码解释，如实提示，停止。
+3. **解析不到**（字段 id / 枚举 / 动作流 id / 菜单）：不臆造 → 反问用户或按 data-dictionary 回退。
+4. **写操作**：先定位（locate-first）→ 消歧 → 确认摘要 → 用户确认才提交；失败如实上报部分失败。
+5. **严禁猜测执行**：任何"可能是/大概是/应该可以"的路径，先停下来问用户，或按文档明确规则处理。
+
+## 6. 基线判定（版本探测，）
+
+**背景**：部分接口是最近基线新增、或不同基线出入参有破坏性改造，调用前需确认当前环境基线符合。能力特征探测（§2）已能判定"接口存在/功能启用"，是基线符合性的兜底；平台版本接口可补充**显式版本号**，用于精确对照文档基线标注。
+
+**版本获取**（可选增强，容错）：
+- 接口：`GET /api/security/license/getVersion`（平台通用，去域名路径；随机 key 参数如 `randomkey_probe=1`）
+- 响应：`data` 为 JSON 字符串，含 `version`（如 `10.0.2605.01`）
+- **容错**：部分环境有安全网关（如需完整会话 cookie）或权限限制，直接调用可能失败——**探测失败不阻塞初始化**，`version` 记为未知，基线判定回退 §2 能力特征探测。
+- 初始化工具 `scripts/_init_env_cache.mjs`（随包 Node 版）已含此探测，版本号落环境缓存 `version` 字段（「刷新环境参数」后生效）。
+
+**基线判定双通道**：
+1. **版本号通道**：缓存 `version` 非空 → 对照接口文档「适用基线」标注（见 SKILL.md「接口基线标注」），低于基线 → 拦截提示，不调用；
+2. **特征通道**（兜底，始终有效）：版本取不到时，用 §2 能力特征（tag 可解析 / 菜单存在 / 按钮配置）判定接口可用性——特征缺失即按「未启用/未部署」拦截提示。
+
+**基线标注不臆测**：接口文档中「适用基线」的具体版本号需以官方基线说明为准；无明确基线号时标注机制性描述（"以环境版本接口返回为准 + 能力特征探测"），不得猜测版本值。
+
+## 7. 与现有文档的关系
+
+- 本文档是**第 0 步前置检查的扩展**（原只查安装闸门，现扩展为能力探测）。
+- 菜单语义匹配细节见 `recruit-resolve-metadata.md` §3.1/§3.2（含多候选关键词、排除配置页、L1/L2/L3 降级）。
+- 各功能接口文档（recruit-search-candidate.md / recruit-list-*.md / recruit-arrange-interview.md / recruit-entry-*.md / recruit-send-offer.md / recruit-stats.md）在「前置依赖」中引用本文档。

package/skills/weaver-e10-recruit-stage/references/recruit-check-install.md

@@ -0,0 +1,65 @@
+---
+name: recruit-check-install
+description: 招聘服务安装检测闸门（第 0 步必做，取 appId）
+---
+
+# 前置：招聘服务安装检测（Agent 辅助）
+> 本文档中的 `${...}` 形参（表单 objId / 列表 listId / EB 页面 viewId·pageId / 应用 appId / 动作流 id）为**租户相关值**：表单 objId 经 `recruit-resolve-metadata.md` 的 tag 链运行时解析；其余由部署参数提供（**可经 `allMenus` 菜单树自动发现**，见 `recruit-resolve-metadata.md` §3.1）；字段 ID（field_937…）依当前租户表单而定，详见 `data-dictionary.md`。
+
+## 1. 基础信息
+- 接口名称：按应用标签获取应用 id 列表 `getAppIds`（ebuilder-app 对外 REST）
+- 请求方式：`GET`
+- 去域名路径：`/api/bs/ebuilder/app/tags/getAppIds`
+- 所属模块：低代码平台 e-Builder（ebuilder-app）
+- 所属分组：前置 / Agent 辅助
+
+## 2. 业务用途
+**任何招聘操作前的第 0 步闸门**：用招聘应用固定标签 `weaver-recruit-service` 反查当前租户下是否已安装招聘服务。返回非空列表 = 已安装（且拿到 `appId`）；返回空 = 未安装，应直接提示用户"您未安装招聘服务"并终止后续流程，不再调用任何招聘接口。
+
+## 3. 前置条件
+- 有效的认证（由 `weaver-work-cli auth` 托管的 E10 登录态提供）（租户上下文由会话决定，无需额外传 `tenantKey`）。
+- 应在搜索 / 详情等所有招聘接口之前最先调用。
+
+## 4. 请求参数
+| 字段 | 位置 | 类型 | 必填 | 约束 | 业务说明 |
+|---|---|---|---|---|---|
+| `tag` | query | string | 是 | 固定值 `weaver-recruit-service` | 招聘应用的固定标签（由应用方打在 EB 应用上） |
+
+## 5. 响应数据结构
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `code` | int | 200 表示成功 |
+| `status` | boolean | `true` 表示正常返回 |
+| `data` | array\<long\> | 该标签在当前租户下的应用 id 列表；**非空 = 已安装**，取 `data[0]` 为 `appId`；**空数组 = 未安装** |
+
+## 6. 请求示例
+```json
+// GET /api/bs/ebuilder/app/tags/getAppIds?tag=weaver-recruit-service
+```
+
+## 7. 响应示例
+```json
+// 已安装
+{ "code": 200, "msg": "接口返回成功", "status": true, "data": ["${RECRUIT_APP_ID}"], "fail": false }
+// 未安装（标签无对应应用）
+{ "code": 200, "msg": "接口返回成功", "status": true, "data": [], "fail": false }
+```
+
+## 8. 错误码与失败形态（分情形处理，**不得把所有失败都当"未安装"**）
+| 错误码 / 响应形态 | 含义 | AI 处理建议 |
+|---|---|---|
+| 200 + `status=true` + `data`=[] | 标签无对应应用（**未安装**） | 提示「您当前租户未安装招聘服务，请先安装后重试」，终止流程 |
+| 200 + `status=false` + `msg` | 业务失败（常见：账号未授权该模块） | 按 `msg` 解释；`msg` 含「未授权/无权限」→ 提示「当前账号无招聘模块访问权限，请联系管理员开通」；其余按业务失败提示，**不得误报"未安装"** |
+| HTTP 401 | 认证缺失或过期 | 提示重新登录（认证由 `weaver-work-cli auth` 托管）后重试 |
+| HTTP 403 | 已认证但无模块访问权限（**模块未启用/未授权给本账号的典型形态**） | 提示「当前账号无招聘模块访问权限，请联系管理员开通或启用模块」 |
+| HTTP 404 | 接口路由不存在（非 E10 环境 / 服务版本未部署该模块） | 提示「接口不存在：确认目标为 E10 环境且服务版本已部署该模块」，**不得误报"未安装"** |
+| 网络异常 / 超时 | 连接失败 | 提示网络/连接异常，读取类可有限重试，仍失败再终止 |
+
+## 9. 调用参考
+- Agent 辅助：作为所有招聘能力的统一前置闸门。命中 `data` 非空后，方可继续搜索 / 详情流程；命中空则直接输出未安装提示并停止。
+- `appId`（`data[0]`）可用于后续 EB 详情链接拼装，或作为其他需 appId 的接口入参。
+
+## 10. 注意事项
+- 同租户若多次导入同一标签应用，`data` 可能含多个 appId（tag 策略限制，无法自动去重）。取首个 `data[0]` 作为主 appId；必要时向用户说明"检测到多个安装实例"。
+- 仅用 `tag` 入参，租户隔离由服务端会话保证，切勿在请求里臆测 `tenantKey`。
+- 本接口为只读查询，不触发任何写操作。

package/skills/weaver-e10-recruit-stage/references/recruit-detail-process.md

@@ -0,0 +1,63 @@
+---
+name: recruit-detail-process
+description: 应聘过程卡片（Agent 辅助，默认不展示）
+---
+
+# 详情卡片：应聘过程（Agent 辅助，默认不展示）
+
+## 1. 基础信息
+- 接口名称：人才应聘过程日志 `getCandidateCardProcess`
+- 请求方式：`POST`
+- 去域名路径：`/api/recruit/processLog/getCandidateCardProcess`
+- 所属模块：招聘管理（recruit）
+- 所属分组：详情 / Agent 辅助
+
+## 2. 业务用途
+获取该人才在招聘流程中的操作过程日志：操作描述、操作人、业务类型、时间。默认详情流程**不展示**；仅当用户明确要求"应聘过程"时才调用。
+
+## 3. 前置条件
+- `talentId`、`batchId`（来自 prepareQuery）。
+
+## 4. 请求参数
+| 字段 | 位置 | 类型 | 必填 | 约束 | 业务说明 |
+|---|---|---|---|---|---|
+| `talentId` | body | string | 是 | 人才 id | |
+| `batchId` | body | string | 否 | 批次 id | 部分部署需要 |
+| `current` | body | int | 否 | 默认 1 | 页码 |
+| `pageSize` | body | int | 否 | 默认 10 | 每页条数 |
+
+## 5. 响应数据结构
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `data.list[].optContext` | string | 操作描述 |
+| `data.list[].operatorId` | object | 操作人 `{name}` |
+| `data.list[].optBusiness` | string | 业务类型 |
+| `data.list[].createTime` | string | 操作时间 |
+
+## 6. 请求示例
+```json
+{ "talentId": "1276382457065553922", "batchId": "937153853968540001", "current": 1, "pageSize": 10 }
+```
+
+## 7. 响应示例
+```json
+{
+  "code": 200, "status": true,
+  "data": { "list": [
+    { "optContext": "进入面试环节", "operatorId": { "name": "钱七" },
+      "optBusiness": "stage_change", "createTime": "2026-08-03 09:00" }
+  ] }
+}
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 来源文档未提供接口特有错误码 | — | 非 200 / 重定向 → 提示 认证可能过期（`weaver-work-cli auth status`） |
+
+## 9. 调用参考
+- Agent 辅助：默认不调用；用户明确要求"应聘过程/流转记录"时才调用并加 `## 应聘过程（N）` 段。
+
+## 10. 注意事项
+- 默认详情流程不展示本卡片，避免信息过载。
+- `operatorId` 取 `name` 回填。

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

@@ -0,0 +1,142 @@
+# 提交/修改面试反馈（组合写操作）
+
+> **平台兼容**：本文命令示例在 macOS/Linux 与 Windows PowerShell 下均可执行——JSON 用单引号包裹、内部双引号不转义；PowerShell 下不使用反斜杠续行。
+
+## 1. 接口概述
+
+把「提交面试评价」按钮的完整动作链固化为可调用的组合写操作：保存面试反馈表单（更新结果/评价）+ 触发按钮绑定的 esb 动作流 + 写招聘过程日志（`addProcessLog`）。通过**按钮动作智能解析**（粗定位 → 精核验 → 拆解执行 → 回查校验）在任意环境自适应，不依赖按钮名/ID。
+
+## 2. 业务用途
+
+用户在面试详情里填写/修改某场面试的反馈结果（通过/不通过/待定）与评价文字并提交。系统侧点击「提交评价」按钮实际触发三段动作：
+1. **保存反馈表单**（EB `saveFormData`，更新 `interview_detail` 表单对应反馈记录）；
+2. **触发动作流**（EB `runEsb`，按钮配置的 esb 动作流：面试安排-填写反馈 / 全部面试反馈完成-更新日程状态 / 招聘recruit-面试反馈提醒 等）；
+3. **写招聘过程日志**（招聘专属接口 `POST /api/recruit/processLog/addProcessLog`，把结果/评价落到招聘业务过程流，`processEnum=20` 标识"提交面试评价"）。
+
+> **适用基线**：`addProcessLog` 为招聘标准接口（路径/入参由招聘应用代码固定，客户搭建不影响）；表单/按钮为 EB 配置物，运行时解析。调用前经能力探测确认。
+
+## 3. 前置条件
+
+- 已登录（`weaver-work-cli auth status` 通过），环境参数缓存含 `interview_detail` 表单（tag 自动解析）。
+- 候选人有可编辑的面试反馈记录（`getCandidateCardInterviewInfo` 返回 `interviewFeedBack`，含 `optCanEdit:true`）。
+- 能力探测：反馈表单、按钮配置、`addProcessLog` 可用；缺失即拦截提示。
+
+## 4. 请求参数
+
+### 4.1 定位参数（脚本入口）
+
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `--talent-id` / `--mobile` | 二选一 | 候选人定位（talentId 优先） |
+| `--feedback-id` | 选填 | 直接指定反馈记录 id（=`interviewFeedBack[0].id`=`formDataId`=`businessId`），最稳；缺省取第一场含反馈的面试（可 `--plan-index` 指定） |
+| `--result` | 选填 | 新面试结果中文（通过/不通过/待定），经 `ds/options` 解析 optionId |
+| `--comment` | 选填 | 新评价文字 |
+| `--prepare` / `--commit` | 写操作模式 | prepare=只定位+校验+确认摘要不写；commit=真实执行 |
+
+### 4.2 关键接口入参
+
+| 步骤 | 接口 | 方法/入参 |
+|---|---|---|
+| 反馈记录定位 | `getCandidateCardInterviewInfo` | `POST` body `{talentId, batchId, current:1, pageSize:20}` → `data.list[i].interviewFeedBack[0]`：`id`(=formDataId)、`result[]`、`judgement`、`interviewPlanId[]`、`interviewer[]` |
+| 反馈记录数据 | `getFormDataAndLayout` | `POST /api/ebuilder/form/form/core/getFormDataAndLayout?formId=<反馈表单formId>&dataId=<反馈记录id>`，body 见 §5 → `data.formData.{id, updateTimeStamp, dataDetails}` + `data.formLayout.id` |
+| 按钮粗定位 | `getFormButtons` | `POST /api/ebuilder/form/data/getFormButtons`，body `{layoutType:"formLayout", objId, dataId, formDataId:dataId, type:"2", ...}` → 找 `actionType=system` 或 `buttonKey=editSave` 的按钮 |
+| 保存反馈 | `saveFormData` | `POST /api/ebuilder/form/form/core/saveFormData?formId=<formId>`，`formData.id`=反馈记录id、`updateTimeStamp`=最新、`dataDetails`=全字段集（防清空）、`formLayout.id`=`getFormDataAndLayout` 的 formLayout.id（⚠️ 更新场景勿用 `getFormLayout`：部分版本 GET 405，虽然 `write-op.mjs::getFormLayout` 已加 POST 回退，但记录级布局以 `getFormDataAndLayout` 为准） |
+| 动作流 | `runEsb` | `POST /api/ebuilder/form/esb/runEsb?objId=<objId>`，body `{dataIds:<反馈记录id>, esbActionIds:<按钮 esb actions id 逗号拼接>}` |
+| 写过程日志 | `addProcessLog` | `POST /api/recruit/processLog/addProcessLog`，body `{talentId, batchId, result:<结果optionId>, judgement:"<p>评价</p>", businessId:<反馈记录id>, processEnum:"20"}` |
+
+## 5. 请求示例
+
+```bash
+# ① 反馈记录定位（拿 batchId 后）
+curl -s -X POST "${BASE_URL}/api/recruit/candidate/getCandidateCardInterviewInfo" \
+  -H "Content-Type: application/json" -H "Cookie: ${COOKIE}" -H "eteamsid: ${ETEAMSID}" \
+  -H "langType: zh_CN" -H "timeZoneOffset: -480" -H "Accept: application/json" \
+  -d '{"talentId":"<talentId>","batchId":"<batchId>","current":1,"pageSize":20}'
+# → data.list[i].interviewFeedBack[0] = {id:"<反馈记录id>", result:[{id,name}], judgement:"<p>…</p>", ...}
+
+# ② 保存反馈（全字段集 + updateTimeStamp 乐观锁）
+curl -s -X POST "${BASE_URL}/api/ebuilder/form/form/core/saveFormData?formId=<formId>" \
+  -H "Content-Type: application/json" -H "Cookie: ${COOKIE}" -H "eteamsid: ${ETEAMSID}" \
+  -H "langType: zh_CN" -H "timeZoneOffset: -480" -H "Accept: application/json" \
+  -d '{
+    "module":"ebuilderform","appId":"<appId>",
+    "customParam":{"objId":"<objId>","name":"面试反馈-<面试主题>","firstDataName":"面试反馈-<面试主题>","isFlowEnd":false,"otherOperator":"","dataStatus":"submit","rightType":"2","appId":"<appId>"},
+    "formData":{
+      "id":"<反馈记录id>","updateTimeStamp":"<最新>","module":"ebuilderform","client":"pc","dataStatus":"submit",
+      "form":{"id":"<formId>"},"formLayout":{"id":"<getFormDataAndLayout的formLayout.id>"},
+      "dataDetails":[
+        {"formField":{"id":"<result字段id>"},"dataOptions":[{"optionId":"<结果optionId>","content":"不通过"}]},
+        {"formField":{"id":"<judgement字段id>"},"dataText":{"content":"<p>太随意了，不合适</p>"}},
+        {"formField":{"id":"<面试主题字段id>"},"dataOptions":[{"optionId":"<面试计划id>","content":"<面试主题>"}]},
+        {"formField":{"id":"<batchId字段id>"},"dataOptions":[{"optionId":"<batchId>","content":"<batchId>"}]},
+        {"formField":{"id":"<人才字段id>"},"dataOptions":[{"optionId":"<talentId>","content":"<姓名>"}]},
+        {"formField":{"id":"<反馈人字段id>"},"dataOptions":[{"optionId":"<反馈人id>","content":"<反馈人>"}]}
+      ]
+    }
+  }'
+
+# ③ 动作流
+curl -s -X POST "${BASE_URL}/api/ebuilder/form/esb/runEsb?objId=<objId>" \
+  -H "Content-Type: application/json" -H "Cookie: ${COOKIE}" -H "eteamsid: ${ETEAMSID}" \
+  -H "langType: zh_CN" -H "timeZoneOffset: -480" -H "Accept: application/json" \
+  -d '{"dataIds":"<反馈记录id>","esbActionIds":"<按钮esb动作id1>,<id2>,<id3>","objId":"<objId>"}'
+
+# ④ 写招聘过程日志
+curl -s -X POST "${BASE_URL}/api/recruit/processLog/addProcessLog" \
+  -H "Content-Type: application/json" -H "Cookie: ${COOKIE}" -H "eteamsid: ${ETEAMSID}" \
+  -H "langType: zh_CN" -H "timeZoneOffset: -480" -H "Accept: application/json" \
+  -d '{"talentId":"<talentId>","batchId":"<batchId>","result":"<结果optionId>","judgement":"<p>太随意了，不合适</p>","businessId":"<反馈记录id>","processEnum":"20"}'
+```
+
+## 6. 响应参数
+
+| 接口 | 成功标志 | 说明 |
+|---|---|---|
+| `saveFormData` | `status:true` / `code:200` | 返回 `data.id`（=反馈记录id） |
+| `runEsb` | `data.successNum` ≥1 | 触发动作流数 |
+| `addProcessLog` | `data:"SUCCESS"` | 过程日志写入成功 |
+| 回查 | `getCandidateCardInterviewInfo` 该反馈 `result`/`judgement` 已变 | 闭环校验 |
+
+## 7. 错误码 / 失败边界
+
+- **按钮匹配不到**（`getFormButtons` 无 system/editSave 按钮）：拦截提示「当前环境未找到提交评价按钮，可能已被客户调整」，不硬猜。
+- **saveFormData 后端 `layoutVersion null`**：`formLayout.id` 必须用 `getFormDataAndLayout` 的 `formLayout.id`，**不要用 `getFormLayout`**（部分版本该接口 GET 直接 405；`write-op.mjs::getFormLayout` 虽已加 POST 回退，但更新既有记录仍以 `getFormDataAndLayout` 为准）。
+- **乐观锁冲突**：`updateTimeStamp` 必须提交前实时取（每次保存会更新），提交失败提示重试。
+- **结果枚举解析不到**（`ds/options` 无该名称）：列可选项请用户确认，不臆造 optionId。
+- **反馈记录无权限/不存在**：`getFormDataAndLayout` 的 `formData` 为空 → 提示无权限或记录不存在。
+- **部分失败**：saveFormData 成功但 runEsb/addProcessLog 失败 → 如实上报「已完成 X / 失败 Y」，不回滚不重试。
+
+## 8. 注意事项
+
+- **全字段集防清空**：`dataDetails` 必须带反馈记录全部字段（面试主题/batchId/人才/反馈人/结果/评价等），只改 result/judgement 两个字段的值，缺失字段会导致保存时清空（技能红线：不得整条用空字段集覆盖）。
+- **updateTimeStamp 是乐观锁**：提交用最新值；prepare 与 commit 间被他人修改会失效，commit 前需重新获取。
+- **jsCode 动作不解析执行**：按钮的 `jsCode`（如"记录应聘过程"）内联 JS 里的招聘 API（`addProcessLog`）按标准契约**直接调用**，不模拟执行前端 JS；刷新/关闭等前端行为技能不执行。
+- **按钮动作分类**：`system`→保存；`esb`→runEsb；`jsCode`→提取其中后端 API 按契约直调（条件型说明、无法解析拦截）。
+- **跨环境自适应**：不依赖按钮名/ID——以 `actionType`/`buttonKey=editSave`/URL 特征（`/api/recruit/processLog/addProcessLog`）定位；esb 动作流 id 运行时按钮解析，不写死。
+
+## 9. 调用编排（组合写操作）
+
+```
+定位候选人(talentId) → getCandidateCardPrepareQuery 取 batchId
+→ getCandidateCardInterviewInfo 取反馈记录(interviewFeedBack[0].id/result/judgement)
+→ getFormDataAndLayout 取 updateTimeStamp + 全字段 + formLayout.id
+→ getFormButtons(type=2+dataId) 粗定位提交按钮(system/editSave)
+→ analyzeButtonActions 精核验(esbIds + jsCode 招聘 API)
+→ [prepare] 确认摘要(候选人/面试/当前反馈/新反馈/将执行动作)
+→ [commit] saveFormData(全字段+最新updateTimeStamp) → runEsb(esbIds) → addProcessLog
+→ 回查 getCandidateCardInterviewInfo 校验已生效
+```
+
+## 10. 关联接口
+
+- 前置：`getCandidateCardPrepareQuery`（取 batchId）、`getCandidateCardInterviewInfo`（面试+反馈卡片）、`getFormDataAndLayout`（反馈记录数据/updateTimeStamp/formLayout）。
+- 平行：`saveFormData`（EB 通用保存）、`runEsb`（EB 通用动作流）、`addProcessLog`（招聘过程日志）。
+- 关联：`recruit-urge-feedback.md`（催评，另一反馈动作流入口）；`recruit-detail-process.md`（应聘过程卡片，展示 addProcessLog 写入的过程日志）。
+
+## 11. 产物链接（recruit-stage CLI）
+
+`interview.feedback.edit.apply` 成功后返回两个可直接展示的字段：
+- `talentCardUrl`：该人才卡片（点进去可看此候选人的面试与全部反馈）；
+- `interviewListUrl`：面试管理列表页。
+
+展示时作为可点击链接给用户（Markdown 链接），缺字段表示当前环境未配置对应页面，不补造。

package/skills/weaver-e10-recruit-stage/references/recruit-jd-create.md

@@ -0,0 +1,95 @@
+# 招聘启事智能生成 —— 任务主文档（对话生成 JD → 确认 → 自动落库 → 打开列表）
+
+> **平台兼容**：本文命令示例在 macOS/Linux 与 Windows PowerShell 下均可执行——JSON 用单引号包裹、内部双引号不转义；PowerShell 下不使用反斜杠续行。
+
+## 基础信息
+
+| 项目 | 内容 |
+|---|---|
+| 对应需求 | 【人事招聘阶段】2. 招聘启事智能生成（小e 对话触发） |
+| 脚本 | `scripts/recruit-generate-jd.mjs` |
+| 写接口 | `POST /api/ebuilder/form/form/core/saveFormData`（职位管理）→ `POST /api/recruit/candidate/addPosition`（生成职位，body 只带 formDataId，两步流） |
+| 输出结果 | 岗位 JD 初稿（对话展示）+ **两个 Markdown 链接**（职位详情查看页 / 招聘岗位列表·已定位新建职位） |
+| 用途类型 | 用户场景 / **写操作** |
+
+## 交互流程（与需求逐条对应）
+
+| 需求原文 | 实现 |
+|---|---|
+| 1）招聘人员在小e中输入岗位需求描述，并「帮我生成这个岗位的JD」 | 对话抽取岗位要素（名称/职责/要求/人数…），缺项先问 |
+| 2）按照企业招聘标准及岗位要求生成招聘启事和岗位JD初稿 | Agent 按 `recruit-jd-template.md`（企业标准模板）生成**招聘启事 + JD 初稿**，全文展示在对话里 |
+| 3）确认后自动生成到招聘岗位列表中 | 用户确认后跑脚本 `--commit` 自动落库；成功后输出两个 Markdown 链接：职位详情查看页 + **招聘岗位列表（已定位新建职位）** |
+| 交互方式：小e对话框 + 右侧窗口打开招聘岗位列表 | 卡片由前端渲染（标题 + 「在 E10 中打开」按钮）→ 新 tab 打开列表（右栏 iframe 因 SameSite 不可行，见 `recruit-output-links.md`） |
+| 输出结果：岗位JD初稿 | JD 初稿全文在对话里给出；落库的职位记录含职责/要求字段 |
+
+## 使用流程（Agent 执行约定）
+
+1. **抽取岗位要素**：职位名称（必缺先问）、职责、任职要求、招聘人数、用人部门等。信息不足先问，不猜。
+2. **生成 JD 初稿**：按 `recruit-jd-template.md` 的企业标准模板生成招聘启事 + 岗位 JD（职责 4~6 条、要求 4~6 条，贴合用户给的岗位描述）。**全文展示给用户**——这就是需求的"输出结果"。
+3. **字段推导**：从需求 + JD 推导职位管理字段值；不确定的列出来问用户。
+4. **`--prepare`（只读，不写库）**：脚本自动补全必填默认值（状态=招聘中、招聘流程=环境默认流程、招聘负责人/用人经理=当前登录人等），输出确认摘要。把摘要**用中文复述**给用户（不展示字段 key 与内部 id）。
+5. **用户明确确认后**才 `--commit`（写真实数据）。
+6. **输出产物**：把脚本输出的**两个 Markdown 链接**按顺序放在回答正文里：先 `viewLink`（新建职位详情查看页），再 `listLocateLink`（招聘岗位列表 + 自动滑出本次新建职位详情的组合页）；JD 初稿全文在正文里。**不要用 browsertool 卡片**（fill_form 在非表单页卡死，实测；见 `recruit-output-links.md`）。
+7. **告知**：「职位已建好，点卡片上的『在 E10 中打开』可查看招聘岗位列表；JD 初稿如需调整，告诉我改哪里，我更新后再建」。
+
+## 脚本用法
+
+```bash
+# ① 只出确认摘要（不写库）
+node scripts/recruit-generate-jd.mjs --prepare \
+  --position-name "Java开发工程师" \
+  --position-duty "<职责正文，可多段>" \
+  --work-request "<任职要求正文，可多段>" \
+  [--set <字段dataKey>=<值> ...]        # AI 依 JD 指定字段值（可多次），如 --set recruit-count=2
+
+# ② 用户确认后写库
+node scripts/recruit-generate-jd.mjs --commit ...同参数...
+```
+
+### 关键输出字段（--commit）
+
+| 字段 | 含义 |
+|---|---|
+| `result: success` | 落库成功 |
+| `formDataId` | 职位管理记录 id（内部值，不给用户看） |
+| `positionListUrl` | 招聘岗位列表 URL（菜单入口形态） |
+| `positionListLocateUrl` | **列表 + 滑出新建职位详情**的组合页 URL（`/sp/ebdfpage/list/{listId}/card/0/{objId}/{dataId}/{listId}?id=…`，2026-10-21 实测简化版可用） |
+| `positionCardUrl` | 本次新建职位的卡片单页 URL（作为普通链接给用户） |
+| `viewLink` | **Markdown 链接①**：新建职位详情查看页（原样放回答正文） |
+| `listLocateLink` | **Markdown 链接②**：招聘岗位列表（已定位新建职位，原样放回答正文） |
+| `rpaChecked` | RPA 发布校验结果（false 时提示用户关注 `rpaValidMsg`） |
+
+### 必填默认值（脚本自动补，无需用户逐项给）
+
+状态=招聘中、招聘流程=当前环境默认启用流程、招聘负责人/用人经理=当前登录人、招聘人数等数值/枚举类按 JD 推导或环境默认。字段 id、枚举 id、菜单 id、appId **全部运行时解析**，跨环境不写死。
+
+> **招聘流程取值来源（四层，v1.0.20 起）**：
+> ① legacy 缓存 `defaultRecruitFlow` → ② 「招聘流程」菜单列表（`listInit` 反查 objId → `getListDatas`）→ ③ 旧接口 `/api/recruit/position/recruitFlow/list` → ④ **自用系统写死兜底**。
+> ④ 仅在 `selfUse=1` **且**域名为 `www.e-cology.com.cn` 时生效（自用系统只有一条「初筛+面试+offer阶段」），其他环境不受影响。
+> 四层全未命中时**不写该字段**，表单自身默认值生效——结果仍正确，摘要显示「（沿用表单默认值）」。解析失败**不缓存**，下次会重试。
+
+> ⚠️ **继承字段必须在摘要里核对（v1.0.20 起）**：`DEF_FROM_REF` 这批默认值（岗位性质、职位类别、学历、经验、工作地点、薪资上下限）来自**环境内最近一条职位记录**，不是用户指定的。
+> 摘要新增两个字段：
+>
+> | 字段 | 含义 |
+> |---|---|
+> | `inheritedFromRef` | 实际继承的字段清单 `[{field, value}]` |
+> | `inheritedNote` | 提示语：「以上字段未指定，值继承自环境内最近一条职位记录，可能含历史脏数据（如重复地点），请核对后再提交」 |
+>
+> **这两个字段存在时，Agent 必须在确认摘要里点名列出继承来的值，提示用户核对**——实测该环境继承出过重复地点这类脏数据。**不得因为 `inheritedNote` 是系统提示语就略过不报。**
+>
+> 🔴 **薪资不参与继承（v1.0.20 起）**：`salary_min` / `salary_max` 已从继承清单移除（历史职位薪资可能是脏数据，实测抓到过 `300.00`）。薪资一律按 [`position-templates.md`](position-templates.md) §1.1 的推荐区间取；用户明确给了就用用户的；未给且表里无对应档就留空，由用户补。
+
+> **`work_location` 可正常通过 `sets` 指定（v1.0.20 修复）**：原实现读 `cache.menus` 找「办公地点」菜单，但该环境缓存**没有 `menus` 字段** → 恒取不到 → 无论传什么都进 `setSkipped`。
+> 现改为三级来源：`lists.all_search` → `cache.menus`（若存在）→ `allMenus` 接口兜底，`cusMenuId` 不再作为硬条件。
+> 实测传入完整地址「上海市闵行区三鲁公路3419号泛微软件园」后成功进 `setApplied`。
+> ⚠️ 提交 `sets` 后**必须检查 `setApplied` / `setSkipped`**：`setSkipped` 非空即该值未写入。
+
+## 执行纪律（强制）
+
+1. **写操作必须先确认**：`--prepare` 摘要经用户明确确认后才可 `--commit`；**禁止跳过确认直接写库**。
+2. **不臆造参数**：字段值只能来自用户输入、JD 推导或脚本默认值；`--set` 的键必须是脚本认识的 dataKey。
+3. **不暴露内部标识**：对用户只写中文（「招聘中」「2 人」），不展示字段 key、optionId、formDataId。
+4. **不输出凭证**：不展示 Cookie / ETEAMSID / token。
+5. **产物纪律**：`viewLink` / `listLocateLink` 两个 Markdown 链接按顺序原样搬运；不要包 browsertool 标签（fill_form 在非表单页卡死，实测）；url 缺失时只给另一个，不输出半截。
+6. **环境自适应**：baseUrl / appId / 字段 id 一律来自会话与环境解析，**任何文件不得写死 IP / 域名 / 端口**；目标环境未部署招聘应用时脚本会给出友好提示，如实转告。

package/skills/weaver-e10-recruit-stage/references/recruit-jd-template.md

@@ -0,0 +1,56 @@
+---
+name: recruit-jd-template
+description: 招聘启事 / 岗位JD 的企业标准模板与撰写规范——生成JD 与招聘启事时以本文件为准；企业有内部模板时直接替换本文件内容即可
+---
+
+# 招聘启事 / 岗位JD 文案模板（企业标准）
+
+> **用途**：`recruit-jd-create.md` §2.2「招聘启事 / 岗位JD 文案生成规范」的**标准来源**。
+> **可替换**：企业有内部 JD 模板 / 话术 / 品牌口径时，**直接替换本文件正文**（保留章节骨架），生成即按企业标准执行；未替换则用下方**通用兜底**。
+
+## 1. 生成两件产物
+| 产物 | 去向 | 形态 |
+|---|---|---|
+| **招聘启事**（对外文案） | 对话展示，**不落库**（职位管理表单无"启事"字段，已核 583 字段） | markdown 文案 |
+| **岗位JD初稿**（结构化） | 落库 `position_duty`（职位职责）+ `work_request`（任职要求） | 多条、换行分隔、行首**不加** `-` |
+
+## 2. 招聘启事模板（通用兜底，可替换）
+```markdown
+# <岗位名称>（<工作地点>｜<招聘人数>人）
+
+## 岗位职责
+1. <职责 1：动词开头，含对象与结果>
+2. <职责 2>
+…（5–8 条）
+
+## 任职要求
+1. <要求 1：学历/年限/技能，可衡量>
+2. <要求 2>
+…（4–6 条）
+
+## 我们提供            # 可选，仅在有依据时写
+- <薪酬范围 / 福利 / 成长空间；无依据则不写>
+
+## 应聘方式            # 可选
+- <投递渠道 / 联系方式；无依据则不写>
+```
+
+## 3. 撰写规范（硬性）
+- **可衡量、可核对**：职责用"动词 + 对象 + 结果"；要求给学历/年限/技能等可判定条件，避免"优秀""较强"等空话。
+- **条数**：职责 5–8 条、要求 4–6 条，每条一行。
+- **字段联动**：启事里的地点/薪资/学历/年限应与传给脚本的 `--set`（`work_location` / `education` / `work_years` / `salary_min|max`）**保持一致**。
+- **两份产物同源**：JD 初稿的职责/要求必须与启事正文**逐条一致**（不得一份删改）。
+- **可参考系统已有职位**：生成前可 `recruit-list.mjs --type position` 拉同类职位，对齐措辞与字段取值。
+
+## 4. 红线
+- **不得编造**：用户未提供的薪资/地点/学历/人数，一律写"面议 / 待定 / 不限"或**直接不写**；不得虚构福利、上市信息、团队规模。
+- **不得歧视**：不出现性别、年龄、婚育、户籍/地域、民族、宗教、残障等歧视性表述。
+- **不得承诺**：不写"保证录用""包住宿（未确认）"等无依据承诺。
+- 合规要求沿用手册：**招聘启事内容须符合当地劳动与广告法规**。
+
+## 5. 企业标准替换指引
+替换时请保持以下**结构契约**不变（技能按此读取）：
+1. 第 1 节两张产物表的**字段落点**（`position_duty` / `work_request`）不变；
+2. 第 3 节的**条数与同源**规则可调，但需保留"职责/要求分列"；
+3. 第 4 节**红线不得删除**（可加严，不可放宽）。
+> 如需新增企业专有章节（如"企业文化""团队介绍"），追加在 `## 我们提供` 之后即可。