feishu

分类: 文档与知识管理 | 上传者: WenHaoWang1997 | 下载: 0 | 版本: v1.0（最新）

当需要操作飞书（文档、消息、表格、日历、审批、知识库等）时使用。

更新日志: Source: GitHub https://github.com/WenHaoWang1997/feishu-skills

目录结构

当前层级: 根目录

📁 approval/
- 📁 create/
  - 📄 SKILL.md 589 B
  - 📄 tool.py 1.1 KB
- 📁 query/
  - 📄 SKILL.md 440 B
  - 📄 tool.py 1.8 KB
- 📄 SKILL.md 270 B
📁 bitable/
- 📁 create/
  - 📄 SKILL.md 495 B
  - 📄 tool.py 1.3 KB
- 📁 query/
  - 📄 SKILL.md 1.0 KB
  - 📄 tool.py 2.8 KB
- 📁 update/
  - 📄 SKILL.md 550 B
  - 📄 tool.py 1.3 KB
- 📄 SKILL.md 481 B
📁 calendar/
- 📁 create-event/
  - 📄 SKILL.md 742 B
  - 📄 tool.py 2.4 KB
- 📁 list-events/
  - 📄 SKILL.md 664 B
  - 📄 tool.py 2.2 KB
- 📄 SKILL.md 258 B
📁 contacts/
- 📄 SKILL.md 717 B
- 📄 tool.py 2.5 KB
📁 docs/
- 📁 create/
  - 📄 SKILL.md 862 B
  - 📄 tool.py 2.1 KB
- 📁 list/
  - 📄 SKILL.md 829 B
  - 📄 tool.py 2.0 KB
- 📁 read/
  - 📄 SKILL.md 1.1 KB
  - 📄 tool.py 3.5 KB
- 📁 search/
  - 📄 SKILL.md 1.1 KB
  - 📄 tool.py 2.1 KB
- 📁 update/
  - 📄 SKILL.md 773 B
  - 📄 tool.py 1.7 KB
- 📄 SKILL.md 654 B
📁 messages/
- 📁 send/
  - 📄 SKILL.md 1022 B
  - 📄 tool.py 1.5 KB
- 📁 webhook/
  - 📄 SKILL.md 769 B
  - 📄 tool.py 1.1 KB
- 📄 SKILL.md 471 B
📁 scripts/
- 📄 __init__.py 26 B
- 📄 api.py 1.1 KB
- 📄 auth.py 906 B
- 📄 config.py 884 B
- 📄 oauth.py 6.2 KB
📁 sheets/
- 📁 create/
  - 📄 SKILL.md 528 B
  - 📄 tool.py 1.1 KB
- 📁 read/
  - 📄 SKILL.md 805 B
  - 📄 tool.py 1.8 KB
- 📁 write/
  - 📄 SKILL.md 644 B
  - 📄 tool.py 1.3 KB
- 📄 SKILL.md 457 B
📁 wiki/
- 📁 read/
  - 📄 SKILL.md 543 B
  - 📄 tool.py 1.5 KB
- 📁 search/
  - 📄 SKILL.md 1.0 KB
  - 📄 tool.py 4.9 KB
- 📄 SKILL.md 380 B
📄 .env.example 164 B
📄 .gitignore 36 B
📄 README.md 5.4 KB
📄 requirements.txt 17 B
📄 setup.bat 1.7 KB
📄 SKILL.md 4.2 KB

SKILL.md

---
name: feishu
description: "当需要操作飞书（文档、消息、表格、日历、审批、知识库等）时使用。"
alwaysApply: false
---

# 飞书技能集

当你需要与飞书交互时，根据操作类型读取对应子目录的 SKILL.md：

| 操作类型 | 子目录 | 说明 |
|---------|--------|------|
| 文档 | `docs/` | 创建、读取、搜索、更新云文档 |
| 表格 | `sheets/` | 读写电子表格 |
| 消息 | `messages/` | 发送文本/卡片消息、webhook |
| 通讯录 | `contacts/` | 搜索用户、获取用户信息 |
| 知识库 | `wiki/` | 搜索、阅读知识库页面 |
| 多维表格 | `bitable/` | 多维表格记录增删改查 |
| 日历 | `calendar/` | 创建/查询日程 |
| 审批 | `approval/` | 创建/查询审批实例 |

## 快速部署

### 方式一：一键安装（推荐）
```bash
.claude/skills/feishu/setup.bat
```
自动完成 Python 检测、依赖安装和配置文件生成。

### 方式二：手动安装
1. 安装 Python 3.9+（[下载](https://www.python.org/downloads/)）
2. 安装依赖：`py -3 -m pip install -r .claude/skills/feishu/requirements.txt`
3. （可选）复制 `.env.example` 为 `.env`，填入飞书应用凭证

### 凭证配置
飞书应用凭证加载优先级：**环境变量 > `.env` 文件 > 内置默认值**

```bash
# .env 文件格式（放在 .claude/skills/feishu/.env）
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
```

如果使用团队共享的默认应用，无需额外配置。

### 环境要求
- **Python**：3.9+
- **第三方依赖**：`requests>=2.25.0`（唯一第三方包）
- **敏感文件**：`.env` 和 `.oauth_token.json` 已在 `.gitignore` 中排除

## 通用规则

1. 所有 tool.py 使用 `scripts/` 下的共享认证模块，无需手动传 token
2. 调用 tool.py 前，先确认可用的 Python 3 命令：
   - Windows 优先尝试 `py -3`（Python Launcher），其次 `python3`，最后 `python`
   - 运行 `<命令> --version` 确认版本 ≥ 3.9
   - 调用格式：`<python命令> -X utf8 <skill所在目录>/tool.py <参数>`
   - 示例：`py -3 -X utf8 .claude/skills/feishu/docs/search/tool.py --query "关键词"`
3. 输出格式为 LLM 可读的纯文本，非原始 JSON
4. 出错时输出以 `[error]` 开头的错误信息
5. 路径基准：`.claude/skills/feishu/`（相对于项目根目录）

## 权限配置

飞书应用需要在 [飞书开放平台管理后台](https://open.feishu.cn/app) 开通以下 scope：

### 应用权限（tenant_access_token，在开放平台"权限管理"开通）

| 功能 | 所需 scope |
|------|-----------|
| 文档读写 | `docs:doc`、`docx:document` |
| 云空间/文件夹 | `drive:drive` |
| 知识库 | `wiki:wiki` |
| 电子表格 | `sheets:spreadsheet` |
| 多维表格 | `bitable:app` |
| 消息发送 | `im:message`、`im:message:send_as_bot` |
| 通讯录 | `contact:user.base:readonly`、`contact:user.id:readonly` |
| 日历 | `calendar:calendar`、`calendar:calendar:readonly` |
| 审批 | `approval:approval`、`approval:instance` |

### OAuth 用户权限（user_access_token，在"安全设置"添加重定向 URL）

搜索类 API 需要用户授权，OAuth 回调地址：`http://localhost:19897/callback`

OAuth 请求的 scope：`docs:doc drive:drive wiki:wiki docx:document`

### 故障排查

- `code=99991672` (Access denied) → 对应 scope 未开通
- `code=20043` (scope 有误) → OAuth scope 名称不正确
- `code=20029` (redirect_uri 不合法) → 需在安全设置添加回调 URL

## 扩展新功能

如果当前工具包没有覆盖你需要的飞书功能，可以自行添加 skill：

1. 查阅 [飞书服务端 API 文档](https://open.feishu.cn/document/server-docs/api-call-guide/calling-process/overview) 确认目标 API 是否存在
2. 在对应分类目录下新建子目录（如 `messages/reply/`），包含：
   - `SKILL.md` — 遵循现有叶子节点格式（frontmatter `name` + `description`，用法说明 + 参数 + 示例）
   - `tool.py` — 遵循现有模板：argparse CLI → 调用 `scripts.api.api_request()` → 纯文本输出
3. 如果是全新分类，在本文件的操作类型表中补充对应条目
4. `scripts/api.py` 已封装好认证和请求，新 tool.py 只需关注业务逻辑

登录后下载/点赞/收藏 ❤ 17 | ★ 0

feishu

目录结构

SKILL.md

举报内容

提示