Agent Skills
返回列表
飞书文档所有权转移

飞书文档所有权转移

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_99514c20/feishu-ownership-transfer。

技能介绍

问题背景

通过飞书开放平台 API 创建文档、多维表格或电子表格时,默认所有者往往是机器人应用,而不是发起创建请求的真实用户。后续协作、权限管理和「我的文档」归属都会因此错位——用户明明是自己要的表格,却在飞书里显示为应用名下资源。

本技能针对这一固定流程:在创建完成后,把文档/表格的所有权转移给请求者的 open_id。

技能如何工作

技能拆成两步,且强调在同一命令块内完成,避免 tenant_access_token 在变量传递中被截断:

  1. 获取令牌:调用 scripts/get_token.py,从 .env 中的飞书应用凭证换取 tenant_access_token(有效期约 2 小时)。
  2. 转移所有权:scripts/transfer_ownership.py 接收 doc_token、member_id、type 与 token,调用飞书转移接口。

静态策略写死在脚本里:member_type 为 openid,need_notification 为 false,原所有者保留 full_access 且不会被移除(remove_old_owner 为 false)。

动态参数需与上游创建步骤对齐:

  • doc_token:来自 feishu_doc create 或 feishu_bitable_create_app 的返回值
  • member_id:请求者 open_id(通常从 inbound context 读取)
  • type:与资源类型一致,如 docx、bitable、sheet、wiki 等

适用边界与注意点

  • Token 时效:遇到 99991663(无效)或 99991664(过期)应重新取 token,并立刻在同一次执行里完成转移。
  • 类型必须匹配:type 与创建时的文档形态不一致会导致接口失败,需对照技能文档中的类型表。
  • 配置隔离:他人复用技能时只需改 .env 中的应用凭证,无需改脚本逻辑。

使用场景

  • 智能体通过 `feishu_bitable_create_app` 建表后,需把表所有者从应用改回对话里发起需求的员工
  • 工作流用 API 生成会议纪要 `docx`,后续协作与分享要求创建人而非机器人出现在所有者字段
  • 集成脚本批量创建 `sheet` 后,按 inbound context 里的 `open_id` 把表格归属给对应业务同学
  • 知识库自动化新建 `wiki` 节点后,需将节点所有者指定为项目负责人以便后续维护权限

适合人员

  • 在对话式智能体里串联「创建飞书文档 + 回传链接」、且必须让真实用户成为所有者的后端开发
  • 维护企业内部飞书应用、负责 `feishu_doc create` 与权限策略落地的集成工程师
  • 用工作流平台按用户请求动态建多维表格、并在创建后立即修正所有者字段的自动化搭建者
  • 将飞书文档创建纳入 CI/运维脚本、需要按 `open_id` 区分资源归属的平台工程师