飞书云文档优化器 Skill

飞书云文档优化器

优化飞书云文档的内容结构、排版格式和视觉美观度。

工作流程

1. 读取文档内容

使用飞书 API 读取文档原始内容：

python3 scripts/feishu_doc_reader.py <doc_token>

文档 token 从 URL 提取：https://xxx.feishu.cn/docx/<doc_token>

2. 分析并优化内容

优化原则：

结构清晰：使用标准章节编号（1. 2. 3.）
层次分明：一级标题、二级标题、正文层次清晰
内容精炼：删除冗余，保留核心信息
视觉美观：使用 emoji 标记、分隔线、表格对齐

3. 替换文档内容

通过 Playwright 浏览器自动化：

python3 scripts/feishu_doc_editor.py <doc_token> <content_file>

流程：

连接已登录的浏览器
打开文档进入编辑模式
循环 Ctrl+A + Backspace 清空内容
逐行输入新内容

飞书 API 配置

租户配置

| 租户 | App ID | 用途 | |------|--------|------| | hanxing | YOUR_FEISHU_APP_ID | 汉兴企业（默认） | | personal | cli_a83467f9ecba5013 | 个人应用 |

API 权限

需要的权限范围：

docx:document:readonly - 读取文档
docx:document - 编辑文档（API 方式）

优化模板

项目文档模板

# [项目名称]

> [一句话描述]
> 📅 版本：vX.X | 更新日期：YYYY-MM-DD

---

## 📋 目录
1. 项目背景  2. 系统架构  3. 核心功能  ...

---

## 1. 项目背景

### 1.1 痛点分析
🔴 痛点1 - 描述 ⭐⭐⭐⭐⭐
🔴 痛点2 - 描述 ⭐⭐⭐⭐

### 1.2 解决方案
方案描述...

---

## 2. 核心功能

### 2.1 功能名称 ✅
**功能**：功能描述
**流程**：步骤1 ➜ 步骤2 ➜ 步骤3

---

## N. 项目价值

### N.1 投入成本
| 项目 | 成本 | 说明 |
|------|------|------|
| 项目1 | ¥0 | 说明 |

### N.2 产出价值
⏱️ 指标1：描述
💰 指标2：描述

---

💡 如有改进建议，欢迎提出！

格式规范

Emoji 使用

| 场景 | Emoji | |------|-------| | 目录/导航 | 📋 | | 日期/版本 | 📅 | | 痛点/问题 | 🔴 | | 已完成 | ✅ | | 进行中 | 🔄 | | 待办 | ⏳ | | 重要提示 | ⚠️ 💡 | | 数据采集 | 📥 | | 数据处理 | ⚙️ | | 数据展示 | 📊 | | 时间 | ⏱️ | | 成本 | 💰 | | 增长 | 📈 |

分隔符

章节分隔：---（三个短横线）
流程箭头：➜
星级评分：⭐⭐⭐⭐⭐

表格格式

| 列1 | 列2 | 列3 |
|:---:|------|:---:|
| 居中 | 左对齐 | 居中 |

注意事项

登录状态：浏览器编辑需要已登录飞书
API 限制：飞书 API 不支持直接删除文档块
编辑模式：确保文档处于"编辑"模式而非"阅读"模式
保存确认：编辑后等待"已保存到云端"提示

Agent Skills: 飞书云文档优化器

Install this agent skill to your local

Skill Files