weaver-work-cli 0.1.40 → 0.1.42

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,73 @@
+# 招聘启事智能生成 —— 任务主文档（对话生成 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 **全部运行时解析**，跨环境不写死。
+
+## 执行纪律（强制）
+
+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 节**红线不得删除**（可加严，不可放宽）。
+> 如需新增企业专有章节（如"企业文化""团队介绍"），追加在 `## 我们提供` 之后即可。

package/skills/weaver-e10-recruit-stage/references/recruit-list-candidate.md

@@ -0,0 +1,101 @@
+---
+name: recruit-list-candidate
+description: 查询应聘者列表（候选人台账），支持按职位/人才/批次精确筛选与翻页取全，返回候选人、职位、阶段、渠道、手机/邮箱等，用于「看某职位的候选人」与「按岗位找/筛候选人」
+---
+
+# 查询应聘者列表
+
+> **平台兼容**：本文命令示例在 macOS/Linux 与 Windows PowerShell 下均可执行——JSON 用单引号包裹、内部双引号不转义；PowerShell 下不使用反斜杠续行。
+
+> 本文档示例中的 `env` / `form_data_id` / `talent_id` 等均为**实测环境的参考值**（不同环境全部不同）；运行时按菜单别名 / `ds/fields` 解析，**不得写死**（见 `recruit-resolve-metadata.md`）。
+
+## 1. 基础信息
+- 接口名称：查询应聘者列表（候选人台账）
+- 请求方式：`POST`
+- 去域名路径：`/api/ebuilder/form/list/getListDatas`（与搜索人才/需求/职位同族列表接口）
+- 脚本：`node scripts/recruit-list.mjs --type candidate [--position-id <id>] [--talent-id <id>] [--all]`
+- 所属模块：招聘管理（recruit）
+- 所属分组：应聘者 / 查询
+
+## 2. 业务用途
+用户说"**这个职位有哪些候选人**""看下 X 职位的应聘者""**帮我找到适合这个岗位的候选人**""筛优质候选人"时调用。返回「应聘者」列表（候选人台账），每行含候选人、应聘职位、当前阶段、渠道、手机/邮箱、人才 id。属只读查询，**无需确认门**。
+
+> 需求对应：【人事招聘阶段 3】④「帮我找到适合这个岗位的候选人，筛选优质候选人」——本接口提供**候选人数据**，匹配度打分/排序由 AI 完成（见 `recruit-match-candidates.md`）。
+
+## 3. 前置条件
+- 已安装招聘服务（第 0 步闸门通过）。
+- **列表参数解析（跨环境、不写死）**：优先环境缓存 `lists.candidate`；缺失时**按菜单名「应聘者」从菜单树解析** `listId`/`cusMenuId`（脚本已内置该回退）。表单 `objId` 经 tag 或缓存 `forms.candidate_manage` 解析。
+- 上下文参数按 `recruit-resolve-metadata.md` §7 全带（缺则假空）。
+
+## 4. 请求参数
+
+### 4.1 Query
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `passid` / `cid` | query | string | 是 | 应聘者表单 `objId` |
+
+### 4.2 Body（getListDatas 同族）
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `listId` | body | string | 是 | 应聘者列表视图 id（`lists.candidate` 或「应聘者」菜单） |
+| `cusMenuId` | body | string | 是 | 同上菜单 id |
+| `searchParamData` | body | object | 是 | `{ "searchType":"3", "type":"and" }` + 可选 `commonSearchFields`（服务端条件，**实测对 `position_id` 不生效**，见 §4.3） |
+| 上下文参数 | body | — | 是 | `terminal`/`browser`/`requiredMatch`/`mapResult`/`recheckQuery`/`isFollow`/`isShareToMe`/`filterCondition`/`urlPageTitle`/`menuName` |
+
+### 4.3 脚本筛选参数（**客户端本地等值筛选，跨环境稳定**）
+| 参数 | 对应 dataKey | 说明 |
+|---|---|---|
+| `--position-id <职位id>` | `position_id` | 只保留该职位的候选人 |
+| `--talent-id <人才id>` | `talent_id` | 只保留该人才的批次 |
+| `--candidate-manage-id <批次id>` | `candidate_manage_id` | 只保留该批次 |
+| `--all` | — | **翻页取全后再筛**（`--max-pages` 上限默认 20）——按职位筛「务必加 `--all`**，否则只筛第一页 |
+
+> 实测：服务端 `commonSearchFields` 传 `position_id like` 返回**未过滤**的结果（0 效果），故筛选**一律在客户端按 dataKey 等值做**；`--all` 保证扫的是全量而不是首页 20 条。
+
+## 5. 响应数据结构（行字段）
+| 字段 | 说明 |
+|---|---|
+| `candidate_name` | 候选人姓名 |
+| `position_name` / `position_id` | 应聘职位名 / 职位 id |
+| `stage_name` / `stage_type_key` | 当前阶段（初筛 / 面试 / 待入职 …） |
+| `resume_channel` | 渠道（手动录入 / 内部推荐 / BOSS直聘 / 培训机构 …） |
+| `telephone` / `email` / `gender_name` | 手机 / 邮箱 / 性别 |
+| `talent_id` | 人才 id（人才卡片 URL 输出契约见 `recruit-output-links.md`） |
+| `create_time` | 投递/创建时间 |
+| `form_data_id` | 应聘记录 id |
+
+## 6. 请求示例
+```bash
+# 某职位的全部候选人（先翻页取全再本地筛）
+node scripts/recruit-list.mjs --type candidate --position-id <职位id> --all --page-size 20
+# 只看首页 20 条内符合条件的
+node scripts/recruit-list.mjs --type candidate --position-id <职位id> --page-size 20
+```
+
+## 7. 响应示例（脚本）
+```json
+{ "env": "<测试环境地址>", "type": "candidate", "total": 75, "returned": 14, "filters": ["职位"],
+  "rows": [
+    { "candidate_name": "陈宇", "position_name": "AI工程师", "stage_name": "初筛", "resume_channel": "手动录入",
+      "telephone": "13800000003", "talent_id": "1325294055798906885" }
+  ] }
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 非 200 | 认证/参数错误 | 检查认证 / `listId`/`cusMenuId` |
+| 菜单未匹配 | 环境未启用「应聘者」菜单 | 按 `recruit-capability-check.md` 拦截，不硬凑近似菜单 |
+| 筛选后 0 行 | 该职位确无候选人，或未加 `--all` 只扫了首页 | 加 `--all` 复跑一次再下结论 |
+
+## 9. 调用参考
+- 用户场景："这个职位有哪些候选人""帮我找到适合这个岗位的候选人"。
+- **流程**：能力探测 → 解析 `objId`/`listId`/`cusMenuId` → `--position-id` + `--all` 取候选人 → 展示或交给 `recruit-match-candidates.md` 打分排序。
+- 与 `recruit-search-candidate.md` 的区别：那个是**按手机/姓名/渠道在人才库搜**；本接口是**按职位查应聘者台账**（候选人维度）。
+
+## 10. 注意事项
+- **只读查询，无确认门**。
+- **菜单名跨基线不同**：「应聘者」（环境A） / **「应聘管理」**（环境B）——脚本按别名数组匹配，不写死。
+- **阶段字段跨基线不同**：`stage_name`（环境A） / **`stage_type_key`**（环境B）→ 已归一到 `stage_name`。
+- **按职位筛必须加 `--all`**：服务端不做该筛选，本地筛只作用于已取回的行。
+- 展示行内不输出无意义裸 id；`talent_id` 保留（供查看详情/打开人才卡片）。

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

@@ -0,0 +1,148 @@
+---
+name: recruit-list-interview
+description: 查询面试管理列表（面试安排），支持按「近 N 天」过滤与按开始时间排序，返回候选人/职位/面试方式/环节/轮次/面试官/时间/反馈状态，用于「查看近期的面试安排」
+---
+
+# 查询面试安排列表
+
+> **平台兼容**：本文命令示例在 macOS/Linux 与 Windows PowerShell 下均可执行——JSON 用单引号包裹、内部双引号不转义；PowerShell 下不使用反斜杠续行。
+
+> 本文档示例中的 `env` / `form_data_id` / `talent_id` 等均为**实测环境的参考值**（不同环境全部不同）；运行时按菜单别名 / `ds/fields` 解析，**不得写死**（见 `recruit-resolve-metadata.md`）。
+
+## 1. 基础信息
+- 接口名称：查询面试管理列表（面试安排）
+- 请求方式：`POST`
+- 去域名路径：`/api/ebuilder/form/list/getListDatas`（与搜索人才/需求/职位同族列表接口）
+- 脚本：`node scripts/recruit-list.mjs --type interview [--recent <N>] [--sort start_time] [--page-size 20]`
+- 所属模块：招聘管理（recruit）
+- 所属分组：面试 / 查询
+
+## 2. 业务用途
+用户说"**查看近期的面试安排**""这周有哪些面试""X 的面试安排在什么时候""谁还没反馈面试"时调用。返回「面试管理」列表，每行含候选人、职位、面试时间、面试方式、环节/轮次、面试官、反馈状态。属只读查询，**无需确认门**。
+
+> 需求对应：【人事招聘阶段 4】① 招聘人员在小e 中询问「查看近期的面试安排」——本接口即该问句的数据底座；右侧窗口用 artifact 打开「面试管理」列表（见 §9）。
+
+## 3. 前置条件
+- 已安装招聘服务（第 0 步闸门通过）。
+- **能力探测**：面试计划表单 `objId` 经 tag `uf_rcrt_interview_plan` 解析；列表 `listId`/`cusMenuId` 取环境缓存的 `lists.interview`（运行时解析，跨环境不写死）。缺失 → 按 `recruit-capability-check.md` 判定"未启用"，提示「当前环境未提供面试管理功能」，不硬凑。
+- 上下文参数按 `recruit-resolve-metadata.md` §7 全带（缺则假空）。
+
+## 4. 请求参数
+
+### 4.1 Query
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `passid` / `cid` | query | string | 是 | 面试计划表单 `objId` |
+
+### 4.2 Body（getListDatas 同族）
+| 字段 | 位置 | 类型 | 必填 | 业务说明 |
+|---|---|---|---|---|
+| `listId` | body | string | 是 | 面试列表视图 id（`lists.interview.listId`） |
+| `cusMenuId` | body | string | 是 | 同上菜单 id |
+| `searchParamData` | body | object | 是 | `{ "searchType":"3", "type":"and" }`（条件见 §4.4） |
+| 上下文参数 | body | — | 是 | `terminal`/`browser`/`requiredMatch`/`mapResult`/`recheckQuery`/`isFollow`/`isShareToMe`/`filterCondition`/`urlPageTitle`/`menuName` |
+| `current` / `pageSize` | body | int | 否 | 分页（脚本 `--page` / `--page-size`） |
+
+### 4.3 脚本本地过滤/排序（**不依赖服务端，跨环境稳定**）
+| 参数 | 说明 |
+|---|---|
+| `--recent <N>` | 仅保留 `start_time` 在**近 N 天**内的行（本地按数据里的时间字符串判定；需求"近期"由它落地） |
+| `--sort <dataKey>` | 按该字段**倒序**排序（时间类取最新在前，如 `--sort start_time`） |
+| `--all` | 翻页取全量后再过滤/排序（`--max-pages` 控制上限，默认 20） |
+
+> 实测：服务端 `commonSearchFields` 对**时间字段**筛选不稳定，故"近期"一律在本地做（`--recent`）。
+
+## 5. 响应数据结构（行字段）
+| 字段 | 说明 |
+|---|---|
+| `candidate_name` | 候选人姓名 |
+| `position_name` | 应聘职位 |
+| `start_time` / `end_time` | 面试开始 / 结束时间（`yyyy-MM-dd HH:mm`） |
+| `interview_session` | 环节（初试/复试…） |
+| `interview_type_key` | **面试方式**（现场面试 / 视频面试 / 电话面试 / **AI面试**） |
+| `interview_rounds` | 轮次（第一轮/第四轮…） |
+| `interviewer` | 面试官 |
+| `union_status_key` | 反馈状态（待反馈 / 已反馈…） |
+| `subject` | 面试主题（如「AI工程师-李沐的面试」） |
+| `talent_id` / `position_manage_id` / `candidate_manage_id` | 人才 / 职位 / 应聘批次 id（下游编排用） |
+| `form_data_id` | 面试记录 id（详情/反馈用） |
+
+> ⚠️ `interview_type_key`、`interview_rounds` 在 displayData 里**偶尔回退成 optionId**；脚本已做 `ds/options` 运行时映射回中文（映射不到才保留原值）。
+
+## 6. 请求示例
+```bash
+# 查看近期（30 天内）面试安排，按开始时间倒序，取全量
+node scripts/recruit-list.mjs --type interview --recent 30 --sort start_time --all --page-size 20
+# 不加 --recent 则返回列表默认顺序的全部页；--page-size 控制单页
+node scripts/recruit-list.mjs --type interview --page-size 10
+```
+
+## 7. 响应示例（脚本）
+```json
+{ "env": "<测试环境地址>", "type": "interview", "total": 16, "totalExact": true,
+  "recentDays": 30, "returned": 3,
+  "rows": [
+    { "candidate_name": "李沐", "position_name": "AI工程师", "start_time": "2026-10-10 13:19", "end_time": "2026-10-17 13:19",
+      "interview_session": "初试", "interview_type_key": "AI面试", "interview_rounds": "第四轮",
+      "interviewer": "招聘专员", "union_status_key": "待反馈", "subject": "AI工程师-李沐的面试",
+      "talent_id": "1276382457065553922", "position_manage_id": "1276382220792020998" }
+  ] }
+```
+
+## 8. 错误码
+| 错误码 | 含义 | AI 处理建议 |
+|---|---|---|
+| 非 200 | 认证/参数错误 | 检查认证（`weaver-work-cli auth status`）/ `listId`/`cusMenuId` |
+| `rows` 空 | 无面试记录 / 或 `--recent` 过滤后无命中 | 去掉 `--recent` 复跑一次再判"无记录" |
+| 菜单未匹配 | 环境未启用面试管理 | 拦截提示，不硬凑 |
+
+## 9. 调用参考
+- 用户场景："查看近期的面试安排""这周的面试""谁还没反馈"。
+- **流程**：能力探测（面试菜单存在）→ 解析 `objId`/`listId`/`cusMenuId` → `--recent N` 过滤 + `--sort start_time` → 展示（按"时间 → 候选人（职位）· 方式 · 环节/轮次 · 面试官 · 反馈状态"排版）。
+- **右侧窗口**：小E 场景可在回答末尾附 `<artifact>[{"file_name":"面试管理","file_type":"url","url":"<面试管理列表URL>"}]</artifact>` 让右侧打开面试管理列表（URL 拼装见 `recruit-arrange-interview.md` §11 `interviewListUrl`）。
+
+## 10. 注意事项
+- **只读查询，无确认门**。
+- **跨基线列名不同**（环境B用 `name`/`interview_type`/`union_status`，且 `talent_id`/`position_manage_id` 直接给文本）→ 脚本已用 `DISPLAY_ALIASES` 归一为 `candidate_name`/`interview_type_key`/`union_status_key`；**调用方按归一后的字段读，别按环境分支判断**（详见 `recruit-resolve-metadata.md`）。
+- "近期"由 `--recent N` 落地（本地判定），**不要臆造服务端时间筛选参数**。
+- `total` 在部分列表不可信（某环境实测计数返回 167994，明显虚高）：以 `scanned`（实际取回）与 `returned`（过滤后）为准；`--all` 触达 `--max-pages` 上限时 `totalNote` 会提示。
+- 展示时间统一 `yyyy-MM-dd HH:mm`；行内不输出无意义的 16 位裸 id（`talent_id` 等业务 id 保留，供下游编排）。
+
+## 10. 面试待办：`--feedback-todo`（只返回我要填反馈的）
+
+```bash
+node scripts/recruit-list.mjs --type interview --feedback-todo
+```
+
+固定输出两个分组（**只含我作为面试官的记录**，不返回全量面试列表）：
+
+| 分组 | 含义 | 判据 |
+|---|---|---|
+| `myAiPendingFeedback` | **AI 面试已答完、已有录像、我还没填意见** ← 主清单 | 待反馈 + AI面试 + 面试官含我 |
+| `myOtherPendingFeedback` | 我作为面试官的其他方式面试待反馈（现场/视频/电话） | 待反馈 + 面试官含我 |
+
+**为什么不用看视频字段**：后端 `InterviewStatusEnum.TO_FEEDBACK`（待反馈）的置位条件是
+`InterviewPlanStatusPerPlanThread` 判定的「AI 面试结束时间已过 且（有录像附件 或 已开始录制）且 反馈结果为空」
+——**「待反馈」本身就等于「已完成 + 有视频 + 未填意见」**，技能侧无需再读视频字段（`video_url_info` 是「视频面试地址」，HR 手填的会议链接，与录像无关）。
+
+取数策略（面试列表服务端筛选不生效，只能客户端筛）：
+- 自动隐含 `--all`，默认 `--page-size 200`、`--max-pages 5`（约 1000 条，实测 4–5 秒）
+- 输出 `scanned` 与实际总数对比，并在 `note` 提示是否需要加大 `--max-pages`
+- 当前用户由 `teamsCheck` 解析（`currentUser.username`），失败时 `mine` 为空并给出 note
+
+输出示例：
+
+```json
+{
+  "feedbackTodo": {
+    "currentUser": "李伟（上海）",
+    "scanned": 1000,
+    "myAiPendingFeedback": { "count": 1, "rows": [{ "candidate_name": "2606基线测试", "position_name": "大模型算法工程师", "start_time": "2026-10-27 11:47", "interview_session": "初试", "union_status_key": "待反馈", "form_data_id": "..." }] },
+    "myOtherPendingFeedback": { "count": 0, "rows": [] },
+    "note": "已扫描 1000/168386 条（面试列表默认顺序），未覆盖全部；如怀疑遗漏可加 --max-pages N 扩大"
+  }
+}
+```
+
+> 时效性：待反馈状态由 E10 调度任务 `RecruitSyncInterviewPlanStatusTask` 定时同步（非实时），
+> 刚结束的 AI 面试可能有几分钟延迟；提示语里应说明「以系统状态为准」。

package/skills/weaver-e10-recruit-stage/references/recruit-match-candidates.md

@@ -0,0 +1,77 @@
+---
+name: recruit-match-candidates
+description: 按岗位找/筛优质候选人——用应聘者列表 + 职位 JD 做 AI 人岗匹配打分与排序，输出候选人评分卡与建议清单（不落库、不改状态）
+---
+
+# 按岗位找 / 筛优质候选人（人岗匹配）
+
+## 1. 业务用途
+用户说"**帮我找到适合这个岗位的候选人**""筛一下优质候选人""这个职位谁最合适""按 JD 帮我排个优先级"时走本编排。输出**候选人评分卡 + 建议清单**，并在小E 场景可在右侧打开人才卡片。
+
+> 需求对应：【人事招聘阶段 3】④「招聘人员在小e 中询问『帮我找到适合这个岗位的候选人』，筛选优质候选人」。
+
+## 2. 能力边界（重要，先对齐）
+- **没有"人岗匹配度"后端接口**：`api-index` 全量端点中**无** match/score/degree 类接口；招聘侧 `label` 只有"标签匹配"（`matchTalentLabel`），**不是匹配度**。
+- 因此**匹配度 = AI 评估能力**（与《AI人岗智能匹配_功能表述参考》讲稿一致）：解析 JD → 建"岗位能力模型" → 逐维比对候选人 → 输出匹配率与优劣势。
+- **不落库**：`uf_rcrt_talent_pool` / 候选人记录**没有匹配度字段**（已核 95 个字段）；本能力只**输出评分与建议**，不回写、不改候选人阶段/状态。
+
+## 3. 数据底座（全部只读）
+| 数据 | 来源 |
+|---|---|
+| 目标职位（含 JD 职责/要求） | `recruit-list.mjs --type position` 定位 → 详情取 `position_duty` / `work_request` / `education` / `work_years` / `work_location` / `recruit_count` |
+| 该职位的候选人 | `recruit-list.mjs --type candidate --position-id <职位id> --all --page-size 20`（见 `recruit-list-candidate.md`） |
+| 候选人细节（可选，用于逐维比对） | `recruit-detail.mjs --talent-id <talent_id>`（基础信息/教育/工作经历，见 `recruit-detail-*.md`） |
+| 简历原文（可选） | 人才卡片「原始简历」（见 `recruit-resume-import.md` §11 / `recruit-resume-parse.md`） |
+
+## 4. 打分模型（AI 侧执行，维度可依企业标准调整）
+| 维度 | 权重 | 判据（来自 JD 与候选人数据） |
+|---|---|---|
+| 硬性条件 | 高 | 学历、工作年限、工作地点、必要证书 |
+| 硬技能 | 高 | JD 职责/要求中的技术栈/工具/行业经验 vs 候选人技能与工作经历 |
+| 经验相关性 | 中 | 行业/岗位相关性、项目复杂度、管理与协作经验 |
+| 加分项 | 低 | 名企背景、外语能力、可立即到岗等 |
+| 风险点 | — | 频繁跳槽、经验断层、地点不符等（单列提示，不直接降分） |
+
+**产出**：每位候选人 `匹配度（0–100 或 高/中/低）` + `命中点` + `缺口` + `一句话建议`。
+
+## 5. 执行流程（Agent 编排）
+1. **定位职位**：`node scripts/recruit-list.mjs --type position` 找目标职位 → 拿职位 `form_data_id` 与 JD 文本（缺失则读职位详情）。
+2. **取候选人**：`node scripts/recruit-list.mjs --type candidate --position-id <职位id> --all --page-size 20`。
+3. **（可选）补细节**：对前若干名调 `recruit-detail.mjs --talent-id <id>` 取教育/工作经历，做逐维比对。
+4. **AI 打分排序**：按 §4 维度逐人评分，输出**评分卡表格**（默认 Top 5–10）。
+5. **展示与跳转**：给出建议清单；小E 场景附 `<artifact>` 打开人才卡片或人才管理列表（见 §6）。
+
+## 6. 输出样式
+```markdown
+**<职位名> · 候选人匹配度（共 N 人，按匹配度排序）**
+
+| # | 候选人 | 匹配度 | 命中 | 缺口 | 建议 |
+|---|---|---|---|---|---|
+| 1 | 李沐 | 高（88） | 5年Java、AI项目经验；地点匹配 | 学历未达"本科" | 优先安排面试 |
+| 2 | 何子元 | 中（65） | 技能匹配 | 年限偏少（1年） | 可作备选 |
+```
+- 匹配度**必须给依据**（命中/缺口逐条），不空喊分数；
+- **缺失数据不编造**：学历/年限缺就写"信息缺失"，标注需人工核对。
+
+## 7. 右侧打开（小E 场景）
+- 打开**人才卡片**：`{baseUrl}/sp/ebdpage/view/{ebdDetailPageId}?talentId={talent_id}`（见 `recruit-resume-import.md` §11）
+- 打开**人才管理/应聘者列表**：用菜单拼装（同 `recruit-list-interview.md` §9 范式）
+- 用法：把 `<artifact>[{"file_name":"…","file_type":"url","url":"…"}]</artifact>` 附在回答正文末尾（**仅小E**；WorkBuddy 桌面端不解析）。
+
+## 8. 错误码 / 异常处理
+| 情况 | 处理 |
+|---|---|
+| 职位下无候选人 | 提示"该职位暂无候选人"，并给出「人才库按关键词搜」的替代路径（`recruit-search-candidate.md`） |
+| 筛选后 0 行 | 检查是否漏了 `--all`（只扫了首页） |
+| 候选人教育/经历缺失 | 标注"信息缺失"，不臆测；必要时先 `recruit-detail.mjs` 补取 |
+| 环境未启用「应聘者」菜单 | 按 `recruit-capability-check.md` 拦截，不硬凑 |
+
+## 9. 调用参考（一句话触发示例）
+- "帮我找 AI工程师 这个岗位合适的候选人" → 取候选人 + AI 打分 Top N。
+- "这个职位的候选人帮我排个优先级" → 同上，输出排序表。
+- "李沐适合这个岗位吗" → 单人对单岗评分卡。
+
+## 10. 注意事项
+- **只读、不落库、不改状态**：不写匹配度、不改候选人阶段、不发通知。
+- **不替代业务决策**：评分是辅助建议，最终以 HR 判断为准；展示时明确"AI 评估，仅供参考"。
+- **维度可配置**：若企业有"岗位能力模型/招聘标准"，以其为准（见 `recruit-jd-template.md`），本文件 §4 为通用兜底。