飞书机器人范围说明

步骤

1. 1

   写出机器人只做的一件事

   用一句话定义触发和结果。如果有第二件事，拆成另一个范围说明。

2. 2

   列最小权限

   只申请完成这一件事需要的读或写权限。旁边写下明确不申请的相邻权限，避免以后顺手加上。

3. 3

   写下事件和幂等

   列出会收到的事件、重复投递时怎么识别已经处理过。没确定的字段写成待查，不编 API 名称。

4. 4

   写失败时的人话

   令牌失效、权限不够、对端超时，分别告诉使用者看到什么、找谁。不把堆栈当提示。

约束

• 不编造不存在的飞书接口字段。不确定就标「待查文档」。
• 不申请「先全都打开」的权限。
• 范围说明不是上线许可，也不包含自动发消息的承诺。

可复制提示词

```text
请遵守 engineering/engineering-feishu-integration-developer.md。不确定的接口字段写「待查文档」，不要编。

按「飞书机器人范围说明」处理我的需求：
1. 用一句话写机器人只做的事。
2. 列出最小权限，以及明确不申请的权限。
3. 列出事件；重复通知时如何避免做两次。
4. 写令牌失效、权限不足、超时三种失败提示。

输出：