weaver-work-cli 0.1.8 → 0.1.21

package/skill-template/domains/jinchengda.md

@@ -0,0 +1,23 @@
+本业务域用于泛微 E10 今承达合同管理。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、路由优先级、选命令表、处理链、执行原则、写操作失败决策树和“不在本 skill 范围”。具体用法拆到 `references/`：
+
+- `contract-agent-entry.md`：schema、`contract run` 统一入口、退出码与输入方式。
+- `contract-template-selector.md`：合同类型树、模板分类树、模板列表与模板详情。
+- `contract-clause-recommender.md`：条款标签、条款分类树、条款搜索、条款列表与条款组。
+- `contract-clause-reference-save.md`：已引用条款查询与条款引用写入的 `prepare -> apply` 协议。
+- `contract-signing-subjects.md`：应用 Tag、表单 Tag、字段定义、字段选项与签约主体查询。
+- `contract-subject-create.md`：新建签约主体的 `prepare -> apply` 写入协议。
+- `contract-workflow-discovery.md`：workflowId、表单字段与字段选项的运行时解析链。
+- `contract-request-write.md`：创建、保存、提交、催办四个写操作的确认链与错误边界。
+- `contract-request-status.md`：流程状态、签字意见与 `flowStatus.code` 枚举。
+- `contract-disabled-capabilities.md`：企业资信、撤回/退回等未实现能力的处理边界。
+- `source-manifest.json`：源资料指纹，用于后续更新检测。
+
+Agent 调优重点：
+
+- `weaver-work-cli contract schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 `userid`、`userId`、Cookie、ETEAMSID、Token 或内部控制字段，用户 ID 由 CLI 从会话注入。
+- 环境相关 ID（`appId`、`objId`、`formId`、`workflowId`、`nodeId`）必须运行时解析，未找到就停止，不使用标准环境 ID 兜底。
+- 各接口成功码不统一（`code=0`、`code=200`、`message.code="0"`、`message.errcode="0"`），HTTP 200 不等于业务成功。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；提交审批与催办需要与“创建并保存”分开的第二次确认。
+- 提交后必须回读 `contract.request.status` 的 `flowStatus.code`（1 审批中 / 3 已归档）才算生效。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/meeting.md

@@ -1,3 +1,3 @@
 # 会议（meeting）业务域
 
-会议域覆盖 E10 标准版会议应用：环境模式探测、会议列表、会议室与占用视图、会议类型、冲突检测、预约会议（prepare/apply 确认链）、回执与签到查询。入口 `SKILL.md` 只做路由；具体命令、字段约束与失败处理拆到 `references/`（meeting-queries / meeting-create / meeting-receipts-signs）。关键安全边界：预约与回执更新是高风险写，必须走 prepare→用户确认→apply；冲突命中（含仅提醒）绝不提供"强制新建"选项；EB 版链路与工作流建会在 v1 未实现，见 manifest 的 withheldOperations。
+会议域覆盖 E10 标准版会议应用：环境模式探测、会议列表、会议室与占用视图、会议类型、冲突检测、预约会议（prepare/apply 确认链）、回执与签到查询。入口 `SKILL.md` 只做路由；具体命令、字段约束与失败处理拆到 `references/`（meeting-queries / meeting-create / meeting-receipts-signs）。关键安全边界：预约与回执更新是高风险写，必须走 prepare→用户确认→apply；冲突命中严格按应用设置处置（禁止提交→直接拒绝；仅提醒→告知用户，用户坚持时仍可继续提交）；EB 版链路与工作流建会在 v1 未实现，见 manifest 的 withheldOperations。

package/skill-template/domains/workflow.md

@@ -6,7 +6,7 @@
 - `workflow-operate.md`：单条流程同意/提交/退回/转办/委托/转发/抄送/加审/收回/结束/征询/删除/催办的 `prepare -> apply` 写入协议。
 - `workflow-batch.md`：批量提交/置已读/催办/共享/转发/退回的 6 个**单命令**写入协议。
 - `workflow-share.md`：单条流程共享给人员/部门/分部/群组/角色/岗位/所有人的 `prepare -> apply` 写入协议。
-- `workflow-create.md`：发起流程的 `createList -> createForm -> createPrepare -> createApply` 确认链。
+- `workflow-create.md`：发起流程的 `createForm -> createRequest` 两条命令链（工作流解析、载入表单、必填校验与落盘收敛在命令内部）。
 - `workflow-edit.md`：修改已存在流程表单的 `editLoad -> editPrepare -> editApply` 确认链。
 - `workflow-memory.md`：记忆偏好读取、`oaContext`（OA 版本 + 当前用户身份）与语义记忆保存。
 - `source-manifest.json`：源资料指纹、sourceChunks、operationImpact 与生成产物基线，供源资料更新检测。

package/skill-template/skill-template.md

@@ -13,7 +13,7 @@ requires:
 cliHelp: "weaver-work-cli {{command}} --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`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。安装或读取失败时必须停止执行；命令均成功后重新读取共享规则，仍读不到就停止并把结果报告用户，不得凭猜测继续。**
 认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
 所有命令通过 `weaver-work-cli --json {{command}} run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli {{command}} schema` 是 operation、字段和风险等级的合约来源。
 若 `schema` 或 reference 提供 `inputExamples`，优先复用其中和当前意图最接近的样例并只替换用户明确给出的值；标记为 `synthetic` 的样例需要业务复核，不能当作源资料事实。若 operation 标记了 `missingExamples` 或参数覆盖矩阵中的 `needs-confirmation` 字段，先向用户说明缺少哪些入参事实并索取补充，不要通过反复尝试不同 JSON 格式来猜。

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

@@ -0,0 +1,111 @@
+---
+name: weaver-e10-blog
+display_name: 泛微E10工作日报
+display_name_en: Weaver E10 Daily Report
+description: "泛微 E10 工作日报的查询、发布、编辑、评论、点赞、提醒与 Excel 导出能力，通过 weaver-work-cli blog 命令执行。"
+description_zh: "泛微 E10 工作日报全流程：群体日报查询（下属/关注）、单人日报查询、HRM 姓名解析、评论查询、默认共享查询、日报导出 xlsx，以及发布、编辑、评论、点赞、提醒的 prepare -> apply 写入确认链。"
+description_en: "Full lifecycle of Weaver E10 daily reports: group and personal queries, HRM name resolution, comments, default sharing, Excel export, and prepare -> apply confirmation chains for publish, edit, comment, like, and remind operations."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+cliHelp: "weaver-work-cli blog --help"
+---
+
+# weaver-work-cli 日报助手
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
+**`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。传 `true` 时不要再写 `--profile` / `--base-url`。完整规则见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)。
+
+认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+所有命令通过 `weaver-work-cli --json blog run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应文件；**references 是第一信息源**，`weaver-work-cli blog schema` 是 operation、字段和风险等级的合约来源，不要靠反复尝试不同 JSON 格式来猜字段。
+命令示例、提示词和临时说明必须同时兼容 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 写法。
+
+## 适用场景与触发条件
+
+触发条件：用户提到「日报」「工作日报」「写日报」「查日报」「日报补交」「未提交日报」「催交日报」「提醒交日报」「下属日报」「我关注的人的日报」「日报评论」「点赞日报」「导出日报」「日报 Excel」等意图，或需要把某人姓名解析为 E10 人员后再查日报。
+
+典型适用场景：
+- 查询下属/关注人群体的日报提交与补交情况（blog.query）
+- 按日期区间逐日查询单人日报与提交状态（blog.query_user）
+- 把姓名、工号模糊信息解析成 E10 userId（blog.resolve_users）
+- 查询某篇日报的评论（blog.comments）、导出日报 Excel（blog.export）
+- 发布/编辑/评论/点赞/催交日报（prepare -> apply 确认链，写入类高风险操作）
+
+不适用：人事档案、考勤、薪酬、流程审批等非日报意图。
+
+## 路由优先级
+
+1. 用户意图涉及工作日报（日报、日志、补交、催交、提醒交日报）→ 本模块。
+2. 先读 `weaver-work-cli blog schema` 确认 operation 合约，再按命令表选 operation。
+3. 人事档案、考勤、薪酬等非日报意图 → 不属于本模块。
+
+## 高优先级语义
+
+- 业务对象：工作日报（blog）。别名：日报、工作日报、日志、补交、催交。
+- **查指定个人**只能用 `blog.query_user`（按天扫描，区间上限 62 天）；不要尝试按 userId 列表批量查个人——服务端会忽略该过滤并静默返回当前登录人自己的日报。
+- **查群体**（直接下属 / 间接下属 / 全部下属 / 我关注的人）用 `blog.query` 的 `user_type`。
+- 补交状态由 CLI 按「提交时间 vs 日报日期是否同日」判定，输出为 `正常` / `补交` / `未提交`，不要使用其它口径。
+- 提醒默认文案固定为「请填写 YYYY年 M月 D日 的日报！」，日期与输入 `date` 一致。
+- HRM 解析人员取 `user_id`；姓名同名多命中时 CLI 会报错并列出候选，改用 `user_id` 指定。
+
+## 命令表
+
+| 用户意图 | operation | reference |
+| --- | --- | --- |
+| 查群体日报（下属 / 我关注的人） | `blog.query` | [blog-query.md](references/blog-query.md) |
+| 查某人某天 / 某段日报 | `blog.query_user` | [blog-query-user.md](references/blog-query-user.md) |
+| 按姓名解析 userId | `blog.resolve_users` | [blog-resolve-users.md](references/blog-resolve-users.md) |
+| 查某条日报的评论 | `blog.comments` | [blog-comments.md](references/blog-comments.md) |
+| 查某日期默认共享对象 | `blog.default_permission` | [blog-default-permission.md](references/blog-default-permission.md) |
+| 导出日报为 xlsx | `blog.export` | [blog-export.md](references/blog-export.md) |
+| 发布日报 | `blog.publish.prepare` → `blog.publish.apply` | [blog-publish.md](references/blog-publish.md) |
+| 编辑指定日期日报 | `blog.edit.prepare` → `blog.edit.apply` | [blog-edit.md](references/blog-edit.md) |
+| 评论指定日报 | `blog.comment.prepare` → `blog.comment.apply` | [blog-comment.md](references/blog-comment.md) |
+| 点赞 / 取消点赞 | `blog.like.prepare` → `blog.like.apply` | [blog-like.md](references/blog-like.md) |
+| 提醒提交日报 | `blog.remind.prepare` → `blog.remind.apply` | [blog-remind.md](references/blog-remind.md) |
+| 暂未支持的能力 | — | [blog-disabled-capabilities.md](references/blog-disabled-capabilities.md) |
+
+统一 JSON 入口：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"myFollow","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"myFollow","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+## 处理链
+
+- **日报提交情况报表**：`blog.query`（user_type 按意图选择）→ 汇总 `submit_status` → 向用户输出按人统计表。未提交按人天取 `not_submitted[]`；`not_submitted_people[]` 是整窗完全没交的人（用于催交）。
+- **发布**：`blog.publish.prepare`（自动查当日是否已有日报、回填默认共享）→ 向用户复述日期与内容 → 用户确认 → `blog.publish.apply --yes`（CLI 回查验证）。
+- **编辑**：`blog.edit.prepare`（自动取原内容与差异）→ 复述原内容与新内容 → 用户确认 → `blog.edit.apply --yes`。
+- **评论 / 点赞**：`prepare` 定位目标日报（无日报即报错，不询问）→ 用户确认 → `apply --yes`。
+- **提醒**：`blog.remind.prepare`（解析被提醒人 + 默认文案）→ 复述人员与文案 → 用户确认 → `blog.remind.apply --yes`（逐人发送）。
+
+## 执行原则
+
+- 最小必要查询：先 `schema`，再按需读 reference；列表结果只保留任务所需字段，回复时给摘要与统计，不粘贴超长 JSON。
+- 业务输入只描述业务对象和意图；认证、Cookie、ETEAMSID、Token 全部由 CLI 托管，禁止出现在输入中。
+- 错误以 JSON envelope 的 `error.type/subtype` 驱动：`name_ambiguous` 列出候选后改用 user_id；`range_too_large` 缩小区间；`output_exists` 换输出路径。
+- 导出属于本地文件写入：`output` 指向已存在文件时 CLI 拒绝覆盖。
+
+## 写操作失败决策树
+
+1. `confirmation.required` → 向用户复述 prepare 返回的目标、差异与文案，取得明确确认后带 `confirm=true` 重调 apply；不要伪造 continuation。
+2. `target_changed` / `publish_already_exists` → 重新 prepare，再向用户确认。
+3. `partial/write_uncertain` → 停止，不做任何写重试；用 `blog.query_user` 只读回查后向用户报告。
+4. `authentication/session_expired` → 按 shared 规则先向用户确认 E10 登录域名，再引导登录。
+
+## 不在范围
+
+- 禁止绕过 CLI 直接 `curl`/`fetch` E10 日报接口，禁止读取或拼装 Cookie、ETEAMSID。
+- 按 userId 列表批量查个人日报未暴露（服务端忽略该过滤，详见 disabled-capabilities）。
+- EB 日报应用接口族（ebuilder / secondev）未暴露；当前租户未启用 EB 日报应用。
+- 删除日报、撤销已发送提醒未提供。

package/skills/weaver-e10-blog/references/blog-comment.md

@@ -0,0 +1,51 @@
+# 评论日报（blog.comment prepare -> apply）
+
+## 何时使用
+
+对某条日报发表评论。目标日报必须存在：`prepare` 阶段按「blog_id」或「日期 + 人员」自动定位，找不到即报错（不询问、不猜测）。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| blog_id | 与 date 二选一 | 日报记录 id |
+| date | 与 blog_id 二选一 | 日报归属日期，配合 user_id / name 定位 |
+| user_id / name | 否（二选一） | 目标人员；都缺省时定位当前登录人当天日报 |
+| content | 是 | 评论内容 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.comment.prepare --input-json '{"name":"PLACEHOLDER_NAME","date":"2026-08-18","content":"辛苦了，已核对。"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.comment.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.comment.prepare --input-json '{"date":"2026-08-18","content":"辛苦了，已核对。"}'
+weaver-work-cli --json blog run blog.comment.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回目标日报摘要（`target_content_text`）与评论内容、continuation。
+2. 向用户复述目标日报与评论内容，确认后调 apply。
+3. apply 通过评论列表回查验证，返回 `comment_id`。
+
+## 注意
+
+- 评论对目标日报的可见人群可见；发送前必须确认内容。
+- 目标日期无日报时报 `target_missing`，如实向用户报告「对应日期 X 人员 X 无日报，无法评论」。
+
+## 失败处理
+
+- `target_missing` / `name_ambiguous` / `name_not_found`：按错误详情处理。
+- `partial/write_uncertain`：停止重试，用 `blog.comments` 回查后报告。

package/skills/weaver-e10-blog/references/blog-comments.md

@@ -0,0 +1,39 @@
+# 评论查询（blog.comments）
+
+## 何时使用
+
+查看某条日报下已有的评论列表（分页）。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| blog_id | 是 | 日报记录 id |
+| page_no / page_size | 否 | 默认 1 / 20，page_size 上限 100 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.comments --input-json '{"blog_id":"1000000000000000001"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.comments --input-json '{"blog_id":"1000000000000000001","page_size":50}'
+```
+
+## 输出处理
+
+- `total_count`：评论总数；`comments[]` 含评论人（`commentor.name`）、`content`、`create_time`。
+- 需要目标日报 id 但只知道「人 + 日期」时，用 `blog.comment.prepare`（内部自动定位）。
+
+## 注意
+
+- 只读操作，无需确认。
+
+## 失败处理
+
+- `business_error`：透出服务端 message，检查 blog_id 是否有效。

package/skills/weaver-e10-blog/references/blog-default-permission.md

@@ -0,0 +1,38 @@
+# 默认共享查询（blog.default_permission）
+
+## 何时使用
+
+发布前想确认某日期会共享给哪些对象；一般无需单独调用——`blog.publish.prepare` 默认自动回填默认共享（`share_default=true`）。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| date | 是 | 日报归属日期 `YYYY-MM-DD` |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.default_permission --input-json '{"date":"2026-09-17"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.default_permission --input-json '{"date":"2026-09-17"}'
+```
+
+## 输出处理
+
+- `list[]`：默认共享对象数组（`obj_id` 展示名、`_entityType` 类型等）。
+- `list` 为空表示该日期无默认共享。
+
+## 注意
+
+- 只读操作，无需确认。
+
+## 失败处理
+
+- `business_error`：透出服务端 message。

package/skills/weaver-e10-blog/references/blog-disabled-capabilities.md

@@ -0,0 +1,11 @@
+# 暂未暴露的能力（处理边界）
+
+以下能力在源资料中存在或被提及，但 CLI 未暴露对应 operation。用户提出时如实说明并停止，不要绕过 CLI 构造请求。
+
+| 能力 | 原因 | 建议话术 |
+| --- | --- | --- |
+| 按 userId 列表批量查个人日报 | 服务端忽略该过滤（`filter.userIds`/`empIds`/`userId`/`creator`），恒定返回登录人自己的日报且不报错，会造成「查 A 得到 B」的静默错误 | 「按人查请逐人查询，我用 query_user 按天扫描」 |
+| `unRead` 时间段查询 | 该接口在当前租户三种请求形态实测恒返回空列表 | 「统一改用群体查询或单人查询」 |
+| EB 日报应用接口族（查询/发布/编辑/删除） | 依赖租户启用 EB 日报应用；当前租户未启用，接口族与标准日报完全不同且启用状态需逐租户探测 | 「当前环境使用标准日报接口，能力一致」 |
+| 删除日报 / 撤回已发送提醒 | 源资料未提供可靠接口 | 「暂不支持，请在客户端手动处理」 |
+| 附件上传 / @ 提醒 | 源资料未给出经过验证的完整契约 | 「暂不支持」 |

package/skills/weaver-e10-blog/references/blog-edit.md

@@ -0,0 +1,51 @@
+# 编辑日报（blog.edit prepare -> apply）
+
+## 何时使用
+
+修改已存在的日报正文（自己的或有权操作的目标人员日报）。目标当天无日报时报错，应改用发布。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_id / name | 否（二选一） | 目标人员；都不传时编辑当前登录人的日报 |
+| date | 是 | 日报归属日期 |
+| content | 是 | 新正文；纯文本自动包裹 `<p>` |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.edit.prepare --input-json '{"date":"2026-09-17","content":"修正后的日报内容。"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.edit.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.edit.prepare --input-json '{"user_id":"1000000000000000001","date":"2026-08-18","content":"<p>修正后的日报内容。</p>"}'
+weaver-work-cli --json blog run blog.edit.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回原内容（`original.content_text`）与新内容、差异摘要和 continuation。
+2. 向用户复述原内容与新内容，取得明确确认后调 apply。
+3. apply 回查验证内容已更新，返回 `updated=true, verified=true`。
+
+## 注意
+
+- 编辑覆盖整篇正文，不是追加；确认时让用户看清原内容。
+- 内容与新内容相同时 prepare 报 `changes_noop`。
+
+## 失败处理
+
+- `edit_target_missing`：目标当天无日报，建议改用发布。
+- `target_changed`：确认期间日报被修改，重新 prepare。
+- `partial/write_uncertain`：停止重试，用 `blog.query_user` 回查后报告。

package/skills/weaver-e10-blog/references/blog-export.md

@@ -0,0 +1,42 @@
+# 日报导出（blog.export）
+
+## 何时使用
+
+把日期段内的日报导出为本地 `.xlsx` 文件。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| start_date / end_date | 是 | 日期范围（含边界） |
+| output | 是 | 本地输出路径，必须是 `.xlsx` 文件；已存在时 CLI 拒绝覆盖 |
+| page_size | 否 | 默认 200 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.export --input-json '{"start_date":"2026-08-01","end_date":"2026-08-31","output":"C:\\tmp\\blog-2026-08.xlsx"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.export --input-json '{"start_date":"2026-08-01","end_date":"2026-08-31","output":"/tmp/blog-2026-08.xlsx"}'
+```
+
+## 输出处理
+
+- `output`：落盘路径；`bytes`：文件大小。
+- 导出范围为当前账号**有权限查看的全部日报**（不限于本人）；xlsx 第一行是标题，第二行是表头（姓名 / 部门 / 日报日期 / 提交状态 / 日报提交时间 / 是否隐藏 / 日报内容）。
+
+## 注意
+
+- 这是本地文件写入：`output_exists` 时换路径或先征得用户同意移除旧文件，不要静默覆盖。
+- 导出的日报内容会进入本地文件；如需把文件内容发给外部服务或进入大模型上下文，先向用户确认。
+
+## 失败处理
+
+- `output_parent_missing` / `output_parent_invalid`：先创建输出目录。
+- `export_failed`：服务端返回了非 xlsx 内容，错误详情带响应预览，向用户报告。

package/skills/weaver-e10-blog/references/blog-like.md

@@ -0,0 +1,50 @@
+# 点赞 / 取消点赞（blog.like prepare -> apply）
+
+## 何时使用
+
+对某条日报点赞或取消点赞。目标日报必须存在，`prepare` 阶段自动定位。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| blog_id | 与 date 二选一 | 日报记录 id |
+| date | 与 blog_id 二选一 | 日报归属日期，配合 user_id / name 定位 |
+| user_id / name | 否（二选一） | 目标人员；都缺省时定位当前登录人当天日报 |
+| cancel | 否 | 默认 false=点赞（vote）；true=取消点赞（cancelVote） |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.like.prepare --input-json '{"name":"PLACEHOLDER_NAME","date":"2026-08-18"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.like.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.like.prepare --input-json '{"date":"2026-08-18","cancel":true}'
+weaver-work-cli --json blog run blog.like.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+- `action`：`vote` / `cancelVote`；`receipt` 是服务端回执文案（如「点赞成功!」）。
+- 点赞状态没有只读回查接口，动作是否生效以业务码为准（`verified=false` 属预期，不是失败）。
+
+## 注意
+
+- 目标日期无日报时报 `target_missing`，如实报告「对应日报不存在，无法点赞」。
+- 不要为了「确认生效」而重复发送同一动作。
+
+## 失败处理
+
+- `target_missing`：报告目标不存在。
+- `business_error`：透出服务端 message。

package/skills/weaver-e10-blog/references/blog-publish.md

@@ -0,0 +1,52 @@
+# 发布日报（blog.publish prepare -> apply）
+
+## 何时使用
+
+为当前登录人新建指定日期的日报。只能发布自己的日报；当天已有日报时 prepare 会直接报错（防重复提交），应改用 blog.edit。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| date | 是 | 日报归属日期 `YYYY-MM-DD` |
+| content | 是 | 正文；纯文本自动包裹 `<p>`，HTML 原样保留 |
+| share_default | 否 | 默认 true：自动回填该日期默认共享对象；false 表示仅自己可见 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.publish.prepare --input-json '{"date":"2026-09-17","content":"今日完成：接口联调；明日计划：冒烟测试。"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.publish.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.publish.prepare --input-json '{"date":"2026-09-17","content":"今日完成：接口联调；明日计划：冒烟测试。"}'
+weaver-work-cli --json blog run blog.publish.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回 `status=AWAITING_CONFIRMATION`、日期、内容与 continuation（10 分钟有效）。
+2. 向用户复述日期与内容，取得明确确认（如「确认发布」）后才能调 apply。
+3. apply 内部回查验证：返回 `blog_id` 与 `submit_status`（当天补交属正常现象）。
+
+## 注意
+
+- 日报正文会进入业务系统并对共享对象可见；发布前必须逐字确认内容来自用户。
+- continuation 由 CLI 签发，禁止手工构造或复用过期 token。
+
+## 失败处理
+
+- `publish_already_exists`：当天已有日报，向用户说明并建议改用编辑。
+- `target_changed`：确认期间出现了日报，重新 prepare。
+- `confirmation.required`：未带 `confirm=true`。
+- `partial/write_uncertain`：停止重试，用 `blog.query_user` 回查后报告。

package/skills/weaver-e10-blog/references/blog-query-user.md

@@ -0,0 +1,45 @@
+# 单人日报查询（blog.query_user）
+
+## 何时使用
+
+查「某一个具体的人」某天或某段时间的日报详情，以及判断某人某天是否提交。这是按人查询的唯一路径——群体接口的按 userId 过滤会被服务端忽略并静默返回登录人自己的日报，禁止使用。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_id / name | 否 | 目标人员 userId 或姓名（姓名经 HRM 精确解析，同名多命中报错）；**两者都不传时默认查当前登录人**，是「查我自己的日报」的唯一路径 |
+| date | 是 | 起始日期 `YYYY-MM-DD` |
+| end_date | 否 | 结束日期（含）；缺省只查当天。区间按天逐日扫描，上限 62 天 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.query_user --input-json '{"name":"PLACEHOLDER_NAME","date":"2026-08-18"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.query_user --input-json '{"user_id":"1000000000000000001","date":"2026-08-15","end_date":"2026-08-20"}'
+```
+
+## 输出处理
+
+- `items[]`：每天一条，`date` 为 `YYYY-MM-DD`；`found=true` 表示当天有日报，`blog.content_text` 是去标签正文，`blog.create_time_str` 是实际提交时间。
+- `items[].submit_status`：`正常` / `补交` / `未提交`（无日报的天为 `未提交`），与 `blog.query` 口径一致。
+- `submitted_days` / `normal_days` / `later_days` / `missing_days`：区间内的已提交、正常、补交、未提交天数汇总，可直接用于按人报表。
+- 编辑 / 评论 / 点赞前的目标定位也可以直接用对应的 prepare 操作（内部同样按此接口解析），无需先手动查 id。
+
+## 注意
+
+- 区间上限 62 天；查询跨月报表时按月分段调用。
+- `blog.hasData` 字段不可靠，是否提交以 `found` 为准（CLI 已归一化）。
+
+## 失败处理
+
+- `name_not_found`：请用户确认姓名或改传 user_id。
+- `name_ambiguous`：报错里带 `candidates[]`，让用户挑选后改传 user_id。
+- `range_too_large`：缩小日期范围。

package/skills/weaver-e10-blog/references/blog-query.md

@@ -0,0 +1,49 @@
+# 群体日报查询（blog.query）
+
+## 何时使用
+
+查「一群人」某天 / 某段时间的日报提交情况：直接下属、间接下属、全部下属、我关注的人。按人查单个目标改用 `blog.query_user`。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_type | 是 | `directSubordinate`（直接下属）/ `indirectSubordinate`（间接下属）/ `allSubordinate`（全部下属）/ `myFollow`（我关注的人） |
+| start_date / end_date | 是 | `YYYY-MM-DD`，含边界 |
+| keywords | 否 | 内容关键字服务端过滤，可传空串 |
+| page_size | 否 | 默认 300（上限 300）。服务端返回行数 ≈ 人数 × 天数，窗口大时务必保持默认值 |
+| page_no | 否 | 默认 1。服务端实测**忽略** pageNo，调大不会拿到更多数据，不要靠翻页取数 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"directSubordinate","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.query --input-json '{"user_type":"myFollow","start_date":"2026-09-14","end_date":"2026-09-16"}'
+```
+
+## 输出处理
+
+- `items[]`：每人每天一行，含 `date`（`YYYY-MM-DD`）、`username`、`submit_status`、`blog`（未提交时为 `null`）。
+- `submit_status`：`正常` / `补交` / `未提交`（CLI 按「提交时间 vs 日报日期是否同日」判定，不要用原始 later 字段）。
+- `not_submitted[]`：未提交的**人天**列表 `{date, user_id, username}`；同一人只缺个别日期也会列出，可直接用于催交。
+- `not_submitted_people[]`：整个窗口内一条日报都没有的人（「完全没交」名单）；`missing_count` 是未提交人天数。
+- `submitted_count` / `people`：统计与人员清单。
+- `_note` 出现时说明**单页 300 行已顶满、窗口更早的部分没取到**（服务端忽略 pageNo，无法翻页）。此时不要重试或调大 page_no；应缩小日期范围或减少人员范围后重查，并向用户说明只覆盖到哪个日期。
+
+## 注意
+
+- 返回较大时只向用户呈现统计摘要和异常行，不粘贴全部 items。
+- 查「我关注的人」是合法的 user_type；不要尝试其它写法（follow、myAttention 等）。
+
+## 失败处理
+
+- `range_too_large`：缩小区间（`start_date` 到 `end_date` 按天计数，**上限 62 天**，与 `blog.query_user` 口径一致）。
+- `session_expired`：按 shared 规则确认登录域名后重新登录。
+- 返回 0 条：如实告知该范围无数据，不要自动换 user_type 重试。