weaver-work-cli 0.1.1 → 0.1.4

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

@@ -0,0 +1,27 @@
+# 黑名单（prepare → apply 确认链）
+
+风险等级：`write`。新增/删除均走 prepare→apply 确认链。
+
+## 操作字段
+
+| operation | 字段 |
+|---|---|
+| `mail.blacklist.operate.prepare` | `operateType`（`add` / `delete`）、`mailAddress`（add 时必填）、`id`（delete 时按 id）、`confirm`、`continuation` |
+| `mail.blacklist.operate.apply` | 同上（apply 必带 `continuation` + `confirm:true`） |
+
+## 流程
+
+```text
+weaver-work-cli --json mail run mail.blacklist.operate.prepare --input-json '{"operateType":"add","mailAddress":"spam@example.com"}'
+# 返回 continuation（含操作类型与目标）
+weaver-work-cli --json mail run mail.blacklist.operate.apply --input-json '{"continuation":"<PREPARE_CONTINUATION>","confirm":true}'
+```
+
+- `add`：需 `mailAddress`（邮箱地址）。
+- `delete`：需 `id`（黑名单记录 id）或对应 `mailAddress`；CLI 按源接口约定解析。
+
+## 要点
+
+- prepare 输出摘要（操作类型 + 目标），apply 前 CLI 重新校验 continuation 与上下文。
+- 删除为即时写，确认目标。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,33 @@
+# 联系人 / 分组（prepare → apply 确认链，删除单步）
+
+风险等级：`write`。保存类走 prepare→apply 确认链；删除单步执行。
+
+## 联系人保存（prepare → apply）
+
+| operation | 字段 |
+|---|---|
+| `mail.contacts.save.prepare` | `id`（编辑时填）、`mailUserName`、`mailAddress`、`mailUserTel`、`mailUserCompany`、`mailUserDesc`、`groupId`、`confirm`、`continuation` |
+| `mail.contacts.save.apply` | 同上（apply 必带 `continuation` + `confirm:true`） |
+
+prepare 调用 `getMailContactsForm` 取全量表单并输出摘要（不保存）；apply 执行保存。新增不传 `id`，编辑传 `id`。
+
+## 联系人删除
+
+`mail.contacts.delete` 字段：`id`。单步执行，删除前确认。
+
+## 分组保存（prepare → apply）
+
+| operation | 字段 |
+|---|---|
+| `mail.contacts.group.save.prepare` | `id`（编辑时填）、`groupName`、`confirm`、`continuation` |
+| `mail.contacts.group.save.apply` | 同上（apply 必带 `continuation` + `confirm:true`） |
+
+## 分组删除
+
+`mail.contacts.group.delete` 字段：`id`。单步执行，删除前确认。
+
+## 要点
+
+- 保存类必须 prepare 先取全量表单，避免覆盖用户已有字段；apply 前 CLI 重新校验 continuation 与上下文。
+- 删除为单步即时写，执行前确认 id 与目标。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,44 @@
+# 邮件管理类写操作（标记 / 待办 / 移动 / 删除 / 文件夹 / 撤回）
+
+风险等级均为 `write`（单步执行，无 prepare/apply 链，但部分会直接改数据）。
+
+## mail.star — 标星/取消标星
+
+字段：`id`、`star`（"1" 标星 / "0" 取消）。
+
+## mail.read.status — 标记单封已读/未读
+
+字段：`id`、`read`（"1" 已读 / "0" 未读）。
+
+## mail.read.all — 标记全部已读
+
+字段：`folder`（文件夹 id，默认全部）。
+
+## mail.wait.add — 创建待办/提醒
+
+字段：`id`（邮件 id）、`title`（待办标题，缺省从邮件主题取）、`endDate`（截止日期）、`reminderWay`、`reminderTime`、`remark`。CLI 在标题缺失时自动取邮件主题。
+
+## mail.move.folder — 移动邮件至文件夹
+
+字段：`id`、`folder`（目标文件夹 id）。
+
+## mail.delete.move — 逻辑删除（移至已删除，可恢复）
+
+字段：`id`（邮件 id 或逗号分隔多个）。**这是逻辑删除，不是物理永久删除**；物理永久删除 `mail.delete.batch` 已暂缓，见 `safety-boundaries.md`。
+
+## mail.folder.create / folder.delete — 文件夹管理
+
+| operation | 字段 |
+|---|---|
+| `mail.folder.create` | `name`（文件夹名）、`id`（编辑时填） |
+| `mail.folder.delete` | `id`（文件夹 id） |
+
+## mail.recall — 撤回已发送的内部邮件
+
+字段：`id`。仅对内部邮件有效；撤回失败按错误语义处理，不盲目重试。
+
+## 要点
+
+- 以上操作均为即时写，执行前在回复中向用户确认目标 id 与动作。
+- 删除走逻辑删除，可恢复；如用户要求物理永久删除，说明 `mail.delete.batch` 已暂缓，不在常规 CLI 提供。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,76 @@
+# 邮件查询类 operation
+
+全部风险等级：`read`。只读，不修改数据。
+
+## mail.list — 邮件列表
+
+```text
+weaver-work-cli --json mail run mail.list --input-json '{"folder":"0","keyword":"","unread":true,"star":false,"todo":false,"hasFile":false,"startDate":"","endDate":"","page":1,"size":10}'
+```
+
+字段（均为可选）：
+
+| 字段 | 说明 |
+|---|---|
+| `folder` | 文件夹：0 收件箱 / -1 已发送 / -2 草稿箱 / -3 垃圾箱 / -4 已删除 / -10 全部。默认按命令约定 |
+| `keyword` | 主题关键字 |
+| `from` | 发件人 |
+| `to` | 收件人 |
+| `unread` | true 仅未读 |
+| `star` | true 仅星标 |
+| `todo` | true 仅待办 |
+| `hasFile` | true 仅带附件 |
+| `startDate` / `endDate` | 时间范围 YYYY-MM-DD |
+| `page` / `size` | 分页，默认小页 |
+
+## mail.contact.list — 往来邮件
+
+某联系人与我之间的往来邮件（对方发来 + 我发给对方）。字段：`name`（姓名/工号）、`page`、`size`。
+
+## mail.view.info — 邮件详情
+
+含正文与附件列表。字段：`id`（邮件 id）。若正文为空会自动回退取正文接口。
+
+## mail.view.content — 邮件正文
+
+字段：`id`。仅返回正文（clobContent）。
+
+## mail.unread.count — 未读统计
+
+五箱统计：收件箱 / 已删除 / 垃圾箱 / 待办 / 星标。无输入字段。
+
+## mail.config.get — 邮件配置
+
+返回发送开关、附件限制等配置。无输入字段。
+
+## 收件人解析（Agent 辅助，发送前用）
+
+| operation | 字段 | 说明 |
+|---|---|---|
+| `mail.person.search` | `keyword` | 内部人员/部门搜索（返回 id 供发送解析） |
+| `mail.dep.search` | `keyword` | 部门树定位（返回部门 id 与成员展开入口） |
+| `mail.address.search` | `keyword` | 外部邮箱搜索 |
+
+注意：发送时也可直接在 `mail.send.prepare` 传 `--to`/`--to-dep`/`--to-id`/`--external` 让 CLI 解析；同名人员会要求确认唯一性。
+
+## mail.contacts.list / group.list / group.detail
+
+| operation | 字段 | 说明 |
+|---|---|---|
+| `mail.contacts.list` | `keyword`,`page`,`size` | 联系人列表/搜索 |
+| `mail.contacts.group.list` | 无 | 联系人分组列表 |
+| `mail.contacts.group.detail` | `id` | 分组详情（含统计） |
+
+## mail.template.list / sign.list / blacklist.list / attachment.center / clearlog.list
+
+| operation | 字段 | 说明 |
+|---|---|---|
+| `mail.template.list` | 无 | 模板列表 |
+| `mail.sign.list` | 无 | 签名列表 |
+| `mail.blacklist.list` | 无 | 黑名单列表 |
+| `mail.attachment.center` | `keyword`,`page`,`size` | 附件中心列表/搜索 |
+| `mail.clearlog.list` | `page`,`size` | 邮件清理日志列表 |
+
+## mail.sign.qrcode — 二维码名片
+
+风险等级：`read`。字段：`id`（签名 id，二选一）、`userName`、`jobtitle`、`email`、`signLocation`、`mobile`、`telephone`、`fax`、`selected`。给定 `id` 时从签名表单解析姓名等；否则按传入字段生成。

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

@@ -0,0 +1,43 @@
+# 发送 / 回复 / 转发 / 存草稿（prepare → apply 确认链）
+
+发送类写操作分两步：先 `prepare` 组装请求 + 安全预检 + 输出摘要（**不发送**），用户确认后 `apply` 执行。
+
+风险等级：`write`。`mail.send.prepare` 与 `mail.send.apply` 均须走确认链。
+
+## 字段（prepare / apply 共用）
+
+| 字段 | 说明 |
+|---|---|
+| `flag` | -1 新建 / 1 回复 / 3 转发 / 4 编辑草稿 |
+| `id` | 原邮件 id（回复/转发/编辑草稿时必填） |
+| `to` | 收件人（姓名/工号，逗号分隔；CLI 解析为 id） |
+| `cc` / `bcc` | 抄送 / 密送 |
+| `toDep` / `ccDep` / `bccDep` | 部门收件人（部门名，逗号分隔） |
+| `toId` / `ccId` / `bccId` | 精确收件人/抄送/密送 id（逗号分隔，跳过解析） |
+| `external` | true 表示外部邮件（用 `mail.address.search` 或原始邮箱） |
+| `subject` | 主题 |
+| `content` | 正文 |
+| `timing` | 定时发送 YYYY-MM-DD HH:mm:ss |
+| `files` / `filesizes` | 附件 fileid / 大小（逗号分隔；fileid 来自 `mail.attachment.upload`） |
+| `draft` | true 存草稿（不发送） |
+| `continuation` | prepare 返回的 continuation 令牌（apply 必填） |
+| `confirm` | true 才执行（apply 必填） |
+
+## 流程
+
+```text
+weaver-work-cli --json mail run mail.send.prepare --input-json '{"flag":"-1","to":"张三","subject":"季度汇报","content":"您好。"}'
+# 返回 continuation（含摘要、收件人解析结果、是否草稿）
+weaver-work-cli --json mail run mail.send.apply --input-json '{"continuation":"<PREPARE_CONTINUATION>","confirm":true}'
+```
+
+Windows PowerShell 与 macOS/Linux 命令一致（JSON 用单引号包裹）。
+
+## 要点
+
+- 回复（flag=1）/ 转发（flag=3）会自动把原邮件正文包裹进 `content`；编辑草稿（flag=4）需带 `id`。
+- 收件人解析：内部人员走 `mail.person.search`/部门展开，外部走 `mail.address.search` 或原始邮箱；出现重名时 CLI 抛出候选错误并要求确认，不要臆造 id。
+- `draft=true` 时 prepare 不预检发送权限，apply 走 `saveDraft`；否则 apply 走 `sendMail`。
+- 附件：先用 `mail.attachment.upload` 拿到 fileid，再在 `files` 传入。
+- apply 前 CLI 会重新校验 continuation、baseUrl/profile/userId 上下文一致，并（非草稿）重新预检发送权限；上下文变化会拒绝执行。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,33 @@
+# 邮件签名（prepare → apply 确认链，更新/删除/默认/二维码）
+
+风险等级：保存类 `write`；`mail.sign.qrcode` 为 `read`。
+
+## 签名保存（prepare → apply）
+
+| operation | 字段 |
+|---|---|
+| `mail.sign.save.prepare` | `id`（编辑时填）、`signName`、`clobContent`（签名内容，base64）、`signDesc`、`defaultUse`、`signType`（默认 "0"）、`electronSignEnable`、`confirm`、`continuation` |
+| `mail.sign.save.apply` | 同上（apply 必带 `continuation` + `confirm:true`） |
+
+`clobContent` 为签名内容，CLI 内部做 base64 编码。
+
+## 签名编辑（GET 全量 + 保存）
+
+`mail.sign.update` 字段：`id`、`signName`、`clobContent`、`signDesc`、`defaultUse`、`signType`、`electronSignEnable`。先 `getMailSignForm` 取全量再全量回写。
+
+## 签名删除 / 设为默认
+
+| operation | 字段 |
+|---|---|
+| `mail.sign.delete` | `id` |
+| `mail.sign.default` | `id` |
+
+## 二维码名片（read）
+
+`mail.sign.qrcode` 字段：`id`（签名 id，二选一）、`userName`、`jobtitle`、`email`、`signLocation`、`mobile`、`telephone`、`fax`、`selected`。给定 `id` 时从签名表单解析姓名等；否则按传入字段生成。
+
+## 要点
+
+- 保存类必须 prepare 先查全量；apply 前重新校验 continuation 与上下文。
+- 编辑/删除/默认为即时写，确认目标 id。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,31 @@
+# 邮件模板（prepare → apply 确认链，更新/删除/默认）
+
+风险等级：`write`。保存类走 prepare→apply；update 为 GET 全量 + 保存单步；delete/default 单步。
+
+## 模板保存（prepare → apply）
+
+| operation | 字段 |
+|---|---|
+| `mail.template.save.prepare` | `id`（编辑时填）、`templateType`、`subject`、`mailSubject`、`clobContent`（正文，base64）、`templateDesc`、`defaultUse`、`contentId`、`confirm`、`continuation` |
+| `mail.template.save.apply` | 同上（apply 必带 `continuation` + `confirm:true`） |
+
+`clobContent` 为正文内容，CLI 内部做 base64 编码；`contentId` 默认 `"null"`，编辑时取原值。
+
+## 模板编辑（GET 全量 + 保存）
+
+`mail.template.update` 字段：`id`、`subject`、`clobContent`、`templateDesc`、`defaultUse`、`templateType`。先 `getMailTemplateInfo` 取全量再全量回写。
+
+## 模板删除 / 设为默认
+
+| operation | 字段 |
+|---|---|
+| `mail.template.delete` | `id` |
+| `mail.template.default` | `id` |
+
+均为单步执行，执行前确认 id 与目标。
+
+## 要点
+
+- 保存类必须 prepare 先查全量；apply 前重新校验 continuation 与上下文。
+- 编辑/删除/默认为即时写，确认目标 id。
+- 写请求已发出后遇到不确定结果，停止重试，按共享 `high-risk-write.md` 处理。

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

@@ -0,0 +1,32 @@
+# 邮件 Skill 安全边界（已暂缓 / 禁用 operation）
+
+本文件记录 `weaver-e10-mail` 中**未纳入 CLI manifest** 的破坏性/缺口操作，以及高风险操作的安全约束。
+
+## 已暂缓的 operation（withheldOperations）
+
+| operation | 状态 | 原因 |
+|---|---|---|
+| `mail.delete.batch` | 暂缓 | 物理永久删除（`deleteMailResourceBatch`）不可逆、无法撤销，破坏性最强。常规 CLI 不提供；如确需执行，请在确认风险后以单独授权方式处理。 |
+| `mail.resend` | 暂缓 | 重发邮件（`resendMail`）依赖「邮件发送日志 id」（`mailRemindLogId`），源技能未封装日志查询接口，无法获得该 id 时如实提示，不臆造。 |
+
+Agent **不得**调用上述 operation，也不得用 `mail.delete.move`（逻辑删除）冒充物理永久删除。
+
+## 高风险写操作约束
+
+以下写操作会修改真实邮件数据，必须遵守共享规则 `../weaver-e10-shared/references/high-risk-write.md`：
+
+- 发送/回复/转发/存草稿：`mail.send.prepare` → 用户确认 → `mail.send.apply`（带 `continuation` + `confirm:true`）
+- 联系人/分组保存：`mail.contacts.save.prepare` → 用户确认 → `mail.contacts.save.apply`
+- 模板保存：`mail.template.save.prepare` → 用户确认 → `mail.template.save.apply`
+- 签名保存：`mail.sign.save.prepare` → 用户确认 → `mail.sign.save.apply`
+- 黑名单：`mail.blacklist.operate.prepare` → 用户确认 → `mail.blacklist.operate.apply`
+- 单步写：标星、已读、全部已读、待办、移动、逻辑删除、文件夹新建/删除、撤回、联系人/分组/模板/签名删除与默认、附件上传/下载
+
+通用约束：
+
+1. 禁止输出或索取 Cookie、ETEAMSID、业务 Token、access token、app key、app secret。
+2. 禁止读取、列出、打印、复制或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+3. 禁止绕过 `weaver-work-cli` 直接 curl、fetch、浏览器自动化或访问 E10 邮件接口。
+4. 写入/删除必须使用 CLI 确认流程；prepare→apply 时把 continuation 原样传给 apply，并在 apply 前取得用户明确确认。
+5. 附件、图片上传或文件解析属敏感数据处理，即便 operation 风险等级非高风险写入，也必须先取得用户对“文件内容可能进入大模型/外部解析服务”的明确确认。
+6. 写请求已发出后遇 `partial`/`write_uncertain`/网络中断/回查失败，立即停止，按 `high-risk-write.md` 决策树处理，不盲目重试。

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

@@ -0,0 +1,139 @@
+---
+name: weaver-e10-plan
+display_name: 泛微e10计划报告
+display_name_en: Weaver e10 Plan Reports
+description: "E10 计划报告接口 Skill：负责报告的内容统计汇总、新建、查询、修改、发布、撤回、共享报告分页查询、提交提醒与评论查看。用户说 帮我写周报/月报/季报/年报、汇总本周/上周/本月/上月的工作内容或报告、汇总上周报告、生成周报、整理本周工作写报告、查报告、改报告、发布/撤回报告、查看共享给我的报告、提醒他人交报告、查看报告评论 等意图时使用。当判定为生成/汇总本人周期报告时，将自动调用已安装的 IM消息、日报、日程、会议、项目任务、客户营销、流程 等业务模块技能采集周期数据后再整合。"
+description_zh: "E10 计划报告接口 Skill：负责报告的内容统计汇总、新建、查询、修改、发布、撤回、共享报告分页查询、提交提醒与评论查看。用户说 帮我写周报/月报/季报/年报、汇总本周/上周/本月/上月的工作内容或报告、汇总上周报告、生成周报、整理本周工作写报告、查报告、改报告、发布/撤回报告、查看共享给我的报告、提醒他人交报告、查看报告评论 等意图时使用。当判定为生成/汇总本人周期报告时，将自动调用已安装的 IM消息、日报、日程、会议、项目任务、客户营销、流程 等业务模块技能采集周期数据后再整合。"
+description_en: "E10 Plan Report API Skill: Handles report content aggregation, and supports creating, querying, modifying, publishing, and withdrawing reports, running paginated queries for shared reports, sending submission reminders, and viewing comments. Use this skill when users express intents such as writing weekly/monthly/quarterly/yearly reports, summarizing this week's/last week's/this month's/last month's work content or reports, generating weekly reports, writing reports from organized weekly work, or viewing/editing/publishing/withdrawing reports, viewing reports shared with them, reminding others to submit reports, or viewing report comments. When the intent is generating/aggregating the current user's periodic report, automatically call the installed business-module skills (IM messages, daily reports, calendar, meetings, projects/tasks, CRM, workflows) to collect in-period data before composing the report."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+cliHelp: "weaver-work-cli plan --help"
+---
+
+# 泛微E10计划报告
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
+本技能覆盖报告业务域：**汇总生成报告**（多模块采集后整合）、**查询报告详情**、**分页查询报告**、**新建**、**修改**、**发布**、**撤回**、**发送提交提醒**、**查看报告评论**。写操作全部走 prepare→apply 确认协议。
+
+## 零、第一步：意图判定（先于任何接口调用）
+
+自上而下命中即止，不需要二次询问：
+
+| 命中信号 | 走向 | 是否采集业务数据 |
+| --- | --- | --- |
+| 查看 / 查询 / 列表 / 共享给我的 / 团队 / 下属 / 成员 / 某某某的报告 / 已提交 / 发布 / 撤回 / 修改 / 提醒他们交报告 | B 查询与管理链路 | **禁止**调用任何业务模块采集数据 |
+| 动词（汇总 / 生成 / 写 / 整理 / 总结 / 帮我出一份）+ 对象（周期词 + 报告类名词），且未命中上面任何信号 | A 生成与汇总链路 | 必须按采集作业链采集 |
+
+歧义消解：「汇总上周报告」「生成本周报告」「帮我写周报 / 写月报 / 写季报 / 写年报」「帮我整理上周工作写报告」「把上周的工作总结成周报」一律归入 **A 生成链路**，不得因为出现「报告」二字而改走查询链路。
+
+A 链路细节（采集模块、时间范围、输出规范）读 [`references/plan-collect-and-compose.md`](references/plan-collect-and-compose.md)；B 链路读 [`references/plan-report-query.md`](references/plan-report-query.md)。
+
+## 命令入口
+
+```text
+weaver-work-cli plan --help
+weaver-work-cli plan schema
+weaver-work-cli --json plan run <operation> --input-json '{"key":"value"}'
+```
+
+`plan schema` 是可用能力的唯一事实来源。禁止把源文档里的接口路径当成 Agent 可直接调用的地址，也禁止把未出现在 `schema` 中的能力当作可用 operation。
+
+## Reference 路由表
+
+命中任一条件时，执行下一步前读取对应 reference。
+
+| 触发条件 | Reference |
+| --- | --- |
+| 意图判定 A/B、版本路由与租户缓存、operation 总表、通用基础规则（周期、跳转、分页表格、人员 ID、字段名禁止项） | [`references/plan-overview-and-routing.md`](references/plan-overview-and-routing.md) |
+| 查看/查询某份报告、查看共享给我的报告或下属报告、查看报告评论 | [`references/plan-report-query.md`](references/plan-report-query.md) |
+| 新建报告、修改报告、发布报告、撤回报告 | [`references/plan-report-write.md`](references/plan-report-write.md) |
+| 提醒他人提交报告、生成提交提醒默认文案 | [`references/plan-report-remind.md`](references/plan-report-remind.md) |
+| 汇总本周/上周/本月/上月工作并生成报告（多模块采集、去重润色、输出规范） | [`references/plan-collect-and-compose.md`](references/plan-collect-and-compose.md) |
+
+## 高优先级语义
+
+- **报告**：work report，用户常说「周报」「月报」「季报」「年报」「年中报告」「工作总结」「汇报」。
+- **报告类型**：`week`（周报）/ `month`（月报）/ `season`（季报）/ `halfYear`（年中报告）/ `year`（年报）。
+- **报告周期**：`year`（年份）+ `serialNumber`（周期序号）。**周报年份与周数严格遵循 ISO8601，1 月 4 日所在周为当年第 1 周**；「上周」= 上周一至上周日。
+- **发布状态**：`0` 草稿 / `1` 已发布 / `2` 已撤回 / `3` 审批中 / `4` 被退回。CLI 输出已附带 `postStatusLabel`。
+- **报告详情链接**：查询与写入成功后 CLI 会在 `detailUrl` 返回可点击的详情页地址，必须呈现给用户。
+
+## 版本路由（CLI 已内置，不要手工选择接口）
+
+报告侧接口存在标准版与 e10-ebuilder 版两套链路。判定规则：先读租户缓存（有效期 1 天），命中即复用；未命中调用版本接口读取 `ver_name`，`V2` → e10-ebuilder 链路，其它 → 标准版链路，并写回租户缓存。
+
+- 判断当前链路：`plan.version.check`（`plan route` 同义）。
+- **禁止**跳过版本判定硬编码选择链路，禁止在某条链路命中后混用另一条链路的接口。
+- 采集业务数据阶段（A 链路第 1~7 步）**禁止**调用版本接口或任何报告侧接口。
+- eb 链路报告详情页链接依赖报告详情 eb 表单 id，`plan.eb.form.resolve` 会解析并长期缓存；不要手工拼链接。
+
+## 报告侧 operation 表
+
+| 用户意图 | operation |
+| --- | --- |
+| 判断当前租户报告链路 | `plan.version.check` |
+| 解析 eb 报告详情表单 id | `plan.eb.form.resolve` |
+| 查询某份报告（按 id 或按周期），判断某周期是否已提交 | `plan.report.get` |
+| 分页查询报告列表（共享给我的、下属的） | `plan.report.page` |
+| 查看报告评论内容 | `plan.comment.list` |
+| 新建报告 | `plan.report.create.prepare` → `plan.report.create.apply` |
+| 修改报告 | `plan.report.update.prepare` → `plan.report.update.apply` |
+| 发布报告 | `plan.report.publish.prepare` → `plan.report.publish.apply` |
+| 撤回报告 | `plan.report.withdraw.prepare` → `plan.report.withdraw.apply` |
+| 发送提交提醒 | `plan.report.remind.prepare` → `plan.report.remind.apply` |
+
+## 写操作确认链（必须遵守）
+
+1. 先调用 `*.prepare`：只做只读回查、字段归一化、差异摘要并签发 continuation，**不写入**。
+2. 把目标、差异、风险读给用户，并明确询问是否执行。
+3. 用户明确确认后，才调用 `*.apply`，并**原样**传入 `confirm=true` 与 prepare 返回的 `continuation`。
+4. `*.apply` 遇到网络中断或 `partial/write_uncertain` 时**立即停止，禁止自动重试**，先做一次只读回查（`plan.report.get`）再决定下一步。
+5. `continuation` 不可手工构造、不可跨操作复用；过期或上下文变化时重新 `prepare`。
+
+**判断某周期是否已提交报告，只能通过 `plan.report.get` 按周期查询**（必须传报告年份、报告类型、报告周期，创建人缺省为当前登录人）完成；只有确认需要创建时才做重复性判断，已存在时**不得重复创建**，必须告知用户并征询是否改为编辑。
+
+## 通用基础规则（两条链路均生效）
+
+1. 周期计算遵循 ISO8601；未明确周期类型（周/月/季/年）时先向用户确认，确认前不得臆造区间。
+2. 报告新建/查询/修改/发布/撤回成功后，必须呈现 `detailUrl`，支持点击跳转详情页。
+3. 分页结果必须用表格展示，固定列为 **报告名称 / 报告创建人名称 / 发布时间**，报告名称可点击跳转 `detailUrl`。
+4. 涉及人员 ID 时只取 `id` 或 `employeeId` 字段，**禁止取 `userId`**；人员信息通过 weaver-e10-hrm skill 获取。
+5. 请求体中的雪花 ID（人员 ID、报告 ID 等）必须加引号包裹为字符串，避免精度丢失；直接用 CLI 的业务字段即可，CLI 会完成归一化。
+6. 执行阶段与创建出的报告内容中，**决不允许出现报告相关的数据库英文字段名**（如 `content`、`f_content`、`summary`、`f_summary`、`plans`、`f_plans`、`year`、`f_year`、`type`、`f_type`、`serial_number`、`f_serial_number`）。CLI 已把 eb 链路返回值归一化为业务字段，Agent 直接使用 `report.*` 业务键即可，不要向用户复述接口原始结构。
+7. 认证与会话由 CLI 托管（Cookie 完整原始串、eteamsid、User-Agent 三件套缺一不可）；若未登录先按共享规则读取 `../weaver-e10-shared/references/e10-auth-and-session.md` 并通过 `weaver-work-cli auth ...` 完成会话确认，禁止输出或索取任何凭证。
+
+## 失败处理
+
+- 认证类错误（`authentication` / `session_expired`）：先向用户确认 E10 登录域名，再执行 `weaver-work-cli auth login`，不要用其他方式排查。
+- `policy` / `link_unsupported`：该能力在当前链路不可用（例如 eb 链路的撤回、提交提醒、评论），按错误 `message` 给出的替代路径处理。
+- `validation` / `not_found` / `report_exists` / `already_published` / `not_published`：属业务前置条件不满足，先向用户说明再决定下一步，禁止反复重试。
+- `partial` / `write_uncertain`：立即停止写入流程，做一次只读回查后向用户说明。
+- 其它业务失败看 stderr JSON 的 `error.type` / `error.subtype` / `error.message`。
+
+## 不在范围
+
+- 不绕过 CLI 直接 curl/fetch 访问 E10 接口，不自行拼报告侧接口路径。
+- 业务数据采集不在本技能内实现：按 [`references/plan-collect-and-compose.md`](references/plan-collect-and-compose.md) 的对应关系调用已安装的业务模块技能。
+- eb 链路的「撤回报告」为 ESB 动作流，改由 weaver-e10-customesb-execute skill 执行同名动作流。
+- 人员「姓名 → 人员 ID」解析交给 weaver-e10-hrm skill。
+- 禁止把未出现在 `plan schema` 中的能力当作可用 operation。
+
+## 平台兼容
+
+命令示例同时兼容 Windows 与 macOS/Linux。简单 JSON 用 `--input-json`，复杂或多行 JSON 存为 UTF-8 文件后用 `--input <path>`。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json plan run plan.report.get --input-json '{"type":"week","serialNumber":36}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json plan run plan.report.get --input-json '{"type":"week","serialNumber":36}'
+```

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

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

package/skills/weaver-e10-plan/references/plan-collect-and-compose.md

@@ -0,0 +1,123 @@
+# 汇总生成报告：多模块数据采集作业链
+
+## 何时使用
+
+意图判定为 **A 生成链路**（汇总 / 生成 / 写 / 整理 + 周期词 + 报告类名词，且未命中查询类信号）时，读取本 reference 并按步骤链完整执行，**禁止跳步、禁止二次询问是否开始采集**。
+
+## 技能调用对应关系（数据来源唯一指定）
+
+凡是已安装对应模块的技能，**必须且只能**调用下表中给定的技能获取数据，严禁跳过，也严禁改用指定技能之外的其他技能；无相关数据的模块可不做统计、汇总与分析。
+
+| 数据类别 | 唯一指定技能 |
+| --- | --- |
+| IM 消息 | `weaver-e10-yimiaoban` |
+| 客户、联系人、商机、线索 | `weaver-e10-jiuchuanhui` |
+| 项目、任务 | `weaver-e10-shijingran` |
+| 日报 | `weaver-e10-blog` |
+| 日程 | `weaver-e10-calendar` |
+| 会议 | `weaver-e10-meeting` |
+| 流程 | `weaver-e10-workflow` |
+
+技能调用名一律使用已安装技能 frontmatter 的 `name` 字段（个别技能目录名可能带 `__skillhub` 等后缀，以 `name` 为准）。人员姓名与人员 ID 解析使用 `weaver-e10-hrm`。
+
+## 作业步骤链
+
+### Step 0 前置准备（禁止调用任何报告接口）
+
+- 若尚未确认登录态，先按共享规则读取 `../weaver-e10-shared/references/e10-auth-and-session.md` 并通过 `weaver-work-cli auth ...` 确认会话（Cookie 完整原始串 + eteamsid + User-Agent 三件套，缺一不可）。
+- 根据用户表述计算报告周期时间范围（周报遵循 ISO8601，例如「上周」= 上周一至上周日）；未明确周期类型时先向用户确认周/月/季/年，确认前不得臆造区间。
+- 确定数据归属主体：默认当前登录人本人；若判定涉及他人且已获用户确认，则主体为该人。
+
+### Step 1~7 依序采集周期内数据
+
+顺序可调，但每个已安装模块都必须采集，不得因顺序原因遗漏。每个技能加载后按其自身 SKILL.md 与接口文档执行，**不要在本技能内自行构造该模块的 HTTP 请求**。
+
+| Step | 模块 | 采集内容与筛选规则 |
+| --- | --- | --- |
+| 1 | IM 消息（`weaver-e10-yimiaoban`） | 仅统计发言时间落在周期内、本人发送的全部单聊与群聊消息内容，且必须完全统计不能只统计一部分。若某群聊中不含本人实际发言的消息，则不统计该群聊 |
+| 2 | 日报（`weaver-e10-blog`） | 仅筛选周期内本人提交的日报内容 |
+| 3 | 日程（`weaver-e10-calendar`） | 本人为创建人或参与人，且日程开始时间、结束时间任意一项落在周期内的日程；**排除请假类型日程** |
+| 4 | 会议（`weaver-e10-meeting`） | 本人为创建人或参会人，且会议开始时间、结束时间任意一项落在周期内的会议 |
+| 5 | 项目、任务（`weaver-e10-shijingran`） | 本人为创建人、负责人或参与人，且创建时间、完成时间均在周期内的项目与任务 |
+| 6 | 客户/联系人/商机/线索（`weaver-e10-jiuchuanhui`） | 仅统计创建时间落在周期内的相关数据 |
+| 7 | 流程（`weaver-e10-workflow`） | 本人创建的流程，以周期内创建时间为准；非本人创建的流程，仅统计与本人岗位相关且本人实际批准处理的流程；**待办、转办、知会、请假类流程不予统计**。汇总需结合表单内容、流转意见、签字意见归纳分析 |
+
+**失败兜底（严格执行）**
+
+- Step 1~7 中任一已安装技能调用失败或返回错误 → 停止采集并向用户说明是哪个模块失败；不得跳过该模块、不得改用其他技能、不得直接调用该模块 HTTP 接口、不得静默继续生成。
+- 若确认某模块技能未安装 → 告知用户该模块无数据来源，由用户决定是否安装后重试，不得静默忽略。
+- 查不到数据即该模块记为空，不影响其它模块继续。
+
+### Step 8 汇总润色
+
+按输出规范整合 Step 1~7 的数据，形成分节内容稿。禁止堆砌原始数据、禁止出现计数统计类内容。
+
+### Step 9 呈现并确认
+
+把汇总润色后的内容直观呈现给用户，并提示「是否生成对应周期的报告」，等待用户确认。
+
+### Step 10 重复性检查与创建
+
+用户确认后：
+
+1. 先调用 `plan.report.get` 按周期（报告年份 + 报告类型 + 报告周期，创建人取当前登录人）判断该周期报告是否已存在——**此时才允许触发版本路由与报告侧接口**。
+2. 已存在 → 不得重复创建，明确告知用户并征询是否改为编辑（改走 `plan.report.update.prepare`）。
+3. 不存在 → 按 [`plan-report-write.md`](plan-report-write.md) 走 `plan.report.create.prepare` → `plan.report.create.apply`。
+
+## 内容提取与输出规范
+
+1. **周期严格限定**：所有业务数据严格按报告周期的起止时间筛选。例如 2026 年第 36 周的报告，周期为 2026-08-31 ~ 2026-09-06。
+2. **按业务板块分节**：例如项目任务推进、会议日程执行、流程审批办理、内外沟通协作、客户营销运维、日常工作汇报等；禁止直接堆砌原始数据。
+3. **不暴露数据来源**：统计业务模块数据时，不要显示数据的来源模块、依据和获取方式，只呈现最终获取到的数据。
+4. **润色整合**：对原始数据进行润色整合、去重合并、提炼总结，剔除冗余信息，保证内容通顺、重点清晰、逻辑完整。
+5. **禁止计数统计**：汇总结果中禁止出现会话数、消息条数、被 @ 次数、被回复次数、会议场次、任务条数等任何计数统计类内容；只提炼有效工作事项，不统计无关闲聊。
+6. **先呈现后创建**：汇总内容必须先直观呈现给用户，并提示是否生成对应周期的报告；用户确认后才执行创建。
+
+## 命令
+
+判断某周期是否已提交（Step 10 第 1 步）：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json plan run plan.report.get --input-json '{"year":2026,"type":"week","serialNumber":36}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json plan run plan.report.get --input-json '{"year":2026,"type":"week","serialNumber":36}'
+```
+
+查看当前租户报告链路（仅在需要诊断时使用，采集阶段不要调用）：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json plan run plan.version.check --input-json '{}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json plan run plan.version.check --input-json '{}'
+```
+
+## 输出处理
+
+- Step 8 产物是给用户看的分节内容稿，**不包含**任何计数统计、来源模块说明或数据库字段名。
+- Step 9 必须显式询问用户是否生成报告。
+- Step 10 的 `exists` 为 `true` 时停止创建，转为询问是否编辑。
+
+## 注意
+
+- 采集阶段（Step 1~7）**禁止**调用 `plan.version.check`、`plan_searchAppver` 或任何报告侧接口。
+- 不要因为一次汇总任务去调用指定技能之外的业务能力；只使用上表列出的技能。
+- 数据主体默认当前登录人；涉及他人时必须先取得用户确认。
+
+## 失败处理
+
+- 任一业务模块技能调用失败：停止采集，明确告知失败模块，不得静默跳过或改用其它技能。
+- 模块技能未安装：告知用户该模块无数据来源，由用户决定是否安装后重试。
+- 周期不明确：先向用户确认，确认前不臆造时间区间。
+- 报告侧接口失败（`authentication` / `policy` / `api`）：按 [`plan-overview-and-routing.md`](plan-overview-and-routing.md) 的失败处理执行。