文档写的是"能力清单"，用户要的是"怎么用"
AI 功能的文档常见写法是罗列能力 ✗："支持总结、支持问答、支持翻译" ✔。
用户读完仍然不知道：什么时候该用它、什么时候不该用、出错了怎么办 ✗。
好文档的结构应该是"能力 + 限制 + 示例" ✔。
一、能力（写清楚"能做什么"，但要具体）
- 用用户语言描述（"把长文档压成一页要点" ✔ 而不是"长文本摘要能力" ✗）；
- 给出输入要求（格式、长度上限、语言 ✔）；
- 说明典型耗时（"约 5 秒" ✔），让用户有预期 ✔。
二、限制（最有价值、最常被省略）
必须写：
- 不适合的场景（"不用于法律/医疗结论" ✔）；
- 已知的失败模式（"表格较多的文档可能丢格式" ✔）；
- 输入上限与超限后的行为 ✔；
- 数据如何被处理（是否外发、保存多久 ✔ —— 合规要求 ✔）。
写清限制能显著降低支持成本 ✔，也能减少误用导致的事故 ✔。
三、示例（要用真实问题）
- 3~5 个真实示例 ✔（从日志里挑高频且答得好的 ✔，见空状态那篇 ✔）；
- 每个示例给出：输入 → 输出要点 → 为什么这样用 ✔；
- 好例子之外，给 1 个反面例子 ✔（"这样问效果不好，改成……" ✔）。
四、出错了怎么办（专章）
- 常见错误与处理（格式不符、超出上限、上游繁忙 ✔）；
- 如何降级（换关键词、分批提交、改用人工 ✔）；
- 怎么反馈问题（带上请求 id ✔ —— 见可复现那篇 ✔）。
五、三个写作纪律
- 先说结论：第一段就写"这个功能适合什么、不适合什么" ✔；
- 可执行：每条限制都给出"那该怎么办" ✔（见长尾输入那篇的拒绝文案对照 ✔）；
- 有版本：文档随功能版本更新 ✔（模型换代后旧说明会变成错误信息 ✔）。
六、一份文档的最小结构
- 一句话说明（做什么、给谁用）
- 能做什么（具体能力 + 输入要求 + 耗时）
- 不能做什么（不适合场景 + 已知失败模式 + 上限）
- 怎么用（3~5 个真实示例 + 1 个反面例子）
- 出错怎么办（常见错误 + 降级路径 + 反馈方式）
- 数据与合规（如何处理、保存多久）
一条判据
用户只看第 3 节（不能做什么） ✔，能否避免最常见的误用 ✔？
不能，说明限制写得太笼统 ✗。