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.mdsource content
Feishu Drive
浏览、组织和管理飞书云盘中的文件和文件夹。
边界:Drive 管理文件树(文件的位置、组织结构),feishu-doc 管理文档内容(读写文档正文)。
File Types
| file_type | 说明 |
|---|---|
| 文档 |
| 电子表格 |
| 多维表格 |
| 文件夹 |
| 上传文件 |
| 思维笔记 |
| 幻灯片 |
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}
必填。自动去重(见 Coded Behaviors);自动授予创建者 full_access。parent_token - move — 移动文件/文件夹。params:
。两个参数均必填。{file_token, target_folder_token} - delete — 删除文件/文件夹(移入回收站,30 天内可恢复,非永久删除)。params:
。两段式确认(见 Coded Behaviors)。{file_token, file_type, confirmed?=false}
取值见上表。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"})