feat: 新增企业微信助手 Agent，并修正 wecom-cli 条目 ref 漂移 (#112)

## 概述 / Overview

两件事：新增「企业微信助手」Agent（自带 15 个技能），并修正 `wecom-cli` 条目钉在 6 月快照的 ref 漂移。

Two changes: adds the **WeCom Assistant** agent (bundling 15 skills),
and fixes the `wecom-cli` entry whose pinned ref was stuck on a June
snapshot.

## 1. 新增企业微信助手 Agent

覆盖企业微信 **14 类服务、95
个方法**：消息、群聊历史、通讯录、日程、会议、待办、邮件、在线文档、在线表格、智能表格、智能文档、文档管理、微盘、媒体文件。

**采用内联形态 + 自带私有技能**：Agent 安装对 `agents/<id>/` 整目录递归复制且 `skills/`
不在排除集合里，因此装 Agent 即带全部技能，用户无需再单独获取技能合集。

### 技能集（15 个，约 5000 行）

- 基于上游 [wecom-cli](https://github.com/WecomTeam/wecom-cli) 官方
Skill（MIT，© WecomTeam）改写，每个技能末尾保留归属声明
- **新增 `wecom-chat`**：补齐上游零覆盖的群聊历史读取
- 补齐上游未覆盖的 `message.send`、`doc.create`，方法覆盖达 **95/95**
- 修正上游三处文档漂移：邮件能力描述与实际相反、会议室参数名已过时、`title_highlight` 字段不存在

### 相对上游的核心增量：风险治理

- 26 个对外可见或不可逆的方法逐个写明**执行前确认要求**
- 4 个条件升级方法给出**参数级判据**，而非按方法名一刀切
- 文档权限扩散两项加重处理，涉及**企业外可见**时单独再确认一次
- 内部标识禁止外露，不因用户索要而放宽
- 拒绝导出可识别到具体自然人的隐私字段

### 三条真机实测得出、上游未覆盖的硬约束

1. 机器人**只能写入/修改自己创建的数据**，真人创建的只能读
2. 每次响应携带的 `extra_identity_context` **禁止透露给用户**
3. 权限错误（`850002`/`851008`/`853006`）**不得重试**，须将 `help_message`
**逐字原样**转给用户

## 2. 修正 wecom-cli 条目 ref 漂移

`source.ref` 原钉在 2026-06-28 的 `72e14f7`，该快照只有 7
个子技能且用已废弃的旧命名（`msg`/`schedule`）。上游 v1.2.0 已扩展到 **14 个**技能。按旧 ref
安装的用户拿到的是三个月前的快照。

- `source.ref` → `78c514b2afee7c0d3d7be715628478421f37ee63`
- `children` 由 `scripts/gen-collection-children.py` 重新生成，**7 → 14**
- sidecar 同步 `provenance.content.ref`、`childCount` 与 `children`

## 验证 / Verification

**静态**
- 215 条示例命令追加 `--dry-run` 实跑，**215/215 退出码 0**
- 未知方法 0、未知参数 0、`--json` 未知字段 0、枚举违规 0
- 15 个 `SKILL.md` 的 frontmatter 经客户端 `skillFrontmatterSchema` 校验全部通过
- `validate_catalog_metadata.py --require-complete` 与
`gen-collection-children.py`：**0 error**

**真机（在真实企业微信账号上端到端）**
- **待办域 6/6 方法全通**（含 2 个 write-high），`items` 必填的隐蔽坑实测证实
- **日程域 5 个方法全通**（含 3 个 write-high）
- 消息发送、通讯录解析、微盘列表、邮件搜索、文档搜索、会议列表、智能表格创建均已实测通过
- 测试数据已全部清理，未污染真实账号

**尚未实测**：群聊历史（机器人未开通该品类）。相关文档已明确标注验证状态，未实测的能力不写「实际效果」段落。

agents/wecom-assistant/docs/01-快速开始.md

@@ -0,0 +1,112 @@
+# 快速开始
+
+从零到第一次对话，一共三步：装好命令行工具、扫码授权一次、开口说话。
+整个环境只需要授权一次，之后每次对话直接说事就行。
+
+## 你需要准备
+
+| 项 | 要求 |
+|---|---|
+| Node.js | 18 或更高版本 |
+| 企业微信 | 一个能扫码的企业微信账号（手机上装着企业微信即可） |
+| 网络 | 能访问企业微信服务；查帮助文档也需要联网 |
+
+## 第一步：让助手检查环境
+
+直接开口问它就行，它会自己跑前置检查：
+
+> 「企业微信接一下」
+> 「帮我看看企微能不能用」
+
+助手会依次确认三件事：命令行工具装了没、版本够不够、有没有授权。任何一步不通过，它会停下来告诉你卡在哪，
+**不会带着半个环境硬往下做**。
+
+工具没装或版本太低时，它会提示安装：
+
+```bash
+npm install -g @wecom/cli
+```
+
+装完再让它检查一次。
+
+> **实测**：界面里让助手接入企业微信时，它的执行顺序是「查版本 → 查授权状态 → 引导授权」，
+> 三步都正确，没有编造不存在的命令。
+
+## 第二步：扫码授权（只做一次）
+
+没授权时，助手会引导你完成授权。它会打印一个授权链接和二维码，**你用企业微信扫一下**，
+授权就完成了（等待时间上限 5 分钟）。
+
+- 二维码在终端里显示不出来时，可以让助手把二维码存成图片文件再给你看。
+- 授权成功后助手会再查一次状态，**只有确认是「已授权」才会继续做事**。
+
+**关于「登录」**：企业微信的命令行工具没有 `login` 这个命令，授权靠的是「初始化」这一步。
+你不必记这些——但如果看到助手或别处的文档提到 `wecom-cli auth login`，那是不存在的写法。
+
+> **实测**：授权信息以「机器人 + 授权真人」两重身份存在。实测账号里，机器人代表真人（王轶）工作；
+> 它创建的待办，创建人显示的是**机器人身份**，不是你本人。这一点后面会反复影响你能改什么、不能改什么。
+
+## 第三步：第一次对话
+
+授权完就可以直接说事了。几个安全的起手式（都是纯读取，不会改任何东西）：
+
+> 「我今天有什么安排？」
+> 「我有哪些待办？」
+> 「我最近有哪些会？」
+> 「微盘里最近有什么文件？」
+> 「张三是谁？」
+
+想试写入的话，从**只影响你自己**的动作开始：
+
+> 「帮我记个待办：明天下午三点前把周报发出去」
+
+助手会创建这条待办，并回显标题、参与人、截止时间。你在企业微信的待办里就能看到它。
+这条只给你自己记，不分派给别人，所以助手会直接执行、不会追问。
+
+**一旦涉及别人，行为就变了**：分派给同事、发消息、发邮件、改文档权限——助手会先把「对谁、做什么、
+内容是什么」复述一遍，等你明确同意。详见 [99 风险与确认](99-风险与确认.md)。
+
+## 第一次就会遇到的三件事
+
+**1. 有些能力要单独开通。**
+企业微信的机器人权限**按品类逐项开通**：通讯录是一项，文档是一项，微盘、会议、邮件、群聊各是一项。
+没开通的品类，助手第一次调用就会被拒，它会把企业微信官方的开通指引**原样转给你**（包含链接，
+一字不改），然后停下来。**它不会反复重试，也不会换个方法绕过去**——那是权限问题，重试没用。
+
+实测账号最初只开了基础品类，后来才补齐了通讯录、文档、微盘、会议、邮件；
+**群聊会话品类始终没开通**，所以 [04 群聊历史](04-群聊历史.md) 的能力完全没验过。
+
+**2. 它只能改「它自己建的」东西。**
+读是全的，写是窄的。你自己在企业微信里建的文档、日程、待办，助手**改不了**。
+它会说明这条边界，然后给替代方案（「我另建一份」/「这个得你在客户端改」），而不是反复重试到失败。
+
+**3. 它不给你看内部编号。**
+成员编号、会话编号、文档编号这些内部标识只在它自己的调用链里流转，回复里一律用姓名、群名、文档标题。
+你主动要也不会给——但它会换个方式帮你把事办成。文档链接、微盘分享链接这类**可点击的链接是可以给的**。
+
+## 常见起步问题
+
+| 现象 | 多半是什么 |
+|---|---|
+| 助手说命令不存在 | 工具没装，或没装成全局。执行 `npm install -g @wecom/cli` |
+| 助手说版本太低 | 需要 1.2.0 及以上，重新安装即可 |
+| 扫码后仍显示未授权 | 授权没走完（超时或中途退出），让助手重新引导一次 |
+| 某类事情一直做不了，助手贴了一段官方指引 | 该品类未开通，按那段指引去开通。**别让助手重试** |
+| 助手说「这份是你自己建的，我改不了」 | 正常边界，见上文第 2 条 |
+| 查帮助也失败 | 查帮助本身需要联网（不需要授权）。离线机器上连帮助都查不了 |
+
+## 下一步
+
+- 想知道每类事情怎么说：回 [README 的「按能力查」](README.md#按能力查)
+- 想知道什么时候会被问一句：看 [99 风险与确认](99-风险与确认.md)
+- 想从最稳的能力开始用：[07 待办](07-待办.md) 和 [05 日程](05-日程.md) 是实测覆盖最完整的两个
+
+## 📋 验证状态
+
+| 项 | 状态 |
+|---|---|
+| 环境检查与授权引导（界面内，模拟真人） | ✅ 已实测：执行顺序为「查版本 → 查授权状态 → 引导授权」，未编造不存在的命令 |
+| 首次扫码授权 | ✅ 已实测：实测账号于 2026-08-31 完成扫码授权，后续补齐了通讯录 / 文档 / 微盘 / 会议 / 邮件品类 |
+| 助手能被正常创建并对话 | ✅ 已实测：人格与原则文件逐字节完整加载，15 个技能全部被发现，会话可用、自动问候正常 |
+| 「你说一句话 → 助手真的执行完」的完整链路 | ⚠️ **未实测**。本机内存不足导致实例反复启动失败，界面里的 AI 审批也未配置（自动审批被拒），端到端跑不通 |
+| 群聊会话品类的授权 | ❌ 未开通，未实测 |