weaver-work-cli 0.1.7 → 0.1.20

package/docs/operation-manual.md

@@ -113,16 +113,16 @@ weaver-work-cli --profile PROFILE_NAME auth status
 
 ## 5. 安装已有业务模块 Skill
 
-### 5.1 安装到 Codex 默认目录
+### 5.1 安装到当前 Agent
 
 ```text
 weaver-work-cli skills install yepiaotong
 weaver-work-cli skills install wenshuding
 ```
 
-默认目标目录优先使用环境变量 `CODEX_HOME` 下的 `skills` 子目录；未设置 `CODEX_HOME` 时使用用户主目录下的 `.codex/skills`（Windows PowerShell 示例：`$env:USERPROFILE\.codex\skills`）。安装非 shared 业务 Skill 时，CLI 会自动带上 `weaver-e10-shared`。
+CLI 优先使用 `--target-dir` 或通用环境变量 `WEAVER_SKILLS_ROOT`。未显式指定时，会根据当前进程的 Codex/WorkBuddy 环境信号选择当前用户的 skills 目录；如果宿主不明确、存在多个候选目录，或者当前为其它 Agent 且未提供路径，则停止安装并要求显式指定，避免装错位置。安装非 shared 业务 Skill 时，CLI 会自动带上 `weaver-e10-shared`。
 
-### 5.2 安装到 WorkBuddy 或其它 Agent
+### 5.2 显式安装到 WorkBuddy 或其它 Agent
 
 Windows PowerShell：
 
@@ -152,6 +152,18 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli skills install MODULE_NAME --target-dir "/path/to/agent-skills"
 ```
 
+经常使用同一 Agent 时，也可以设置通用目录环境变量：
+
+```powershell
+$env:WEAVER_SKILLS_ROOT = "$env:USERPROFILE\.other-agent\skills"
+weaver-work-cli skills install MODULE_NAME
+```
+
+```bash
+export WEAVER_SKILLS_ROOT="$HOME/.other-agent/skills"
+weaver-work-cli skills install MODULE_NAME
+```
+
 `<module>` 可以传短名，例如 `yepiaotong`、`wenshuding`、`skill-maker`，也可以传完整名，例如 `weaver-e10-yepiaotong`。传 `all` 会安装包内全部 Skill。
 
 ### 5.3 验证安装结果

package/docs/skill-review-2026-09-19.md

@@ -38,13 +38,13 @@
 | 13 | jucailin「三个子系统」与实际列出的四个业务域矛盾 | 改为「四个子系统（人事档案/出勤/薪酬/招聘）」 |
 | 14 | shared SKILL.md 存在整句重复；登录依赖表述与 CLI 现状（auth 托管）冲突 | 去重并与现状对齐 |
 | 15 | qiyecheng manifest 残留开发者个人路径 `/Users/zhufangyuan/...` | 脱敏为占位 |
-| 16 | connector 版依赖声明错误：`weaver-e10-login` 被错写成重复的 `weaver-e10-shared-connector` | 修正为 login + shared-connector |
+| 16 | connector 版依赖声明仍保留旧 login 兼容项 | 修正为 shared-connector |
 
 ## 四、规则遵从性（硬规则 / 门禁 BLOCK）
 
 | # | 问题 | 修复 |
 |---|---|---|
-| 17 | **7 个接口型 skill 未声明 `weaver-e10-login` 依赖，且未写明请求头三件套**（B10a / B10c，BLOCK） | jiuchuanhui / mail / meeting / okr / qiyecheng / skill-maker / workflow 全部补齐，统一新增「认证与请求头契约」章节 |
+| 17 | **7 个接口型 skill 未声明 `weaver-e10-shared` 依赖，且未写明请求头三件套**（B10a / B10c，BLOCK） | jiuchuanhui / mail / meeting / okr / qiyecheng / skill-maker / workflow 全部补齐，统一新增「认证与请求头契约」章节 |
 | 18 | plan description 246 字，超 200 字上限 | 压到 164 字，触发词保留 |
 | 19 | 改写登录红线时误触发 B10b（该规则无否定豁免，写成「禁止 Playwright/扫码…」也会被判违规） | 去掉敏感词枚举，改为不含触发词的表述 |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-work-cli",
-  "version": "0.1.7",
+  "version": "0.1.20",
   "description": "面向泛微工作工具链的可扩展 TypeScript CLI 基础框架（E10 业票通等能力）",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,4 +49,4 @@
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   }
-}
+}

package/scripts/package-skill.mjs

@@ -13,7 +13,6 @@ const skillTemplateRoot = path.join(repositoryRoot, 'skill-template')
 const productMetadataPath = path.join(skillTemplateRoot, 'product.json')
 const packageJsonPath = path.join(repositoryRoot, 'package.json')
 const sharedSkillName = 'weaver-e10-shared'
-const legacySharedSkillName = 'weaver-work-cli-shared'
 const skillPrefix = 'weaver-e10-'
 const legacySkillPrefix = 'weaver-work-cli-'
 const [requestedSkillArg, outputArg] = process.argv.slice(2)
@@ -77,6 +76,7 @@ function defaultOutput(skillNames) {
 function shouldSkip(entry, relativePath) {
   if (entry.name === '.DS_Store' || entry.name.startsWith('.')) return true
   if (relativePath === 'product.json') return true
+  if (relativePath === 'references/source-manifest.json') return true
   if (entry.isDirectory() && ['assets', 'node_modules', 'scripts'].includes(entry.name)) return true
   return false
 }
@@ -87,6 +87,31 @@ function assertSafeRelativePath(relativePath) {
   }
 }
 
+function assertSkillFrontmatter(skillName, content) {
+  const normalized = content.replace(/\r\n/g, '\n')
+  const lines = normalized.split('\n')
+  if (lines[0] !== '---') {
+    throw new Error(`${skillName}/SKILL.md 缺少 YAML frontmatter：文件必须以 --- 开头`)
+  }
+
+  const end = lines.indexOf('---', 1)
+  if (end < 0) {
+    throw new Error(`${skillName}/SKILL.md 缺少 YAML frontmatter 结束标记 ---`)
+  }
+
+  const frontmatter = lines.slice(1, end).join('\n')
+  const nameMatch = frontmatter.match(/^name:\s*["']?([^"'\n]+?)["']?\s*$/m)
+  if (!nameMatch) {
+    throw new Error(`${skillName}/SKILL.md 的 YAML frontmatter 缺少 name`)
+  }
+  if (nameMatch[1] !== skillName) {
+    throw new Error(`${skillName}/SKILL.md 的 frontmatter name 必须等于目录名 ${skillName}`)
+  }
+  if (!/^description:\s*\S/m.test(frontmatter)) {
+    throw new Error(`${skillName}/SKILL.md 的 YAML frontmatter 缺少 description`)
+  }
+}
+
 function crc32(buffer) {
   let crc = 0xffffffff
   for (const byte of buffer) {
@@ -184,11 +209,6 @@ async function createZipArchive(root, entries) {
   return Buffer.concat([...localParts, centralDirectory, end])
 }
 
-function rewriteSkillContent(skillName, relativePath, content) {
-  if (skillName !== legacySharedSkillName || relativePath !== 'SKILL.md') return content
-  return content.replace(/^name:\s*weaver-e10-shared\s*$/mu, `name: ${legacySharedSkillName}`)
-}
-
 async function loadProductMetadata() {
   const product = JSON.parse(await readFile(productMetadataPath, 'utf8'))
   const packageInfo = JSON.parse(await readFile(packageJsonPath, 'utf8'))
@@ -218,10 +238,11 @@ async function writeProductMetadata(packageRoot, packagedEntries, packageName, p
   packagedEntries.push(`${packageName}/product.json`)
 }
 
-async function copySkill(skillName, stagingRoot, packagedEntries, productMetadata, packageName = skillName) {
+async function copySkill(skillName, stagingRoot, packagedEntries, productMetadata) {
   const sourceRoot = path.join(skillsRoot, skillName)
-  const packageRoot = path.join(stagingRoot, packageName)
-  await stat(path.join(sourceRoot, 'SKILL.md'))
+  const packageRoot = path.join(stagingRoot, skillName)
+  const skillMarkdown = await readFile(path.join(sourceRoot, 'SKILL.md'), 'utf8')
+  assertSkillFrontmatter(skillName, skillMarkdown)
 
   async function copyDir(relativeDir = '') {
     const sourceDir = path.join(sourceRoot, relativeDir)
@@ -240,19 +261,14 @@ async function copySkill(skillName, stagingRoot, packagedEntries, productMetadat
         await copyDir(relativePath)
       } else if (entry.isFile()) {
         await mkdir(path.dirname(target), { recursive: true, mode: 0o700 })
-        if (packageName === skillName) {
-          await copyFile(source, target)
-        } else {
-          const content = await readFile(source, 'utf8')
-          await writeFile(target, rewriteSkillContent(packageName, relativePath, content))
-        }
-        packagedEntries.push(`${packageName}/${relativePath}`)
+        await copyFile(source, target)
+        packagedEntries.push(`${skillName}/${relativePath}`)
       }
     }
   }
 
   await copyDir()
-  await writeProductMetadata(packageRoot, packagedEntries, packageName, productMetadata)
+  await writeProductMetadata(packageRoot, packagedEntries, skillName, productMetadata)
 }
 
 const skillNames = await resolveSkillNames()
@@ -267,9 +283,6 @@ try {
   await mkdir(path.dirname(output), { recursive: true, mode: 0o700 })
   for (const skillName of skillNames) {
     await copySkill(skillName, stagingRoot, packagedEntries, productMetadata)
-    if (skillName === sharedSkillName) {
-      await copySkill(skillName, stagingRoot, packagedEntries, productMetadata, legacySharedSkillName)
-    }
   }
 
   await rm(output, { force: true })

package/skill-template/business-info.json

@@ -207,23 +207,26 @@
   ],
   "weaver-e10-ebuilder-form": [
     "eBuilder",
-    "ebuilder",
-    "EB表单",
-    "表单",
-    "数据列表",
-    "表格",
-    "列表数据",
+    "eBuilder表单",
+    "表单数据",
+    "表单查询",
+    "表单新增",
+    "表单修改",
+    "表单删除",
+    "eBuilder菜单",
     "菜单定位",
-    "字段定义",
+    "List列表",
+    "NList列表",
+    "表单字段",
     "浏览字段",
-    "人员字段",
-    "部门字段",
-    "表单数据",
-    "自定义接口",
+    "选项字段",
+    "主明细映射",
     "OpenAPI",
-    "新增表单数据",
-    "修改表单数据",
-    "删除表单数据"
+    "自定义接口",
+    "objId",
+    "interfacePk",
+    "表单分页",
+    "表单详情"
   ],
   "weaver-e10-shared": [
     "安装",
@@ -355,5 +358,101 @@
     "修改流程表单",
     "智能分组",
     "待办统计"
+  ],
+  "weaver-e10-blog": [
+    "日报",
+    "工作日报",
+    "写日报",
+    "查日报",
+    "提交日报",
+    "提交情况",
+    "补交",
+    "未提交",
+    "未交日报",
+    "催交",
+    "提醒交日报",
+    "日报提醒",
+    "下属日报",
+    "我关注的人",
+    "关注人员日报",
+    "日报评论",
+    "日报点赞",
+    "导出日报",
+    "日报报表",
+    "编辑日报",
+    "发布日报"
+  ],
+  "weaver-e10-caizhilian": [
+    "采知连",
+    "文档中心",
+    "知识库",
+    "公共知识库",
+    "个人知识库",
+    "虚拟知识库",
+    "在线文档",
+    "文档检索",
+    "文档搜索",
+    "建文档",
+    "新建文档",
+    "HTML 文档",
+    "Markdown 文档",
+    "Office 文档",
+    "上传建文档",
+    "文档详情",
+    "文档正文",
+    "替换正文",
+    "更新正文",
+    "修改文档字段",
+    "变更作者",
+    "文档作者",
+    "文件夹",
+    "虚拟文件夹",
+    "文件夹权限",
+    "文档权限",
+    "下载权限",
+    "默认共享",
+    "文档默认共享",
+    "标签",
+    "参与人",
+    "文档共享",
+    "共享设置",
+    "取消共享",
+    "附件",
+    "上传附件",
+    "替换附件",
+    "下载附件",
+    "附件转 PDF",
+    "封面",
+    "设置封面",
+    "移除封面",
+    "文档比对",
+    "比对链接",
+    "组织架构",
+    "人员检索",
+    "部门",
+    "子部门",
+    "岗位",
+    "角色",
+    "外部联系人",
+    "当前用户",
+    "系统健康检查",
+    "采知连接口连通性"
+  ],
+  "weaver-e10-jinchengda": [
+    "合同",
+    "合同管理",
+    "合同类型",
+    "合同模板",
+    "合同条款",
+    "条款引用",
+    "签约主体",
+    "合同审批",
+    "发起审批",
+    "保存审批",
+    "提交审批",
+    "催办",
+    "审批进度",
+    "审批意见",
+    "今承达"
   ]
 }

package/skill-template/domains/blog.md

@@ -0,0 +1,24 @@
+本业务域用于 E10 工作日报（blog）。入口 `SKILL.md` 按 weaver 风格组织：CRITICAL 共享前置、路由优先级、高优先级语义、逐 operation 命令表、处理链、执行原则、写操作失败决策树和「不在范围」。具体用法拆到 `references/`：
+
+- `blog-query.md`：群体日报查询（`user_type` 四档：直接/间接/全部下属、我关注的人），客户端窗口裁剪与 `not_submitted` 口径。
+- `blog-query-user.md`：单人日报逐日扫描（`detailsByDate`，区间上限 62 天），`submit_status` 判定与 62 天上限报错。
+- `blog-resolve-users.md`：HRM 按姓名精确解析 `user_id`（取 `id` 字段，不是 `userid`）。
+- `blog-comments.md`：查某条日报的评论列表。
+- `blog-default-permission.md`：查某日期的默认共享对象，供发布时回填 `permissionList`。
+- `blog-export.md`：导出日报报表为 xlsx，本地文件写入与拒绝覆盖策略。
+- `blog-publish.md`：发布日报的 `prepare -> apply` 写入协议（含写前查重与默认共享回填）。
+- `blog-edit.md`：编辑指定日期日报的 `prepare -> apply` 写入协议（含目标指纹校验）。
+- `blog-comment.md`：评论指定日报的 `prepare -> apply` 写入协议（含评论列表回查）。
+- `blog-like.md`：点赞与取消点赞的 `prepare -> apply` 写入协议。
+- `blog-remind.md`：提醒提交日报的 `prepare -> apply` 写入协议，默认文案与逐人发送语义。
+- `blog-disabled-capabilities.md`：按 userId 批量查个人、`unRead`、EB 日报接口族、删除、撤回提醒等未暴露能力的处理边界。
+
+Agent 调优重点：
+
+- `weaver-work-cli blog schema` 是 operation 合约第一信息源。
+- 查指定个人只能用 `blog.query_user`；`filter.userIds` 被服务端忽略，按 userId 列表查会静默返回登录人自己的日报。
+- 补交状态统一由 CLI 判定为 `正常` / `补交` / `未提交`，不使用服务端 `later` 字段口径。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；`apply` 一律要求 `confirm=true`。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求，先用 `blog.query_user` 只读回查。
+- 导出属于本地文件写入：`output` 指向已存在文件时 CLI 拒绝覆盖。

package/skill-template/domains/caizhilian.md

@@ -0,0 +1,22 @@
+本业务域用于 E10 采知连（文档中心 / 知识库）。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、登录与请求头凭证契约、路由优先级、高优先级语义、逐 operation 命令表、处理链、执行原则、写操作失败决策树和「不在范围」。具体用法拆到 `references/`：
+
+- `agent-entry.md`：schema / operations 入口、统一 `caizhilian run` 调用方式、`--input-json` 与 `--input <path>` 选择、成功与失败 envelope、完整错误码表。
+- `document.md`：文档检索、文档详情、当前登录人，以及 HTML / Markdown / Office / 批量上传四种建文档方式与四种编辑（基础字段、作者、保存正文、替换正文）。
+- `folder.md`：文件夹创建、虚拟文件夹检索、文件夹默认设置，以及默认共享与八类文档权限（含 `Premisstion` 源拼写与按权限反查）。
+- `collaboration.md`：标签（公共/个人）、参与人、文档共享的查询与增删，含 `share.add` 的「已存在」语义与 `share_entry_id` 用法。
+- `org-browser.md`：人员/部门/分部/外部人员/岗位/角色/客户/客户类型八类浏览器检索与当前登录人，用于把名称解析成 ID。
+- `files.md`：附件上传/替换/下载（含转 PDF）、封面上传/设置/移除、文档比对（检索、文件对象、上传、提交拿 `compare_link`）。
+- `write-protocol.md`：prepare → apply 四步链路、continuation 票据约束与全部票据类错误码、写结果不确定的决策树。
+- `withheld.md`：4 个不提供的系统操作（环境列表 / 配置快照 / 配置重载 / 环境切换）与源 Skill 范围外模块，以及源基础设施脚本的等价替换说明。
+
+Agent 调优重点：
+
+- `weaver-work-cli caizhilian schema` 是 operation、字段与风险等级的合约第一信息源；`caizhilian operations` 给出按资源分组的能力目录与 `withheldOperations`。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段；认证只走 `weaver-work-cli auth ...`。
+- ID 一律来自查询：`doc_id` 来自检索或详情，`folder_id` 来自 `folder.query-by-name`，人员与部门 ID 来自 `org.search-*`，权限与共享的合法取值来自 `*.form` / `*.list`。
+- 枚举拼写 1:1 沿用源接口，权限键是 `deletePremisstion` / `downloadPremisstion` / `newCreateDocPremisstion` / `newCreateFolderPremisstion`，不要「纠正」成 `Permission`。
+- 写操作只接受 CLI 生成的 continuation，不手工构造、不跨操作复用；apply 入参必须与 prepare 逐字一致，票据有效期 10 分钟。
+- 分页 `has_next` 按「本页条数 >= page_size」判定，服务端 `total` 不可信；列表默认小页，回复只给摘要。
+- 附件、封面图片、正文文件属于用户私有数据：上传下载前必须提醒文件可能进入大模型上下文并取得明确确认；文件内容不得读入上下文，只引用路径与元数据。
+- 上传与下载是长耗时操作（120 秒超时、下载上限 100MB），一次只跑一个，不并发批量传输。
+- 结果为 `partial/write_uncertain`、网络中断或回查不一致时停止，最多补一次只读回查，不自动重放写请求。

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 不能自行安装——必须先取得用户明确确认后再执行。用户确认后按顺序执行且仅执行一次：① 缺 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 不能自行安装——必须先取得用户明确确认后再执行。用户确认后按顺序执行且仅执行一次：① 缺 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 是否有效。