Feishu Document Permission Manager
飞书文档权限管理最佳实践——创建、配置、批量管理文档权限,支持用户和群聊级别权限控制。
When to Use
Use this skill when:
- 需要为飞书文档添加或移除协作者权限时
- 需要给群聊批量授予文档查看或编辑权限时
- 需要查询文档当前的权限配置状态时
- 用户反馈"无法转发"文档需要调整权限设置时
- 需要对敏感文档实施最小权限原则时
Do NOT use this skill if:
- 需要创建新文档 → use
feishu-doc-orchestratorinstead - 需要读取文档内容 → use
feishu-docinstead - 目标文档在知识库中且需要 Wiki 特有权限 → 结合
feishu-wiki-orchestrator处理
Typical triggers:
- 「给这个文档加权限」「群成员看不到文档」
- "Add edit permission for this user to the Feishu doc", "解决无法转发的问题"
- 「查询文档当前权限」
Workflow
探查 (Probe) 确认文档 token、文档类型(docx/sheet等)、目标用户/群聊 ID、期望权限级别。
约束 (Constrain) 遵循最小权限原则:默认给
view,需要编辑才给edit,仅管理员给full_access。群聊给view,特定协作者给edit,创建者保留full_access。不降级——敏感文档不放宽权限。证据 (Evidence) 查询现有权限列表,确认当前配置状态:
feishu_perm action=list token=xxx type=docx
- 执行 (Execute) 根据需求添加或移除权限:
# 添加用户编辑权限
feishu_perm action=add token=xxx type=docx member_id=ou_xxx member_type=openid perm=edit
# 添加群聊查看权限
feishu_perm action=add token=xxx type=docx member_id=oc_xxx member_type=openchat perm=view
# 移除用户权限
feishu_perm action=remove token=xxx type=docx member_id=ou_xxx member_type=openid
验证 (Verify) 再次查询权限列表,确认变更已生效。检查目标用户/群聊是否出现在权限列表中,权限级别是否正确。
交付 (Deliver) 返回权限变更摘要,清理临时文件。
Output
返回权限变更摘要,包含操作类型、目标成员、权限级别和变更前后的权限列表。
Guardrails
Anti-patterns
- NEVER 给群聊
full_access(所有人可删除) - Do NOT 给陌生人编辑权限而不审核
- Do NOT 在群聊中分享包含敏感信息的文档
- 禁止对核心配置文件(如 SOUL.md)放宽编辑权限
Constraints
- 最小权限原则:默认
view,需要编辑才给edit,仅管理员给full_access - 群聊权限 vs 个人权限:群聊给
view(只读),特定协作者给edit(可编辑),创建者保留full_access - 敏感文档保护:核心配置文件仅限创建者可编辑,群聊中不展示敏感配置,定期审查文档权限
Permission Levels
| 权限 | 说明 |
|---|---|
view |
仅查看,不可编辑 |
edit |
可编辑内容,不可管理权限 |
full_access |
完全权限,包括删除 |
Related Skills
- feishu-doc-orchestrator — 创建文档并自动分配权限
- feishu-wiki-orchestrator — 知识库文档创建
- feishu-doc — 只读读取文档
- feishu-group-welcome — 群聊管理相关工具
About UniqueClub
Part of the UniqueClub toolkit. 🌐 https://uniqueclub.ai