zxremail 飞书文档 Review
审别人写的飞书云文档。默认产出独立「评审意见」，不改源文档、不发飞书评论。
REQUIRED SUB-SKILL: 读文档用 lark-doc。认证 / scope 失败再读 lark-shared。
何时不用
| 用户意图 | 改走 |
|---|---|
| 改自己的飞书正文、插图、画板 | lark-doc |
| 主文档 + FAQ 答疑 | dual-doc-faq |
| 按飞书链接填成果说明四段 | ai-work-result-report |
| 代码 diff / PR / Bugbot | review-bugbot 等代码审查技能 |
硬规则
- 未 fetch 不评审。 禁止凭标题、记忆或对话摘要下结论。
- 不编造。 表、次数、截图、版本、外链内容以读到的为准；读不到就写「未见 / 无法复核」。
- 默认只读。 不
docs +update、不drive +add-comment。用户明确说「写回原文 / 发评论 / 贴到文档」才进入回写。 - 先找打架。 结论 vs 附录、表 vs 正文、图 vs 图注、主张 vs 证据，必须显式点出。
- 评文档，不重写文档。 指出问题与改法，不要另写一版正文冒充评审。
- 回复用简体中文。
| 借口 | 实际 |
|---|---|
| 「先总结再慢慢挑刺」 | 总结不是评审。先给总体判断和 P0。 |
| 「作者更熟，不宜质疑结论」 | 评审对象就是主张是否被证据撑住。 |
| 「没图/外链打不开就算了」 | 若结论依赖它，标「证据不可复核」并降级主张。 |
| 「帮忙把文档改好」 | 除非用户要求回写，否则只出评审意见。 |
| 「问题都是建议，不用分级」 | 必须有 P0/P1/P2，避免全是「建议完善」。 |
工作流
URL → fetch（大文档先 outline）→ 判类型 → 按书脊写评审 → 存 {topic}-review.md
1. 拿到源
- 用户给
/docx/或/wiki/URL（含doubao.com同类路径）。无链接则先问，不要审本地臆造稿冒充飞书评审。 - 配套参考（FRS / 前序文档）用户点名或源文档当作 closure 依据时，一并 fetch。
2. 读取
身份：--as user。命令细节以 lark-doc 的 +fetch 参考为准。
lark-cli docs +fetch --doc "<URL>" --as user --scope outline --max-depth 3
lark-cli docs +fetch --doc "<URL>" --as user --doc-format markdown
- 短文档可省略
outline，直接 markdown 全文。 - 长文档按目录
section分段读；结论 / 风险表 / 附录 / 变更日志优先读完。 - 记下
revision_id、标题。有可见评论时纳入「他人已提、本文未改」。 - 主张依赖截图 / 画板时，用
docs +media-preview（或下载）核对图文是否同一件事。 - 结论依赖
<synced_reference>或外链文档时，跟读最小必要范围。
3. 判类型，定检查重点
| 类型（可并存） | 重点 |
|---|---|
| 排查 / 压测 / 实验记录 | 矛盾、控制变量、样本与措辞（「概率下降」）、配置指纹、冷热启/对照是否单机 |
| 整机 / 模块技术方案 | 章节成熟度是否匀、数字自洽、风险表是否覆盖正文已暴露风险、选型有无验收门限 |
| 方案草稿 / 实现说明 | 图证是否撑住「已测通」、示例能否上产品、空章节、平台/范围是否写完 |
| 需求 / FRS / 设计 | 条目可测性、口径分叉、责任边界、与外链指标是否闭环 |
4. 写评审并落盘
按 template.md 填书脊。领域专节（结构 / 硬件 / Linux…）插在「总体评价」之后、「问题清单」前后均可，书脊七段不能缺。
保存到当前工作区：{英文短名}-review.md（kebab-case，如 nvme-reboot-drop-review.md）。文件名规则对齐 markdown-export 的英文连字符命名。
图表：默认不加。仅当成熟度分叉、选型决策或会后顺序需要一张图时用 Mermaid；节点换行用 <br>。不要为「丰富」硬加图。
5. 回复用户
聊天里给出：总体判断 + P0 列表 + 优先三件事 + 短摘要，并指出本地评审文件路径。全文不必再贴一遍，除非用户要直接粘贴。
分级与证据
P0 必须先改：内部矛盾、图文证伪、安全/不可上仪器、关键数字自洽失败、未完成却当基线。
P1 证据链弱、变量纠缠、归因过强、对照不足。
P2 结构、术语、空节、工程化缺口。
证据强度用：可复现 / 强 / 中 / 弱 / 无。把「方向对」和「已验证结论」拆开；附录机理默认当假说，除非有独立数据。
主张核对表每行三列：主张 | 支撑 | 评注。支撑写文档里实际有什么，评注写能推多远。
回写（仅显式要求时）
- 发评论：
lark-drive的drive +add-comment；优先贴「短摘要」，P0 可拆条评论。 - 改原文：走
lark-doc+update；高风险写入按lark-shared确认，禁止静默改别人的文档。
常见错误
- 只有摘要没有问题清单。
- 用「建议再完善」代替具体矛盾与应补矩阵。
- 把作者的下一步计划当成已经完成的验证。
- 忽略空标题、WIP 章节仍出现在结论里。
- 评审写得比源文档还长，却没给出「优先改三件事」。