weaver-work-cli 0.1.8 → 0.1.21

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

@@ -0,0 +1,51 @@
+# 提醒提交日报（blog.remind prepare -> apply）
+
+## 何时使用
+
+向指定人员发送「请填写日报」提醒消息。多人时逐人发送。
+
+## 输入要点（prepare）
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| user_ids / names | 二选一 | 被提醒人列表（userId 数组、逗号分隔串或姓名数组，最多 50 人） |
+| date | 是 | 日报归属日期，用于默认文案与年份 |
+| content | 否 | 自定义文案；缺省生成「请填写 YYYY年 M月 D日 的日报！」 |
+| year | 否 | 日报所属年份；缺省从 date 推断 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.remind.prepare --input-json '{"names":["PLACEHOLDER_NAME"],"date":"2026-08-19"}'
+```
+
+用户确认后：
+
+```powershell
+weaver-work-cli --json blog run blog.remind.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.remind.prepare --input-json '{"user_ids":"1000000000000000001","date":"2026-08-19"}'
+weaver-work-cli --json blog run blog.remind.apply --input-json '{"continuation":"<prepare 返回的 continuation>","confirm":true}'
+```
+
+## 输出处理
+
+1. prepare 返回被提醒人清单（`user_id` + 解析出的姓名）、文案与年份、continuation。
+2. 向用户复述目标人员与文案，取得明确确认后调 apply。
+3. apply 逐人发送；`succeeded[]` / `failed[]` 分别列出结果；status 为 `PARTIAL` 时如实报告失败名单。
+
+## 注意
+
+- 默认文案固定以「请填写」开头且包含与 `date` 一致的日期；自定义文案必须包含具体日期。
+- 提醒是推给真人的消息，发送前必须逐项确认人名与文案。
+
+## 失败处理
+
+- `name_not_found` / `name_ambiguous`：修正名单后重新 prepare。
+- `partial/write_uncertain`：已发送部分不重发；向用户报告成功与失败名单，失败者确认后重新 prepare。

package/skills/weaver-e10-blog/references/blog-resolve-users.md

@@ -0,0 +1,38 @@
+# HRM 姓名解析（blog.resolve_users）
+
+## 何时使用
+
+用户只给了姓名而没有 userId，且后续需要跨多次调用复用 userId（如先查日报再提醒）时，先解析一次。
+
+## 输入要点
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| name | 是 | 员工姓名，精确匹配 |
+
+## 命令
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json blog run blog.resolve_users --input-json '{"name":"PLACEHOLDER_NAME"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json blog run blog.resolve_users --input-json '{"name":"PLACEHOLDER_NAME"}'
+```
+
+## 输出处理
+
+- `matched`：命中人数；`users[]` 含 `user_id` / `name` / `department`。
+- 多命中时向用户列出候选让其选择，不要自行挑第一个。
+
+## 注意
+
+- 单次查询类操作（query_user、remind.prepare）内部已支持直接传 `name`，无需先解析。
+
+## 失败处理
+
+- `matched=0`：如实告知未找到该员工，请用户确认姓名。