weaver-work-cli 0.1.2 → 0.1.5

package/skills/weaver-e10-meeting/references/meeting-queries.md

@@ -0,0 +1,61 @@
+# 会议与会议室查询
+
+## 何时使用
+
+查今天的会议 / 会议列表、探测环境模式、建会前置判断、会议室与占用、会议类型。
+
+## 输入要点
+
+- 时间格式统一 `yyyy-MM-dd HH:mm`；日期 `yyyy-MM-dd`。
+- 长 id（会议室/会议/人员）超 2^53 必须字符串。
+- `meeting.list` 的接口 body 过滤实测不生效：CLI 采用空 body 拉全量 + 客户端 `filterDate` 过滤，**不要尝试给 body 塞过滤字段**。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json meeting run meeting.env.detect --input-json '{}'
+weaver-work-cli --json meeting run meeting.list --input-json '{"filterDate":"2026-09-11"}'
+weaver-work-cli --json meeting today
+weaver-work-cli --json meeting run meeting.room.list --input-json '{"beginDate":"2026-09-11 09:00","endDate":"2026-09-11 10:00","onlyAvailable":true}'
+weaver-work-cli --json meeting run meeting.type.list --input-json '{"name":"项目","includeCount":true}'
+weaver-work-cli --json meeting run meeting.room.usage --input-json '{"roomid":"1297870848451641350","bywhat":4,"currentdate":"2026-09-11"}'
+weaver-work-cli --json meeting run meeting.calendar.base --input-json '{}'
+weaver-work-cli --json meeting run meeting.detail.field --input-json '{"id":"1305624900858404950"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json meeting run meeting.env.detect --input-json '{}'
+weaver-work-cli --json meeting run meeting.list --input-json '{"filterDate":"2026-09-11"}'
+weaver-work-cli --json meeting today
+weaver-work-cli --json meeting run meeting.room.list --input-json '{"beginDate":"2026-09-11 09:00","endDate":"2026-09-11 10:00","onlyAvailable":true}'
+weaver-work-cli --json meeting run meeting.type.list --input-json '{"name":"项目","includeCount":true}'
+weaver-work-cli --json meeting run meeting.room.usage --input-json '{"roomid":"1297870848451641350","bywhat":4,"currentdate":"2026-09-11"}'
+weaver-work-cli --json meeting run meeting.calendar.base --input-json '{}'
+weaver-work-cli --json meeting run meeting.detail.field --input-json '{"id":"1305624900858404950"}'
+```
+
+## 输出处理
+
+- `meeting.list` 返回 `meetings[]`（含 `id`/`name`/`beginDatetime`/`endDatetime`/`address`/`mtStatus`），按开始时间升序输出 Markdown 表格；CLI 自动翻页拉全量后做客户端 `filterDate` 过滤。
+- `meeting.room.list` 返回 `rooms[]`（`disabled` 已归一化为布尔）与 `availableRooms[]`；带时间范围时 `disabled=true` 即该时段已被占用。
+- `meeting.calendar.base` 返回 `createBaseData`：`onlyFlowCreate`（0=可手动建会 1=只能流程建会）、`workFlowBaseIds`、`repeatWorkFlowBaseIds`、`existWorkFlow`。
+- `meeting.env.detect` 返回 `mode: "eb" | "standard"` + `fromCache`：
+  - **默认按 baseUrl 读缓存**（第一次探测成功后固化到 CLI 状态目录），命中时不发网络请求；
+  - `refresh: true` 强制重新冒烟并更新缓存（用户说"重新探测/刷新模式"时用）；
+  - 标准版回退时附带 `ebSmokeError`（EB 冒烟失败原因，用于诊断）；
+  - 两者冒烟均失败时报 `env_unavailable`（环境未配置完整，禁止强行执行）。
+
+## 注意
+
+- 示例中的 id 均为 `PLACEHOLDER_VALUE`，实际调用替换为真实查询结果。
+- 标准 `weaver-work-cli --json` 输出 envelope：成功 `ok=true`；失败看 `error.type/subtype/message`。
+
+## 失败处理
+
+- `env_unavailable`：提示环境会议应用未安装或接口未配置完整，停止。
+- `permission_denied`（HTTP 403 语义）：提示联系管理员开通接口权限。
+- `session_expired`：走 `weaver-work-cli auth login --base-url <域名>` 登录流程。

package/skills/weaver-e10-meeting/references/meeting-receipts-signs.md

@@ -0,0 +1,48 @@
+# 回执与签到
+
+## 何时使用
+
+查会议回执情况、给某人回执（参加/不参加/请假）、查签到记录与统计。
+
+## 输入要点
+
+- 回执更新**必须传回执记录主键 `id`**（不是 `memberId`）；`prepare` 会自动按 `memberId` 回查定位。
+- `attendStatus` 枚举：`0`=未填写、`1`=参加、`2`=不参加（回执"否/请假"传 2）。
+- 回执列表接口必须带 `isMobile`（CLI 缺省 `false`；缺失会导致后端 NPE→500，已被 CLI 托管）。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json meeting run meeting.receipt.list --input-json '{"mtId":"1305624900858404950"}'
+weaver-work-cli --json meeting run meeting.receipt.update.prepare --input-json '{"mtId":"1305624900858404950","memberId":"101","attendStatus":2,"remark":"请假"}'
+# 用户确认后：
+weaver-work-cli --json meeting run meeting.receipt.update.apply --input-json '{"confirm":true,"continuation":"<prepare返回的continuation>","mtId":"1305624900858404950","memberId":"101","attendStatus":2,"remark":"请假"}'
+weaver-work-cli --json meeting run meeting.sign.list --input-json '{"mtId":"1305624900858404950"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json meeting run meeting.receipt.list --input-json '{"mtId":"1305624900858404950"}'
+weaver-work-cli --json meeting run meeting.receipt.update.prepare --input-json '{"mtId":"1305624900858404950","memberId":"101","attendStatus":2,"remark":"请假"}'
+# 用户确认后：
+weaver-work-cli --json meeting run meeting.receipt.update.apply --input-json '{"confirm":true,"continuation":"<prepare返回的continuation>","mtId":"1305624900858404950","memberId":"101","attendStatus":2,"remark":"请假"}'
+weaver-work-cli --json meeting run meeting.sign.list --input-json '{"mtId":"1305624900858404950"}'
+```
+
+## 输出处理
+
+- `receipt.list` 返回 `receipts[]`（含 `id`/`memberId`/`attendStatus`/`remark`）；`receipt.update.prepare` 返回 `preview`（含定位到的回执记录 `id`）。
+- `sign.list` 返回 `signs[]` 与 `summary`（`total`/`signed`/`unsigned`），输出 Markdown 表格。
+
+## 注意
+
+- `prepare` 找不到参会人回执记录时报 `receipt_not_found`：先用 `meeting.receipt.list` 核对 `memberId`。
+- `apply` 前必须取得用户对"目标回执 + 状态 + 备注"的明确确认。
+
+## 失败处理
+
+- `target_changed` / `continuation_expired`：重新 prepare 再确认。
+- 写请求发出后网络中断 → `partial/write_uncertain`：禁止自动重试，先 `meeting.receipt.list` 回查是否已生效。

package/skills/weaver-e10-meeting/references/meeting-update.md

@@ -0,0 +1,7 @@
+# 已迁移
+
+本文件已由 [meeting-change.md](meeting-change.md) 取代。
+
+- 业务术语为「变更」；CLI operation 为 `meeting.change.prepare` / `meeting.change.apply`。
+- 旧 `meeting.update.*` 已下线：它会固定发送 `operateType=UPDATE`，与"草稿走 UPDATE、正常走 CHANGE"的真实业务语义不符。
+- 本文件可安全删除。

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

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-09-11",
+  "generator": "weaver-e10-skill-maker",
+  "sourceLocation": "user-provided",
+  "note": "源资料为用户提供位置上的本机文件，此处只记录名称与角色，不记录本机绝对路径；更新检测按文件级指纹（size+sha256，在源资料位置按需计算）执行，标记弱检测。",
+  "sources": [
+    {
+      "source": "weaver-e10-meeting (standalone skill) v2.4.2 — SKILL.md",
+      "role": "existing-skill",
+      "note": "standalone 双模式会议 Skill（业务编排/冲突铁律/链接规则的来源）"
+    },
+    {
+      "source": "weaver-e10-meeting (standalone skill) — references/meeting-business-logic.md",
+      "role": "api-doc",
+      "note": "标准版接口契约权威来源（路径/入参/坑位：SUBMIT+空id、cansub、回执 id、isMobile、finishAt 禁 0、长 id 字符串）"
+    },
+    {
+      "source": "weaver-e10-meeting (standalone skill) — references/meeting-urls.md",
+      "role": "api-doc",
+      "note": "打开链接 URL 模板（标准版 meetingSingle）"
+    },
+    {
+      "source": "weaver-work-cli repository (git release b910e60, v0.1.3)",
+      "role": "code",
+      "note": "生成目标仓库；结构对齐 src/shortcuts/hrm 与 calendar 写链样板"
+    }
+  ],
+  "fingerprint": "weak",
+  "operationImpact": {
+    "meeting-business-logic.md": [
+      "meeting.env.detect",
+      "meeting.calendar.base",
+      "meeting.list",
+      "meeting.room.list",
+      "meeting.room.usage",
+      "meeting.type.list",
+      "meeting.detail.field",
+      "meeting.conflict.room",
+      "meeting.conflict.member",
+      "meeting.conflict.roomAttribute",
+      "meeting.create.prepare",
+      "meeting.create.apply",
+      "meeting.receipt.list",
+      "meeting.receipt.update.prepare",
+      "meeting.receipt.update.apply",
+      "meeting.sign.list"
+    ]
+  }
+}

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

@@ -0,0 +1,140 @@
+---
+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) 的失败处理执行。

package/skills/weaver-e10-plan/references/plan-overview-and-routing.md

@@ -0,0 +1,138 @@
+# 意图判定、版本路由与通用规则
+
+## 何时使用
+
+任何与「报告 / 周报 / 月报 / 季报 / 年报 / 年中报告」相关的请求，先读本 reference 完成意图判定和链路判定，再按需读取其它 reference。
+
+## 一、意图判定（最高优先级）
+
+自上而下命中即止，命中后不再二次询问。
+
+### 1. B 链路（查询与管理已有报告）——禁止采集业务数据
+
+消息中出现以下任一信号即走 B：
+
+`查看` / `查询` / `列表` / `共享给我的` / `团队` / `下属` / `成员` / `某某某的报告` / `已提交` / `发布` / `撤回` / `修改` / `提醒他们交报告`。
+
+B 链路只调用报告侧 operation，**禁止**因为「报告」二字去调用 IM消息、日报、日程、会议、项目任务、客户营销、流程等业务模块采集数据。
+
+### 2. A 链路（生成与汇总报告）——必须采集业务数据
+
+未命中 B 链路任何信号，且同时满足以下两个要素时走 A：
+
+- 动词要素：汇总 / 生成 / 写 / 整理 / 总结 / 帮我出一份；
+- 对象要素：周期词（周报 / 月报 / 季报 / 年报 / 周 / 月 / 季度 / 本周 / 上周 / 本月 / 上月 / 本季度 / 上季度）+ 内容词（报告 / 周报 / 内容 / 工作 / 总结）。
+
+### 3. 默认值规则
+
+动词为「汇总 / 生成 / 写 / 整理」，对象含周期与报告类名词，且未命中 B 链路信号时，一律按 A 处理，默认采集**当前登录人自己**的业务数据。以下说法直接归入 A：
+
+- 汇总上周报告、汇总本周报告、汇总上月报告、汇总上季度报告；
+- 生成上周报告、生成本周报告、帮我写周报 / 写月报 / 写季报 / 写年报；
+- 帮我整理上周工作写报告、把上周的工作总结成周报。
+
+A 链路的完整作业步骤见 [`plan-collect-and-compose.md`](plan-collect-and-compose.md)。
+
+## 二、版本路由与租户缓存
+
+报告侧接口分标准版与 e10-ebuilder 版两套链路，由 CLI 统一判定，Agent **不要手工选择链路**。
+
+| 步骤 | 行为 |
+| --- | --- |
+| 1 | 优先读租户隔离、有效期 1 天的版本判定缓存；命中且未过期直接复用，跳过版本接口 |
+| 2 | 缓存缺失或过期时调用 `plan_searchAppver`，读取返回字段 `ver_name` |
+| 3 | `ver_name = V2` → 全部报告侧接口走 **e10-ebuilder 链路**；其它情况 → **标准版链路** |
+| 4 | 把判定结果写入租户缓存，有效期 1 天 |
+
+禁止行为：不读缓存直接调版本接口；缓存过期不重新拉取；跳过版本判定硬编码链路；eb 链路命中后混用标准版接口。
+
+- 查看当前判定结果：`plan.version.check`（或 `plan route`），返回 `link`（`standard` / `eb`）、`verName`、`cached`、`degraded`。
+- `degraded: true` 表示版本接口暂不可用、已降级为标准版链路，此时不写缓存，下次会重试。
+- **采集业务数据阶段禁止调用版本接口和任何报告侧接口**，只在判定为 B 链路、或 A 链路走到「用户确认后做重复性检查」时才允许触发版本路由。
+
+### eb 报告详情页表单 id
+
+eb 链路详情页地址为 `/sp/ebdfpage/card/0/{报告详情 eb 表单 id}/{报告 id}`，其中表单 id 指 **idobjId**（不是 formId）。`plan.eb.form.resolve` 负责解析：
+
+- 应用 appTag：`weaver-wrplan-eb`；报告详情表单 tag：`uf_plan_work_report`。
+- 租户 key 为 `tt1pa2w2i3` 时无需动态获取，固定为 `1029659181695361024`；其它租户按 appTag、表单 tag 动态获取。
+- 取到后按租户**长期缓存**，后续直接使用，不再动态获取。
+
+`plan.report.get` 与 `plan.report.page` 已在 `detailUrl` 中返回拼好的详情页地址，Agent 直接用即可。
+
+## 三、operation 总表
+
+| operation | 风险 | 说明 |
+| --- | --- | --- |
+| `plan.version.check` | read | 判定租户报告链路，命中缓存则跳过接口调用 |
+| `plan.eb.form.resolve` | read | 解析 eb 报告详情表单 id（idobjId） |
+| `plan.report.get` | read | 按 id 或按周期查询单份报告详情，附带评论总条数 |
+| `plan.report.page` | read | 分页查询报告列表 |
+| `plan.comment.list` | read | 查询报告评论内容（标准版链路） |
+| `plan.report.create.prepare` / `.apply` | read-before-write / high-risk-write | 新建报告 |
+| `plan.report.update.prepare` / `.apply` | read-before-write / high-risk-write | 修改报告 |
+| `plan.report.publish.prepare` / `.apply` | read-before-write / high-risk-write | 发布报告 |
+| `plan.report.withdraw.prepare` / `.apply` | read-before-write / high-risk-write | 撤回报告（标准版链路） |
+| `plan.report.remind.prepare` / `.apply` | read-before-write / high-risk-write | 发送提交提醒（标准版链路） |
+
+字段细节以 `weaver-work-cli plan schema` 为准。
+
+## 四、通用基础规则（两条链路均生效）
+
+1. **周期计算**：周报年份、周数严格遵循 ISO8601，1 月 4 日所在周为当年第 1 周。未明确周期类型时先向用户确认周/月/季/年，确认前不得臆造区间。
+2. **跳转能力**：报告新建、查询、修改、发布、撤回成功后，必须把 `detailUrl` 呈现为可点击链接。
+3. **分页表格输出**：分页接口返回的列表必须用表格展示，固定列为 **报告名称 / 报告创建人名称 / 发布时间**；报告名称可点击，直接跳转 `detailUrl`。
+4. **人员 ID 规则**：所有传递和获取人员 id 的地方，都取 `id` 或 `employeeId` 字段，**禁止取 `userId`**。人员信息通过 weaver-e10-hrm skill 获取。
+5. **雪花 ID 传参**：请求体中的雪花 ID（人员 ID、报告 ID 等）必须加引号包裹为字符串，避免数字精度丢失。CLI 已完成归一化，业务输入按字符串传更安全。
+6. **重复性判断**：判断当前人员是否提交某个周期的报告，**只能**通过 `plan.report.get` 按周期查询（必须传报告年份、报告类型、报告周期，创建人缺省为当前登录人）。
+7. **不得重复创建**：当且仅当用户确认需要创建某个周期的报告时才判断是否已创建；若已创建，不得重复创建，需明确告知用户并征询是否改为编辑。
+8. **字段名禁止项**：任何执行阶段和最终创建的报告内容中，决不允许出现报告相关的数据库英文字段名。CLI 已把 eb 链路返回值归一化为业务字段（`reportId` / `title` / `content` / `summary` / `plans` / `year` / `type` / `serialNumber` / `postStatus` / `postTime` / `creator` / `detailUrl`），Agent 只使用这些业务键，不要向用户复述原始接口结构。
+9. **认证三件套**：所有请求必须携带完整登录态（Cookie 完整原始串、eteamsid、User-Agent）。由 CLI 托管，禁止输出、索取或写入任何凭证；未登录时先按共享规则读取 `../weaver-e10-shared/references/e10-auth-and-session.md` 并通过 `weaver-work-cli auth ...` 确认会话。
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json plan run plan.version.check --input-json '{"refresh":false}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json plan run plan.version.check --input-json '{"refresh":false}'
+```
+
+强制重新判定链路：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json plan run plan.version.check --input-json '{"refresh":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json plan run plan.version.check --input-json '{"refresh":true}'
+```
+
+## 输出处理
+
+`plan.version.check` 返回示例（字段说明）：
+
+- `link`：`standard` 或 `eb`，本次生效的链路。
+- `verName`：版本接口返回的 `ver_name` 原始值。
+- `cached`：本次结果是否来自缓存。
+- `degraded`：是否因版本接口不可用而降级为标准版。
+
+## 注意
+
+- 报告侧接口链路由 CLI 判定并缓存；Agent 不要缓存或自行推断链路。
+- 采集阶段（A 链路第 1~7 步）不得触发版本接口或报告侧接口。
+
+## 失败处理
+
+- `authentication` / `session_expired`：先向用户确认 E10 登录域名，再执行 `weaver-work-cli auth login`。
+- `policy` / `link_unsupported`：该能力在当前链路不可用，按 `message` 给出的替代路径处理。
+- `endpoint_not_found`（HTTP 404）：当前环境可能未部署「计划报告」相关应用或接口，先向用户说明再决定是否停止。