weaver-work-cli 0.1.2 → 0.1.5

package/skills/weaver-e10-jucailin/references/recruit-write.md

@@ -0,0 +1,70 @@
+# 招聘写操作
+
+## 何时使用
+
+需要变更招聘模块数据时使用：新建人才、安排面试、发送 Offer 邮件、办理入职、提交/修改面试反馈、催促面试评价。全部走 **prepare → 用户确认 → apply** 协议，禁止跳过确认直接执行。
+
+写入边界（与源系统纪律一致）：
+
+- 每个写操作必须先调 `*.prepare`（只读定位/查重/解析 + 确认摘要 + continuation），把摘要给用户确认后才调 `*.apply`（需 `confirm:true` + continuation）。
+- `cancel-change-entry`（取消改期入职）未实现，属禁用边界，见 `safety-boundaries.md`。
+- 面试通知（安排面试的 `notify`）、Offer 邮件、催评通知属 **L3 外部通知**，会打扰真实的人，必须用户明确同意后才传 `notify:true` / 执行 apply。
+
+## 操作一览
+
+| operation（prepare/apply 成对） | 用途 | 关键校验 |
+| --- | --- | --- |
+| `ehr.recruit.candidate.create.*` | 新建人才 | 手机号建前查重（apply 二次查重强制拦截）；渠道须在数据字典中 |
+| `ehr.recruit.candidate.interview.arrange.*` | 安排面试 | 候选人 READ 权限；面试方式/轮次须在枚举内；面试官姓名须解析到 userId |
+| `ehr.recruit.offer.send.*` | 发送 Offer 邮件（L3） | Offer 状态必须「未发送」；邮箱必填；模板须存在于 uf_rcrt_notify_mould |
+| `ehr.recruit.entry.process.*` | 办理入职（落账号不可逆） | estValidateEntry 校验；已办理（status=2）拒绝；department/positionRank 必填 |
+| `ehr.recruit.candidate.interview.feedback.edit.*` | 提交/修改面试反馈 | 已失效(INVALID)面试拒绝；结果须在枚举内；全字段集保存防清空 + 乐观锁 |
+| `ehr.recruit.candidate.interview.feedback.urge.*` | 催促面试评价（L3） | 定位待反馈记录；催评按钮动作流运行时解析，解析不到阻断 |
+
+## 协议细节
+
+1. `prepare` 返回 `status: AWAITING_CONFIRMATION`、`preview`（人类可读摘要）、`continuation`（10 分钟有效）与 `expiresInSeconds`。
+2. `apply` 入参 = prepare 相同业务参数 + `confirm: true` + `continuation`。**apply 会校验指纹**：业务参数与 prepare 快照不一致时报 `target_changed`，须重新 prepare。
+3. continuation 与当前 CLI 登录环境绑定（由 `weaver-work-cli auth` 托管），切换租户或账号后报 `context_mismatch`，此时须重新 prepare。登录与认证细节见共享规则 [`../../weaver-e10-shared/SKILL.md`](../../weaver-e10-shared/SKILL.md)。
+4. 多步写入（saveFormData → initTalentBatch / sendOffer / saveEstPreEntry / runEsb）中途网络中断时报 `partial/write_uncertain` 并给出已落地的记录 id——**禁止自动重试**，先按提示回查（`candidate.search` / `candidate.card`）确认实际状态。
+5. prepare 与 apply 应连续执行。`arrange` 默认时间窗取「当前时刻」，间隔跨分钟后指纹不一致会报 `target_changed`；如需指定时间请显式传 `startTime`/`endTime`（格式 `YYYY-MM-DD HH:mm`）。
+
+## 参数要点
+
+- `create`：`name` + `mobile` 必填，`channel` 传中文名（如「BOSS直聘」），CLI 负责解析为字典 optionId，查不到报 `channel_not_found`。
+- `arrange`：`talentId` + `interviewer`（姓名）必填；`type`（现场/视频/电话/AI面试）、`session`（初试/复试等，须在该环境枚举内）；`positionId` 不填时从人才当前应聘批次继承，继承不到报错要求显式提供。
+- `offer.send`：`talentId` 必填；`email`/`deadline` 缺省时从 Offer 记录继承；`template` 默认「offer通知」。
+- `entry.process`：`departmentId`/`positionRankId` 必填（Offer 记录无此字段）；`subcompanyId`/`positionId`/`entryTime` 缺省时从 Offer 记录继承。
+- `feedback.edit`：`talentId` 必填；`feedbackId` 最稳定位，或 `feedbackIndex`（默认第 0 场含反馈的面试）；`result`/`comment` 至少一项。
+- `feedback.urge`：`talentId` 必填，无需其他参数。
+
+## 命令示例
+
+安排面试（prepare → 确认 → apply）：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ehr run ehr.recruit.candidate.interview.arrange.prepare --input-json '{"talentId":"PLACEHOLDER_TALENT_ID","interviewer":"张三","type":"现场面试","session":"初试"}'
+# 向用户确认 preview 后：
+weaver-work-cli --json ehr run ehr.recruit.candidate.interview.arrange.apply --input-json '{"talentId":"PLACEHOLDER_TALENT_ID","interviewer":"张三","type":"现场面试","session":"初试","confirm":true,"continuation":"PREPARE 返回的 continuation"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json ehr run ehr.recruit.candidate.interview.arrange.prepare --input-json '{"talentId":"PLACEHOLDER_TALENT_ID","interviewer":"张三","type":"现场面试","session":"初试"}'
+# 向用户确认 preview 后：
+weaver-work-cli --json ehr run ehr.recruit.candidate.interview.arrange.apply --input-json '{"talentId":"PLACEHOLDER_TALENT_ID","interviewer":"张三","type":"现场面试","session":"初试","confirm":true,"continuation":"PREPARE 返回的 continuation"}'
+```
+
+## 错误形状（稳定 subtype）
+
+`duplicate_blocked`（查重命中）/ `duplicate_ambiguous`（多条重复）/ `target_changed`（指纹不一致）/ `context_mismatch`（会话变化）/ `channel_not_found` / `interviewer_not_found` / `result_not_in_enum` / `offer_status_invalid` / `entry_already_processed` / `interview_invalid_status` / `esb_action_unresolved`（按钮/动作流解析不到，禁止编造 esbActionIds）/ `partial` + `write_uncertain`（多步写入中断）。
+
+## 注意
+
+- 所有 apply 前必须已获得用户对 preview 的明确确认；用户确认前不得调用 apply。
+- Offer 邮件、面试通知、催评会触达真实候选人/面试官，误发无法撤回；拿不准时再问一次用户。
+- `entry.process` 落人员账号后不可撤销，apply 前务必复述组织架构参数（分部/部门/职位/职级/入职日期）让用户确认。
+- 写入成功后建议回查：`candidate.card` 查面试与反馈，`candidate.list type=offer` 查 Offer 状态，`candidate.list type=entry` 查 transact_status。

package/skills/weaver-e10-jucailin/references/safety-boundaries.md

@@ -0,0 +1,35 @@
+# 能力边界与禁止项
+
+## 招聘：写操作走 prepare→apply，撤销类禁用
+
+招聘**读操作**已可用（人才搜索、业务列表、人才详情卡片），用法见 [`recruit-read.md`](recruit-read.md)。
+
+招聘**写操作**已实现五个（新建人才、安排面试、发送 Offer、办理入职、面试反馈编辑/催评），全部走 prepare → 用户明确确认 → apply 协议，且 offer.send / interview.arrange(notify) / feedback.urge 属 **L3 外部通知**（触达真实候选人/面试官），用法见 [`recruit-write.md`](recruit-write.md)。
+
+**招聘撤销类写操作（取消改期入职）仍在禁用清单**，见 `weaver-work-cli ehr schema` 的 `withheldOperations`。原因：撤销动作破坏性最强且依赖独立入口链路，未迁移实现；不编造、不绕过，也不要引导用户改用源文档里的原始接口路径。
+
+## 移动端考勤打卡：禁用
+
+`attend.card.sign.mobile` 同样在 `withheldOperations` 中。
+
+移动端打卡依赖真实经纬度、WiFi/蓝牙、设备信息与客户端加密凭证，这些 Agent 均无法真实获取，服务端校验必然拒绝。**严禁伪造定位坐标、WiFi 信息或设备凭证重试**。
+
+正确的处理方式是：明确告知用户该环境需要移动端打卡，请改用 IM APP 移动端、移动端企业微信等完成打卡。若租户开启了「允许 PC 电脑端打卡」，则可改用 `ehr.attend.card.check.prepare` / `.apply`。
+
+## 通用禁止项
+
+- 禁止读取、复制或解析认证目录、Cookie、ETEAMSID、业务 Token。认证诊断只能通过 `weaver-work-cli auth` 系列命令与 `weaver-work-cli doctor --e10` 完成。
+- 禁止把源文档里的原始接口路径当成可直接调用的地址。所有调用必须走 `weaver-work-cli ehr run <operation> --input -`。
+- 禁止把未出现在 `weaver-work-cli ehr schema` 中的能力写成可用 operation。
+- 禁止在写操作中跳过确认链：不得在 `prepare` 之后未经用户明确确认就调用 `apply`，不得自动重试 `apply`。
+- 遇到 `partial`、`write_uncertain`、登录失效或网络中断时，立即停止当前写流程，先做只读回查。
+- 涉及附件、图片、本地文件、远程 URL 或文件内容解析时，必须先向用户说明：文件内容可能会被上传到业务系统或解析服务，并可能进入当前大模型上下文。必须等待用户**明确确认**后才继续。
+
+## 未实测声明
+
+本技能的接口契约全部来自源文档，未在真实 E10 环境实测。以下差异点需要在你的环境中复核（详见交付说明中的待验证项清单）：
+
+- 三个子系统的响应成功判定与分页结构差异。
+- 各报表 `pageSize` 是否被页面配置固定为 100。
+- PC 端打卡凭证算法与目标租户的打卡方式开关是否匹配。
+- 各数据源的必填过滤字段是否严格为文档中标注的字段。

package/skills/weaver-e10-jucailin/references/salary.md

@@ -0,0 +1,110 @@
+# 薪酬查询
+
+## 何时使用
+
+需要查询工资单、社保公积金福利、调薪记录、社保台账或员工薪资明细时使用。全部为只读操作。
+
+## 输入要点
+
+| operation | 必填 | 说明 |
+| --- | --- | --- |
+| `ehr.salary.bill.list` | 无 | 分页查询**当前登录人**的工资单；也用于取得详情接口的 `salaryInfoId` |
+| `ehr.salary.bill.get` | `salaryInfoId` | 查看某一张**已发放**工资单的完整展示数据 |
+| `ehr.salary.welfare.list` | 无 | 社保、公积金及其他福利缴费汇总与动态明细 |
+| `ehr.salary.adjustment.list` | 无 | 薪资项目调整记录；`startYear` 与 `endYear` 必须成对提供 |
+| `ehr.salary.siaccount.query` | 至少一个范围条件 | 社保台账详情，需薪酬社保台账权限 |
+| `ehr.salary.employee.list` | 无 | 员工薪资明细，需薪酬统计权限 |
+
+`ehr.salary.bill.list` 与 `ehr.salary.employee.list` 的月份参数只接受 1 或 2 项（`[开始月, 结束月]`）。超过 2 项时服务端仅保留第 1 项，CLI 会直接拒绝，避免静默返回错误范围。
+
+`ehr.salary.siaccount.query` 不分页且返回高度敏感数据，CLI 强制要求至少提供月份范围或人员/组织 ID 之一，否则拒绝执行。
+
+`billStatus` 取值 `0`（未归档）/`1`（已归档）；`paymentStatusList` 取值 `0` 正常缴纳、`1` 补缴、`2` 代缴、`3` 退差、`4` 补差。**这两个枚举在运行时校验**：传非法值会直接报 `enum_invalid` 而不发请求。这一点很重要——早期版本未校验时，非法值会被服务端静默忽略并返回空数组，调用方会误判为"没有数据"。
+
+`startBillMonth` 与 `endBillMonth` 是**月份**（`YYYY-MM`），必须成对提供，否则报 `month_range_incomplete`；倒序报 `month_range_invalid`。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ehr run ehr.salary.bill.list --input-json '{"current":1,"pageSize":20}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+printf '%s\n' '{"current":1,"pageSize":20}' | weaver-work-cli --json ehr run ehr.salary.bill.list --input -
+```
+
+按薪资月份查询工资单：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json ehr run ehr.salary.bill.list --input-json '{"salaryYearMonth":["2026-01","2026-03"]}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+printf '%s\n' '{"salaryYearMonth":["2026-01","2026-03"]}' | weaver-work-cli --json ehr run ehr.salary.bill.list --input -
+```
+
+## 输出处理
+
+- 成功 JSON 顶层是 `ok=true` 与 `data`；分页信息在 `meta.page`。
+- `bill.list` 返回的记录中 `status=0` 表示未发放。查看未发放的工资单会失败，只有已发放的才能取详情。
+- 工资单含高度敏感的个人薪酬数据。回复用户时给摘要和关键字段，不要原样粘贴完整 JSON。
+- `welfare.list` 与 `adjustment.list` 在无数据时返回 `data: null`（**不是**空数组，也不是缺省 `data` 键）。判断是否"无记录"要看 `data` 是否为 `null` 或空数组，不要只看键是否存在。
+- `bill.get` 返回的 `employeeInformation`、`salaryGroups`、`salaryTemplate`、`formData` 都是**模板驱动的动态结构**，字段随企业配置变化，消费时按实际返回处理，不要写死字段名。稳定字段有 `tenantName`、`sendTime`、`ackStatus`、`ackAutoStatus`、`feedbackStatus`、`senderId`、`sendMsgId`、`countdown`。
+- `bill.get` 是读取操作，但**会记录首次查看时间及查看环境信息，不是完全无痕查询**；只有用户明确要查看详情时才调用。
+- 该接口只查"我的"工资单：`salaryInfoId` 必须来自 `bill.list` 返回的当前用户记录，**不要尝试查询他人记录**。
+- 涉及附件、图片或文件内容解析时，必须先说明文件内容可能进入大模型上下文，获得用户**明确确认**后才继续。
+
+## 注意
+
+- `ehr.salary.bill.get` 会记录首次查看时间，**不是完全无痕查询**。执行前先向用户说明这一点。
+- `ehr.salary.employee.list` 的 `idNo` 是身份证号，属于敏感字段，非必要不要传入，也不要把返回值中的身份证号回显给用户。
+- `ehr.salary.siaccount.query` 与 `ehr.salary.employee.list` 需要管理权限，当前登录人没有权限时会返回业务失败，不要反复重试。
+- 涉及附件、图片或文件内容解析时，必须先说明文件内容可能进入大模型上下文，获得用户**明确确认**后才继续。
+
+## 二次身份验证 token（重要，2026-09-04 补齐）
+
+工资单相关的 **4 个接口**都要求携带 `token`，它用于二次身份验证，**与登录凭证无关**，也不由认证链路提供：
+
+| operation | token 位置 |
+|---|---|
+| `ehr.salary.bill.list` | body |
+| `ehr.salary.bill.get` | query |
+| `ehr.salary.welfare.list` | query |
+| `ehr.salary.adjustment.list` | query |
+
+规则：
+
+- 用户**主动提供**了二次验证 token 时使用原值；
+- 用户**未提供时** CLI 自动补固定协议值 **`DONT_NEED`**；
+- **不得传空值，也不得自行构造其他值**；
+- 不要尝试从登录态或认证链路获取该值。
+
+`ehr.salary.siaccount.query` 与 `ehr.salary.employee.list` **不需要** token。
+
+相关错误码：
+
+| 错误码 | 含义 | 处理 |
+|---|---|---|
+| `checkSecondFailNoToken` | `token` 缺失或为空 | CLI 已自动补 `DONT_NEED`，出现此错误说明该环境不接受缺省值 |
+| `checkSecondFail` | 二次验证失败，或传入值不被当前环境接受 | 用户已提供 token 时请其确认有效性；用 `DONT_NEED` 仍失败则如实返回，**没有 Skill 能自动获取真实 token** |
+| `checkSecondError` | 二次验证服务异常 | 停止并说明异常，**不得绕过验证读取数据** |
+
+> 关键陷阱（2026-09-04 修复）：这些失败码到达时 HTTP 仍是 **200 且 `status` 仍为 `true`**，仅 `msg` 变为失败码、`data` 缺失。CLI 已在业务成功判定**之前**按 `msg` 精确识别并抛出明确 API 错误（`second_auth_token_missing` / `second_auth_failed` / `second_auth_error`），**不再**把这些失败静默吞成 `data: null`。代理看到上述子类型错误即代表二次验证失败，应如实反馈给用户，不要误读为"查询成功但没有数据"。
+
+安全要求：用户提供的真实 token 属敏感信息，**不得记录、回显或长期缓存**。
+
+## 失败处理
+
+- `month_range_invalid`：月份格式不是 `YYYY-MM`，或数量超过 2 项，或开始月晚于结束月。
+- `year_range_incomplete`：`startYear` 与 `endYear` 只提供了一个。
+- `siaccount_scope_required`：社保台账查询未提供任何范围条件，必须补月份范围或人员/组织 ID。
+- `salary_info_id_required` / `salary_info_id_invalid`：`salaryInfoId` 缺失或不是数字 ID。
+- 认证类错误：引导用户执行 `weaver-work-cli auth login`，不要读取或解析认证目录。

package/skills/weaver-e10-jucailin/references/source-manifest.json

@@ -0,0 +1,152 @@
+{
+  "schemaVersion": 1,
+  "skill": "weaver-e10-jucailin",
+  "generatedFrom": {
+    "sourceSkill": "weaver-e10-jucailin",
+    "version": "1.0.19",
+    "path": "business-apis/ehr",
+    "kind": "workbuddy-document-skill"
+  },
+  "generatedAt": "2026-09-11",
+  "scope": {
+    "included": [
+      "hr",
+      "salary",
+      "attend",
+      "recruit"
+    ]
+  },
+  "sourceFiles": [
+    "references/attend-abnormal-get-list.md",
+    "references/attend-appeal-get-calendar-detail.md",
+    "references/attend-appeal-get-formid.md",
+    "references/attend-appeal-get-list.md",
+    "references/attend-appeal-save.md",
+    "references/attend-appeal-update-result.md",
+    "references/attend-card-check-pc.md",
+    "references/attend-card-sign-mobile.md",
+    "references/attend-catalog.md",
+    "references/attend-leavestatis-get-report.md",
+    "references/attend-module.md",
+    "references/attend-orbit-query-list.md",
+    "references/attend-report-get-summary.md",
+    "references/attend-report-recalc-status.md",
+    "references/attend-signrecord-get-list.md",
+    "references/attend-summary-get-statistics.md",
+    "references/attend-worktime-get-list.md",
+    "references/hr-all-catalog.md",
+    "references/hr-all-module.md",
+    "references/hr-birthday-search-conditions.md",
+    "references/hr-birthday-search-table.md",
+    "references/hr-browser-complete.md",
+    "references/hr-contact-col-list.md",
+    "references/hr-contact-search-conditions.md",
+    "references/hr-contact-search-count.md",
+    "references/hr-contact-search-table.md",
+    "references/hr-empchange-browser-complete.md",
+    "references/hr-empchange-search-conditions.md",
+    "references/hr-empchange-search-table.md",
+    "references/hr-employee-timepoint-ds-fields.md",
+    "references/hr-employee-timepoint-tp-getcountdata.md",
+    "references/hr-employee-timepoint-tp-getlistdata.md",
+    "references/hr-est-queries-ds-fields.md",
+    "references/hr-est-queries-ds-getcountdata.md",
+    "references/hr-est-queries-ds-getlistdata.md",
+    "references/hr-est-queries-est-dc-emp-table.md",
+    "references/hr-est-queries-est-emp-table.md",
+    "references/hr-report-basic-ds-fields.md",
+    "references/hr-report-basic-ds-getchartdata.md",
+    "references/hr-report-basic-permissiontype.md",
+    "references/hr-report-change-depttable.md",
+    "references/hr-report-change-ds-fields.md",
+    "references/hr-report-change-ds-getlistdata.md",
+    "references/hr-report-change-permissiontype.md",
+    "references/hr-report-dept-panel-depttable.md",
+    "references/hr-report-dept-panel-ds-fields.md",
+    "references/hr-report-dept-panel-ds-getlistdata.md",
+    "references/hr-report-dept-panel-permissiontype.md",
+    "references/hr-report-dismiss-ds-fields.md",
+    "references/hr-report-dismiss-ds-getcountdata.md",
+    "references/hr-report-dismiss-ds-getlistdata.md",
+    "references/hr-report-hw-ds-fields.md",
+    "references/hr-report-hw-hw-getcountdata.md",
+    "references/hr-report-hw-hw-getlistdata.md",
+    "references/hr-report-job-panel-ds-fields.md",
+    "references/hr-report-job-panel-ds-getlistdata.md",
+    "references/hr-report-job-panel-jobtable.md",
+    "references/hr-report-job-panel-jobtypetable.md",
+    "references/hr-report-job-panel-permissiontype.md",
+    "references/hr-report-posi-panel-ds-fields.md",
+    "references/hr-report-posi-panel-ds-getlistdata.md",
+    "references/hr-report-posi-panel-permissiontype.md",
+    "references/hr-report-posi-panel-positable.md",
+    "references/hr-report-turn-ds-fields.md",
+    "references/hr-report-turn-ds-getcountdata.md",
+    "references/hr-report-turn-ds-getlistdata.md",
+    "references/hr-report-turn-tp-emptable.md",
+    "references/hr-report-v2-dept-emp-move-ds-fields.md",
+    "references/hr-report-v2-dept-emp-move-ds-getcountdata.md",
+    "references/hr-report-v2-dept-emp-move-ds-getlistdata.md",
+    "references/hr-report-v2-dept-emp-move-tp-emptable.md",
+    "references/hr-report-v2-dept-emp-props-sa.md",
+    "references/hr-report-v2-dept-emp-props-table.md",
+    "references/hrmsalary-catalog.md",
+    "references/hrmsalary-module.md",
+    "references/recruit-arrange-interview.md",
+    "references/recruit-capability-check.md",
+    "references/recruit-catalog.md",
+    "references/recruit-check-install.md",
+    "references/recruit-data-dictionary.md",
+    "references/recruit-detail-action-buttons.md",
+    "references/recruit-detail-base-info.md",
+    "references/recruit-detail-batch-prepare.md",
+    "references/recruit-detail-history-batch.md",
+    "references/recruit-detail-interview.md",
+    "references/recruit-detail-other-info.md",
+    "references/recruit-detail-permission-check.md",
+    "references/recruit-detail-process.md",
+    "references/recruit-detail-remark.md",
+    "references/recruit-edit-interview-feedback.md",
+    "references/recruit-entry-cancel.md",
+    "references/recruit-entry-list.md",
+    "references/recruit-entry-onboard.md",
+    "references/recruit-form-tag-map.md",
+    "references/recruit-list-demand.md",
+    "references/recruit-list-offer.md",
+    "references/recruit-list-position.md",
+    "references/recruit-module.md",
+    "references/recruit-new-candidate.md",
+    "references/recruit-resolve-creator.md",
+    "references/recruit-resolve-employee.md",
+    "references/recruit-resolve-metadata.md",
+    "references/recruit-resume-parse.md",
+    "references/recruit-search-candidate.md",
+    "references/recruit-send-offer.md",
+    "references/recruit-stats.md",
+    "references/recruit-urge-feedback.md",
+    "references/salary-bill-detail-my-salary-bill.md",
+    "references/salary-bill-list-my-salary-bills.md",
+    "references/salary-report-adjustment-record-list.md",
+    "references/salary-report-employee-salary-list.md",
+    "references/salary-report-welfare-list.md",
+    "references/salary-siaccount-detail-query.md",
+    "scripts/_init_env_cache.mjs",
+    "scripts/e10-request.mjs",
+    "scripts/recruit-arrange-interview.mjs",
+    "scripts/recruit-cancel-change-entry.mjs",
+    "scripts/recruit-detail.mjs",
+    "scripts/recruit-edit-interview-feedback.mjs",
+    "scripts/recruit-list.mjs",
+    "scripts/recruit-new-candidate.mjs",
+    "scripts/recruit-process-entry.mjs",
+    "scripts/recruit-search.mjs",
+    "scripts/recruit-send-offer.mjs",
+    "scripts/recruit-stats.mjs",
+    "scripts/recruit-urge-feedback.mjs",
+    "scripts/write-op.mjs",
+    "SKILL.md"
+  ],
+  "fingerprintAlgorithm": "sha256",
+  "fingerprints": {},
+  "note": "fingerprints 在首次生成时留空；源资料更新检测会按文件路径计算 sha256 并与此处比对。源资料更新后，同步更新 CLI 与 Skill，且在用户确认前不要覆盖已有产物。sourceFiles 仅登记随技能交付的源资料（SKILL.md + references/*.md + scripts/*.mjs）；源码根下的治理与构建文件（GOVERNANCE.md、build_release.*、audit_spec_compliance.py 等）不参与交付，故不纳入基线。四个业务模块（hr/salary/attend/recruit）均已在 CLI 侧实现。"
+}

package/skills/weaver-e10-mail/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: weaver-e10-mail
+display_name: 泛微E10邮件
+display_name_en: Weaver E10 Mail
+description: "泛微 E10 邮件管理：查询邮件、往来邮件、收件人解析、发送/回复/转发/存草稿、标星/已读/待办/移动/逻辑删除、文件夹、联系人/分组、模板、签名、黑名单与附件上传下载。"
+description_zh: "泛微 E10 邮件管理。支持邮件列表/详情/正文/未读统计/配置查询，内部人员/部门/外部邮箱收件人解析，发送/回复/转发/存草稿（prepare→apply 确认链），标星、已读、全部已读、待办、移动、逻辑删除、文件夹管理、撤回，联系人及分组、模板、签名（含二维码名片）、黑名单的增删改，以及附件上传（预检→上传→绑定）与批量下载。"
+description_en: "Weaver E10 Mail management: list/detail/content/unread-count/config queries, recipient resolution (internal/department/external), send/reply/forward/draft via prepare→apply confirmation chain, star/read-status/read-all/wait/move/logical-delete/folder/recall, contacts and groups, templates, signatures (with QR card), blacklist, and attachment upload/download."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+cliHelp: "weaver-work-cli mail --help"
+---
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
+认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+所有命令通过 `weaver-work-cli --json mail run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli mail schema` 是 operation、字段和风险等级的合约来源。
+命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
+涉及邮件附件、图片、本地文件、远程 URL 文件或邮件正文解析的操作，执行前必须提醒用户：文件内容可能被上传到 E10 邮件系统，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
+
+## 路由优先级（先判断是不是 E10 邮件，再选 operation）
+
+只要用户的核心对象是泛微 E10 邮件（收件箱/发件箱/草稿/已删除/垃圾箱/待办邮件、邮件正文、附件、签名、模板、联系人、黑名单、往来邮件），就优先使用 `weaver-e10-mail`。
+
+### 明确归 `weaver-e10-mail` 的高优先级语义
+
+出现以下任一语义时，优先走本 Skill：
+
+- 邮件 / 收件箱 / 发件箱 / 草稿箱 / 已删除 / 垃圾箱 / 待办邮件
+- 查看邮件、看正文、看附件、未读统计、邮件配置
+- 发邮件 / 回复 / 转发 / 存草稿 / 定时发送
+- 标星、标记已读/未读、全部已读、待办提醒、移动邮件、删除邮件、撤回邮件
+- 文件夹新建/删除
+- 联系人、联系人分组、邮件模板、签名、二维码名片、黑名单
+- 附件上传、附件下载、附件中心
+
+**判定规则：** 只要最终动作是对 E10 邮件做查询、查看、发送、解析收件人、标记、移动、删除、文件夹、联系人、模板、签名、黑名单或附件处理，就归 `weaver-e10-mail`。只有当用户处理的是非邮件类 E10 业务（如招聘、薪酬、业票通）或尚未封装的邮件能力时，才不使用本 Skill。
+
+## 选哪个命令
+| 想做什么 | 命令 | 按需读取 reference |
+|---|---|---|
+| 查看可用 operation、字段和风险等级 | `mail schema` | [`mail-agent-entry.md`](references/mail-agent-entry.md) |
+| 查询邮件列表 | `mail run mail.list` | [`mail-read.md`](references/mail-read.md) |
+| 往来邮件 | `mail run mail.contact.list` | [`mail-read.md`](references/mail-read.md) |
+| 查看邮件详情/正文 | `mail run mail.view.info` / `mail.run mail.view.content` | [`mail-read.md`](references/mail-read.md) |
+| 未读统计 / 邮件配置 | `mail run mail.unread.count` / `mail.run mail.config.get` | [`mail-read.md`](references/mail-read.md) |
+| 收件人解析（内部/部门/外部） | `mail run mail.person.search` / `mail.run mail.dep.search` / `mail.run mail.address.search` | [`mail-read.md`](references/mail-read.md) |
+| 发送/回复/转发/存草稿 | `mail run mail.send.prepare/apply` | [`mail-send.md`](references/mail-send.md) |
+| 标星 / 已读 / 全部已读 / 待办 / 移动 / 逻辑删除 / 文件夹 / 撤回 | `mail run mail.star` / `mail.run mail.read.status` / `mail.run mail.read.all` / `mail.run mail.wait.add` / `mail.run mail.move.folder` / `mail.run mail.delete.move` / `mail.run mail.folder.create` / `mail.run mail.folder.delete` / `mail.run mail.recall` | [`mail-manage.md`](references/mail-manage.md) |
+| 联系人 / 分组 | `mail run mail.contacts.*` | [`mail-contacts.md`](references/mail-contacts.md) |
+| 模板 | `mail run mail.template.*` | [`mail-template.md`](references/mail-template.md) |
+| 签名 / 二维码名片 | `mail run mail.sign.*` | [`mail-sign.md`](references/mail-sign.md) |
+| 黑名单 | `mail run mail.blacklist.*` | [`mail-blacklist.md`](references/mail-blacklist.md) |
+| 附件上传 / 下载 / 附件中心 | `mail run mail.attachment.upload` / `mail.run mail.attachment.download` / `mail.run mail.attachment.center` | [`mail-attachment.md`](references/mail-attachment.md) |
+| 破坏性/缺口操作（已暂缓） | 无可用命令 | [`safety-boundaries.md`](references/safety-boundaries.md) |
+
+处理链：
+
+- 查邮件：`mail.list`（folder/keyword/unread/star/todo/hasFile/date 过滤）-> 必要时 `mail.view.info`（含附件列表）或 `mail.view.content`（正文）
+- 收件人解析：先用 `mail.person.search` / `mail.dep.search` / `mail.address.search` 拿到 id/邮箱；发送时可直接在 `mail.send.prepare` 传 `--to`/`--to-dep`/`--to-id`/`--external` 让 CLI 解析，重复姓名会要求确认
+- 发送：`mail.send.prepare`（flag: -1 新建 / 1 回复 / 3 转发 / 4 编辑草稿）-> 展示摘要 -> 用户确认 -> `mail.send.apply`（传 continuation + confirm）-> 按返回回执报告
+- 标记/移动/删除：`mail.star` / `mail.read.status` / `mail.read.all` / `mail.move.folder` / `mail.delete.move` / `mail.wait.add` / `mail.recall` / `mail.folder.create` / `mail.folder.delete`
+- 联系人：先 `mail.contacts.list`/`mail.contacts.group.list` 定位 -> `mail.contacts.save.prepare`（查全量表单 + 输出摘要）-> 用户确认 -> `mail.contacts.save.apply`；删除用 `mail.contacts.delete`
+- 模板：`mail.template.list` -> 新增 `mail.template.save.prepare/apply`；编辑 `mail.template.update`（GET 全量 + 保存）；删除 `mail.template.delete`；默认 `mail.template.default`
+- 签名：`mail.sign.list` -> 新增 `mail.sign.save.prepare/apply`；编辑 `mail.sign.update`；删除 `mail.sign.delete`；默认 `mail.sign.default`；二维码名片 `mail.sign.qrcode`
+- 黑名单：`mail.blacklist.operate.prepare`（operateType: add/delete）-> 用户确认 -> `mail.blacklist.operate.apply`
+- 附件：上传 `mail.attachment.upload`（预检→上传→绑定，返回 fileid）；下载 `mail.attachment.download`（ids + output 目录）；附件中心 `mail.attachment.center`
+
+## 执行原则（减少误路由、误重试和无效消耗）
+
+### 1) 先拿最小必要信息，再执行
+
+- 只是查邮件列表时，优先直接用 `mail.list`
+- 列表默认先取小页，优先 `page=1`、`size=10`；用户没有要求全量时不要自动翻完整文件夹
+- 用户已经给出邮件 id 时，不要先查列表再过滤，直接用 `mail.view.info` / `mail.view.content` / 对应写操作
+- 只有需要正文、附件列表或完整字段时，才补 `mail.view.info` / `mail.view.content`
+
+### 1.5) 大结果只摘要给用户
+
+- 当前 CLI 会把完整 JSON envelope 写 stdout；Agent 回复时不要原样贴完整 JSON
+- 列表最多先展示最相关的前 10 条，包含 id、主题、收发件人、日期、已读/星标/附件状态
+- 需要全量统计时，按 `page`/`size` 分页读取并累计必要字段；说明已读取页数、命中数和是否还有更多
+- 详情、附件或调试用完整响应过长时，优先落本地文件并向用户提供摘要和文件路径
+
+### 2) 已知对象时直达动作
+
+- 已拿到邮件 id、联系人 id、模板 id、签名 id、附件 id 或本地文件路径时，优先调用对应 operation
+- 同一轮里如果已有足够的新鲜查询结果，不要重复查询同一列表或同一详情
+- 不要默认走 `list -> filter -> view -> prepare -> apply` 全链路；对象已明确时应压缩步骤
+
+### 3) 错误语义驱动，而不是盲目重试
+
+- 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
+- **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
+- 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作
+- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`，按其中流程用宿主提问/弹框让用户输入 E10 登录域名或选择已有 profile，完成登录后再继续原操作。
+
+### 4) 附件、图片和文件解析确认
+
+- 执行 `mail.attachment.upload`、`mail.attachment.download`，或任何会读取本地文件、上传远程 URL 文件、解析图片/PDF 的步骤前，必须先提醒用户文件内容可能进入大模型上下文，也可能发送到 E10 邮件系统。
+- 用户未明确确认前，不要运行上传、解析或下载命令。
+- 下载附件会落本地 `output` 目录，执行前确认目录与文件名，避免覆盖。
+
+## 写操作失败处理：`partial/write_uncertain` 决策树
+
+当发送、联系人/分组/模板/签名保存、黑名单操作等写操作返回 `partial/write_uncertain`，或提示网络中断、部分成功、回查失败、回查字段不一致时，按下面规则处理：
+
+1. **先停止盲目重试**，不要连续重复提交相同 `.apply`
+2. 优先从以下角度解释：
+   - 写请求可能已经到达服务端，但连接在结果确认前中断
+   - 服务端可能只处理了部分数据
+   - 写接口已返回成功，但详情回查失败或与预期不一致
+   - continuation、目标对象或登录上下文可能已经变化
+3. 如需确认，只补 **一次** 只读查询（例如 `mail.view.info`、列表查询或 `mail.list`），不要陷入 query/write 循环
+4. 最终给用户明确结论、已知状态和下一步人工确认建议，而不是继续无意义重试
+
+**特别注意：** 对发送（尤其是回复/转发带原文的）、联系人删除、模板/签名覆盖和黑名单删除场景更要严格执行上述规则；这些场景最容易因重复提交造成重复发送、误删或覆盖用户刚修改的数据。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli mail schema
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
+weaver-work-cli --json mail run mail.view.info --input-json '{"id":"12345"}'
+weaver-work-cli --json mail run mail.send.prepare --input-json '{"flag":"-1","to":"张三","subject":"季度汇报","content":"您好，附件为季度汇报。"}'
+weaver-work-cli --json mail run mail.send.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json mail run mail.star --input-json '{"id":"12345","star":"1"}'
+weaver-work-cli --json mail run mail.attachment.upload --input-json '{"file":"./quarterly.pdf","name":"quarterly.pdf"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli mail schema
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
+weaver-work-cli --json mail run mail.view.info --input-json '{"id":"12345"}'
+weaver-work-cli --json mail run mail.send.prepare --input-json '{"flag":"-1","to":"张三","subject":"季度汇报","content":"您好，附件为季度汇报。"}'
+weaver-work-cli --json mail run mail.send.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+weaver-work-cli --json mail run mail.star --input-json '{"id":"12345","star":"1"}'
+weaver-work-cli --json mail run mail.attachment.upload --input-json '{"file":"./quarterly.pdf","name":"quarterly.pdf"}'
+```
+
+## 不在本 skill 范围
+
+- 禁止加载原始 `weaver-e10-mail` Skill 代替 CLI。
+- 禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/inc/*` 或邮件接口。
+- 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
+- 禁止读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+- 永久删除（`mail.delete.batch`）与重发（`mail.resend`）当前未纳入 CLI manifest，已暂缓实现；如确需执行，请在确认风险后以单独授权方式处理，详见 [`safety-boundaries.md`](references/safety-boundaries.md)。
+- 非邮件类 E10 能力（招聘、薪酬、业票通、通用流程编排）不由本 Skill 承载。

package/skills/weaver-e10-mail/product.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": 1,
+  "product": "weaver-work-cli",
+  "productVersion": "0.1.4",
+  "packageName": "weaver-work-cli",
+  "command": "weaver-work-cli",
+  "nodeEngine": ">=18"
+}

package/skills/weaver-e10-mail/references/mail-agent-entry.md

@@ -0,0 +1,47 @@
+# Agent 入口与 Schema
+
+## 什么时候读取
+
+使用 `weaver-work-cli mail` 前、编写自动化调用、选择 operation 或确认字段结构时读取本文件。
+
+## 准备命令
+
+```text
+weaver-work-cli --version
+weaver-work-cli doctor --e10
+weaver-work-cli mail schema
+```
+
+如未登录，按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md` 后处理。
+
+## 固定入口
+
+Agent 优先调用统一 operation 入口：
+
+```text
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
+```
+
+简单 JSON 通过 `--input-json` 传入，复杂或多行 JSON 使用 UTF-8 文件和 `--input <path>`；只有确认当前 shell 能稳定传管道时才使用 `--input -`。按环境选择示例：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","page":1,"size":10}'
+```
+
+`weaver-work-cli mail schema` 是可用 operation、输入字段、固定参数和风险等级的第一信息源（共 49 个 operation，另含 2 个已暂缓的 `withheldOperations`）。不要用未出现在 schema 中的 operation，也不要把原始 `weaver-e10-mail` reference 当作可直接调用的 CLI 合约。
+
+## 输出处理
+
+成功结果在 stdout，失败结果在 stderr。判断规则读取共享 reference：`../../weaver-e10-shared/references/json-output-contract.md`。
+
+列表、详情、附件或回查结果可能很长时，不要把 stdout 的完整 envelope 直接展示给用户。默认 `size=10` 小页读取；只渲染邮件识别和决策所需字段，例如 id、主题、收发件人、日期、已读/星标/附件状态。需要更多结果时按 `page` 分页继续；需要保留完整原始 JSON 时落本地文件并返回路径。
+
+高风险写入读取共享 reference：`../../weaver-e10-shared/references/high-risk-write.md`。

package/skills/weaver-e10-mail/references/mail-attachment.md

@@ -0,0 +1,30 @@
+# 附件上传 / 下载
+
+## mail.attachment.upload — 上传附件（三步）
+
+风险等级：`write`（含文件上传，敏感数据处理，执行前须取得用户对“文件内容可能进入大模型/外部服务”的明确确认）。
+
+字段：`file`（本地文件路径）、`name`（附件名）。
+
+流程：预检（`preUploadCheck`）→ 上传（`module/upload`，multipart 上传文件 Blob）→ 绑定权限（`addPermissionFile`），返回 `fileid`。后续发送时在 `mail.send.prepare/apply` 的 `files` 传入该 fileid。
+
+```text
+weaver-work-cli --json mail run mail.attachment.upload --input-json '{"file":"./quarterly.pdf","name":"quarterly.pdf"}'
+```
+
+## mail.attachment.download — 批量下载附件
+
+风险等级：`write`（落本地文件，确认输出目录避免覆盖）。
+
+字段：`ids`（附件 id，逗号分隔）、`output`（输出目录）。
+
+## mail.attachment.center — 附件中心
+
+风险等级：`read`。字段：`keyword`、`page`、`size`。
+
+## 要点
+
+- 上传/下载前必须向用户说明：文件内容可能被上传到 E10 邮件系统，并可能进入当前大模型上下文。
+- 下载会落本地 `output` 目录，执行前确认目录与文件名，避免覆盖。
+- 用户未明确确认前，不执行上传、解析或下载命令。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。