SKILL.md
Feishu Message Recall
飞书消息撤回/删除工具 — 用于撤回或删除已发送的消息。
When to Use
- 需要删除自己误发的单条群消息时
- 需要批量删除话题(Thread)中的多条消息时
- 需要清理测试消息或历史垃圾消息时
- 需要查询话题中的消息列表以便选择性删除时
Do NOT use this skill if
- 需要删除别人发送的消息 → 飞书 API 仅支持删除自己发送的消息
- 消息发送已超过 24 小时 → 可能无法撤回
- 需要撤回系统消息或机器人自动消息 → 权限可能受限
Typical Trigger Phrases
- "撤回这条消息"
- "删除话题里的消息"
- "批量清理我刚才发的消息"
- "Recall the last Feishu message I sent"
Workflow
- Ask for inputs: 确认消息 ID(
omxxx)或话题 ID(omtxxx),以及是否需要批量删除 - Verify permission: 确认目标消息由当前应用/用户发送
- Execute recall:
```bash # 删除单条消息 python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_x100b5741b264fca0c12f636d26d1cdd
# 删除话题中的所有消息 python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_1ae2d7a2164f9ce5 ```
- Validate result: 确认删除成功,返回成功/失败计数
- Report summary: 返回操作结果摘要
Guardrails
- 只能删除自己发送的消息
- 超过 24 小时的消息可能无法删除
- 话题消息的删除权限与普通群消息相同
- 批量删除前建议先用
--list-thread查询话题中的消息列表 - 删除操作不可恢复,请谨慎执行
API Limitations
APPID和APPSECRET从环境变量或config.py读取- 需要 Python 3.8+ 和
requests
Usage Examples
# 删除单条消息
python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_xxx
# 删除话题中的所有消息
python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_xxx
# 查询话题中的消息
python3 skills/feishu-message-recall/scripts/recall.py --list-thread omt_xxx
Related Skills
- [feishu-chat-monitor](../feishu-chat-monitor/) - 检查遗漏的 @提及
- [feishu-group-welcome](../feishu-group-welcome/) - 群聊欢迎消息管理
About
Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai