泛微E10聚才林人事管理

概述

本 SKILL 是聚才林人事管理四大模块的统一入口（总纲 + 路由）。按用户意图分发到 references/ 下扁平的 <module>-module.md 模块文档执行。本文件不含模块技术细节——模块特有逻辑（接口文档、防坑、脚本）都在各模块文档内。

模块路由

使用流程（路由）

1. 判断意图 → 定位模块：按上表把用户请求归入 4 大模块之一；跨模块请求（如"查某员工的考勤和工资"）分别路由到对应模块。
2. 读模块文档：读取该模块的 references/<module>-module.md（模块总说明 + 模块内路由 + Agent 执行指引 + 防坑要点）。
3. 定位接口：按 module.md 指引读取 references/<module>-catalog.md（接口目录）与对应单接口文档，按文档构造请求。
4. 执行：按文档构造请求；完整接口地址前缀与认证（cookie）由 weaver-e10-login 提供，本技能文档只描述去域名内部路径。

前置依赖

本 Skill 依赖以下外部 skill，使用前需确保已安装并可用：

• 调用前取得：baseUrl（e10-login profile current 或 whoami 返回）与 Cookie（e10-login whoami 的 cookies.raw 完整原始串）。
• 登录：e10-login oidc --base-url <url>（或 e10-login set --eteamsid <id> --base-url <url>）。

规范红线（通用约束）

• 禁止写死 / 自带认证：域名、IP、端口、认证字段不得写入任何文档；完整接口地址与认证由 weaver-e10-login 提供，本技能不实现认证。
• 请求头：查询类接口请求头须带 X-Requested-With: XMLHttpRequest（详见各模块文档）。
• 写操作确认：报表重算、申诉、新建应聘者、安排面试、发 Offer、办理入职等写操作，执行前必须获得用户明确确认。

安全红线

• 读侧零密钥零解密（纯消费模式）：本技能不读 auth 文件、不持有任何密钥、不解密。会话一律由 e10-login whoami 输出（读取 stdout 的 baseUrl / ETEAMSID / cookies）；e10-login 内部实现变化不影响本技能。
• 源码零凭据：源码（含注释）中不得出现任何密钥/令牌字面量；调用脚本时凭证经环境变量传递，命令行参数只保留非敏感配置（如 --base-url），cookie 必须使用 whoami 输出的完整 raw 串（生产网关需要）。
• TLS 校验默认启用：默认走系统 CA 正常校验证书，仅在显式 --insecure 时关闭（与生产网关配套调整时使用）。

执行纪律（防自主发挥，强制）

1. 禁止编造命令与参数：脚本命令、flag、取值只能来自本文件、对应模块文档列出的命令契约，或脚本 --help 输出；接口请求参数只能来自该接口 references 文档列出的字段契约。契约里不存在的命令/参数/组合一律禁止执行；不确定命令是否存在 → 停止并向用户说明能力边界，不猜、不试。
2. 禁止读脚本源码找答案：执行期间不得读取 scripts/*.mjs 源码、内部治理文件来"猜测怎么调"，只按文档列出的命令执行（维护/排障本技能时除外）。
3. 结果与任务不符 → 禁止重试，直接停止反馈：命令正常返回但结果不符合用户任务（对象不对、字段没生效、返回与请求不符）时，不得换参数/换接口/加条件再试；原样转述脚本返回的 userMessage（无则说明脚本返回的能力边界/状态），如实告知用户"该命令/结果与您的任务不符，无法完成"，请用户确认意图或调整需求。同一命令连续 2 次失败必须停止，不得第 3 次重试。
4. 登录问题第一动作 = 提示重新登录：接口 401 / token 失效 / 未登录时，立即停止并提示用户执行 e10-login oidc --base-url <E10 地址>（无法走浏览器回调时 e10-login set --eteamsid <id> --base-url <地址>）；禁止换请求头/换参数/换路径绕过；e10-login status 显示的登录态为本地缓存，不得据此判断会话真实有效。
   • 唯一例外（小E 环境免浏览器续期）：脚本判定运行于小E 时，会自动执行一次免浏览器续期后重试一次请求——小E 客户端用 e10-login xiaoe（读客户端当前会话），云端沙箱（网页版）用 e10-login xiaoe-env（用平台注入凭据兑换）；均不弹浏览器、不打断用户，续期失败仍按上述口径提示。运行端判定优先级（判据均为平台注入的显式信号，不依赖任何安装路径 / 目录特征）：① E10_AUTO_RENEW=1/0 强制开关 → ② 平台端类型 XIAOE_CLIENT_TYPE（mobile = 手机版续期受限，不自动续期；desktop = 小E 客户端；web = 云端沙箱）→ ③ 小E 客户端运行标记 XIAOE_DATA_ROOT（或 XIAOE_ROBOT_ROOT 等）→ ④ 云端沙箱凭据 XIAOE_USER_TOKEN → ⑤ 皆无则按 WorkBuddy 桌面端处理（只提示、不续期）。任何环境都不得自动拉起浏览器授权（oidc）。

环境自检

• 环境自检（–doctor）：运行 node scripts/recruit-search.mjs --doctor 输出结构化诊断——e10-login 是否安装、登录态是否有效、招聘服务是否安装、环境参数缓存是否就绪；任一失败给出对应修复指引（安装 weaver-e10-login / e10-login oidc --base-url <域名> / e10-login set）。无 E10 凭据时也能精确定位问题并给出下一步，而非裸报错。

无环境 / 无登录态时的标准响应（强制）

当 weaver-e10-login 未安装、未登录、会话失效，或接口返回 401/403/网络不可达时，禁止直接报错了事或编造数据，按以下结构回复：

优先级声明：其中 401 / token 失效 / 未登录属于「登录问题」，按「执行纪律」第 4 条处理——第一动作就是停止并提示用户重新登录（小E 环境由脚本自动免浏览器续期一次后重试；WorkBuddy 桌面端不续期），不做任何绕过尝试，也不以下方其他步骤拖延。

1. 当前状态：一句话说明卡在哪一步（依赖未安装 / 未登录 / 会话过期 / 应用未部署 / 接口不可达）
2. 已确认的信息：baseUrl、已定位到的模块与目标接口路径（去域名）
3. 下一步（按优先级给可执行操作）：
   • 依赖缺失 → 安装/启用 weaver-e10-login 技能
   • 未登录/过期 → WorkBuddy 桌面端 e10-login oidc --base-url <E10 地址>（或 e10-login set 手动写入会话）；小E 环境会自动免浏览器续期一次，仍失败时请确认对应登录态（客户端已登录 / 平台凭据有效）后重试；手机版续期受限，请在手机端完成登录
   • 应用未部署 → 说明该模块所需 E10 应用未安装，提示管理员部署
   • 接口不可达 → 检查网络/VPN 与 baseUrl
4. 需要用户补充的信息：E10 地址、查询条件（时间范围/姓名/部门等）
5. 边界声明：本技能只在用户授权的 E10 环境内查询；查不到时如实回复"未查到"，不编造任何人事/薪酬/考勤数据

招聘模块优先执行 node scripts/recruit-search.mjs --doctor，直接转述其结构化诊断，不裸抛异常栈。