Feishu Doc Perm

---
name: feishu-doc-perm
description: |
  飞书文档权限管理最佳实践 / Feishu document permission manager. 创建、配置、批量管理文档权限，支持用户和群聊级别权限控制，遵循最小权限原则。
  Use when: "飞书文档权限", "feishu document permissions", "添加协作者", "add collaborators", "文档共享设置", "document sharing settings", "批量权限管理", "batch permission management", "移除文档权限", "remove document access".
  支持 view / edit / full_access 三级权限，覆盖用户和群聊级别，解决无法转发等常见权限问题。Cross-references: feishu-doc-orchestrator, feishu-wiki-orchestrator, feishu-doc, feishu-group-welcome.
  Built by UniqueClub 🌐 https://uniqueclub.ai
version: "1.0.0"
---

# Feishu Document Permission Manager

> 飞书文档权限管理最佳实践——创建、配置、批量管理文档权限，支持用户和群聊级别权限控制。

## When to Use

Use this skill when:
- 需要为飞书文档添加或移除协作者权限时
- 需要给群聊批量授予文档查看或编辑权限时
- 需要查询文档当前的权限配置状态时
- 用户反馈"无法转发"文档需要调整权限设置时
- 需要对敏感文档实施最小权限原则时

Do NOT use this skill if:
- 需要创建新文档 → use `feishu-doc-orchestrator` instead
- 需要读取文档内容 → use `feishu-doc` instead
- 目标文档在知识库中且需要 Wiki 特有权限 → 结合 `feishu-wiki-orchestrator` 处理

Typical triggers:
- 「给这个文档加权限」「群成员看不到文档」
- "Add edit permission for this user to the Feishu doc", "解决无法转发的问题"
- 「查询文档当前权限」

## Workflow

1. **探查 (Probe)**
确认文档 token、文档类型（docx/sheet等）、目标用户/群聊 ID、期望权限级别。

2. **约束 (Constrain)**
遵循最小权限原则：默认给 `view`，需要编辑才给 `edit`，仅管理员给 `full_access`。群聊给 `view`，特定协作者给 `edit`，创建者保留 `full_access`。不降级——敏感文档不放宽权限。

3. **证据 (Evidence)**
查询现有权限列表，确认当前配置状态：
```
feishu_perm action=list token=xxx type=docx
```

4. **执行 (Execute)**
根据需求添加或移除权限：
```bash
# 添加用户编辑权限
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
```

5. **验证 (Verify)**
再次查询权限列表，确认变更已生效。检查目标用户/群聊是否出现在权限列表中，权限级别是否正确。

6. **交付 (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