Learn-skills.dev feishu-doc-optimizer

飞书云文档内容优化与格式美化。当用户需要优化飞书文档的排版、结构、格式、美观度时使用此技能。支持：(1) 读取飞书文档内容 (2) 优化文档结构和层次 (3) 清空并替换文档内容 (4) 通过浏览器自动化编辑文档。触发词：优化飞书文档、美化文档、整理文档格式、文档排版。

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aaaaqwq/agi-super-skills/feishu-doc-optimizer" ~/.claude/skills/neversight-learn-skills-dev-feishu-doc-optimizer && rm -rf "$T"

manifest: data/skills-md/aaaaqwq/agi-super-skills/feishu-doc-optimizer/SKILL.md

source content

飞书云文档优化器

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

工作流程

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 不支持直接删除文档块
编辑模式：确保文档处于"编辑"模式而非"阅读"模式
保存确认：编辑后等待"已保存到云端"提示