Agentic-feishu feishu-drive

飞书云盘/云空间管理。用于列出文件/文件夹、创建文件夹、移动/删除文件、搜索。当用户提到云盘、文件管理、文件夹、整理文件、找文件时触发。注意:读写文档内容用 feishu-doc,云盘管理文件树。

install
source · Clone the upstream repo
git clone https://github.com/MidnightV1/agentic-feishu
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/MidnightV1/agentic-feishu "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/feishu_drive" ~/.claude/skills/midnightv1-agentic-feishu-feishu-drive && rm -rf "$T"
manifest: skills/feishu_drive/SKILL.md
source content

Feishu Drive

浏览、组织和管理飞书云盘中的文件和文件夹。

边界:Drive 管理文件树(文件的位置、组织结构),feishu-doc 管理文档内容(读写文档正文)。

File Types

file_type说明
docx
文档
sheet
电子表格
bitable
多维表格
folder
文件夹
file
上传文件
mindnote
思维笔记
slides
幻灯片

CLI 调用方式

cd ~/Agent\ Space/agentic-feishu && python3 tools/builtin/skill_drive.py <action> --params '<json>'

示例:

python3 tools/builtin/skill_drive.py list --params '{}'

Actions

调用方式:

python3 tools/builtin/skill_drive.py <action> --params '<json>'

  • list — 列出文件/文件夹。params:
    {folder_token?, page_size?=20}
    。不传
    folder_token
    则列根目录。
  • search — 按关键词搜索文件。params:
    {query, count?=10}
    。关键词匹配文件名。
  • create_folder — 创建文件夹。params:
    {name, parent_token, force?=false}
    parent_token
    必填。自动去重(见 Coded Behaviors);自动授予创建者 full_access。
  • move — 移动文件/文件夹。params:
    {file_token, target_folder_token}
    。两个参数均必填。
  • delete — 删除文件/文件夹(移入回收站,30 天内可恢复,非永久删除)。params:
    {file_token, file_type, confirmed?=false}
    。两段式确认(见 Coded Behaviors)。
    file_type
    取值见上表。

Coded Behaviors

Auto-dedup on create_folder:创建文件夹前自动检查

parent_token
下是否已存在同名文件夹。若存在,返回重复信息(含已有文件夹的 token)而不创建,除非传
force=true
。未提供
parent_token
时跳过去重检查。

Auto-share on create_folder:创建成功后自动调用

ensure_user_access
,授予创建者
full_access
。此步骤失败不阻塞主流程。

Confirmation-gated delete(两段式):第一次调用返回确认提示,不执行删除;第二次传

confirmed=true
才真正执行。目的是防误删。

Delete = trash:删除操作将文件移入回收站,30 天内可从回收站恢复,期满后不可逆。

Params Examples

feishu_drive("list", {"folder_token": "fldcnXXX", "page_size": 50})
feishu_drive("list", {})                                                          # 列根目录
feishu_drive("create_folder", {"name": "项目文档", "parent_token": "fldcnXXX"})
feishu_drive("create_folder", {"name": "项目文档", "parent_token": "fldcnXXX", "force": true})  # 跳过去重
feishu_drive("delete", {"file_token": "xxx", "file_type": "docx"})               # 第一次:返回确认提示
feishu_drive("delete", {"file_token": "xxx", "file_type": "docx", "confirmed": true})  # 第二次:执行删除
feishu_drive("search", {"query": "周报", "count": 20})
feishu_drive("move", {"file_token": "xxx", "target_folder_token": "fldcnYYY"})