# Feishu Doc Writer

> 飞书文档自动生成 Skill

- Skill: `winkooui/feishu-doc-writer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add winkooui/feishu-doc-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/winkooui/feishu-doc-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: winkooui (https://skillmd.com/u/winkooui)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/winkooui/feishu-doc-writer

---

# 飞书文档自动生成 Skill

将 AI 生成的内容自动写入飞书文档，支持长文档分段写入、格式化排版、文档权限设置。

---

## 元信息

- **名称**: feishu-doc-writer
- **触发词**: "写入飞书"、"飞书文档"、"创建飞书文档"、"存到飞书"、"飞书笔记"
- **适用场景**: 会议纪要、技术文档、知识笔记、研究报告、项目文档
- **依赖**: lark-unified skill（飞书 API 调用）

## 核心规范

### 文档结构

```
标题（一级标题，加粗）
├── 概述/背景（可选）
├── 正文各章节（二级标题）
│   ├── 小节（三级标题，可选）
│   ├── 列表/表格/引用块
│   └── 代码块（如有）
├── 总结/结论（可选）
└── 附录/参考（可选）
```

### 长文档分段写入

飞书 API 对单次写入有 block 数量限制，长文档必须分段写入：

1. **首次创建**: 调用 `lark doc:create` 创建文档
2. **分段写入**: 每次 100-150 blocks，等上一次写入完成后再写入下一段
3. **进度反馈**: 每段写入完成后告知用户当前进度（如 "已写入 3/7 段"）
4. **错误重试**: 写入失败时等待 2 秒后重试，最多 3 次

### 内容格式化规则

| 元素 | 飞书格式 | 说明 |
|------|---------|------|
| 一级标题 | Heading 1 | 文档标题，仅一个 |
| 二级标题 | Heading 2 | 章节标题 |
| 三级标题 | Heading 3 | 小节标题 |
| 正文 | Text / 14px | 行距 1.6 |
| 强调 | **加粗** | 关键术语、重要结论 |
| 引用 | Quote block | 重要观点、他人原话 |
| 代码 | Code block | 技术内容 |
| 无序列表 | Bullet list | 并列要点 |
| 有序列表 | Numbered list | 步骤流程 |
| 表格 | Table | 对比、数据展示 |
| 分割线 | Divider | 章节间分隔 |

### 文档权限设置

创建文档后必须设置权限：

1. **转让所有者**: 将文档所有者转让给指定用户
   - 默认 openId: `ou_18a9965f9d5e519af41e82178dafcd10`
2. **添加协作者**: 根据需要添加相关人员的编辑/阅读权限
3. **文档可见性**: 默认设为"指定人可见"

## 执行流程

```
用户输入内容/主题
    │
    ▼
① 理解用户意图
    ├─ 是创建新文档还是追加内容？
    ├─ 文档类型是什么？（会议纪要/技术文档/笔记/报告）
    └─ 是否有指定的文档标题？
    │
    ▼
② 内容规划
    ├─ 生成分段大纲
    ├─ 估算总 block 数
    └─ 规划分段策略（每段 100-150 blocks）
    │
    ▼
③ 创建文档
    ├─ 调用 lark doc:create
    ├─ 写入标题
    └─ 返回文档 URL
    │
    ▼
④ 分段写入内容
    ├─ 按大纲逐段写入
    ├─ 每段等待上一次完成
    ├─ 实时反馈进度
    └─ 失败自动重试
    │
    ▼
⑤ 权限设置
    ├─ 转让所有者
    └─ 添加协作者（如需要）
    │
    ▼
⑥ 完成反馈
    ├─ 返回文档链接
    └─ 摘要写入内容概要
```

## 内容质量要求

1. **结构清晰**: 必须有层级分明的标题体系
2. **语言简洁**: 飞书文档面向阅读，避免冗余表述
3. **格式统一**: 同类元素使用相同格式
4. **表格优先**: 对比类、数据类内容优先用表格呈现
5. **重点突出**: 关键信息用加粗或引用块标记

## 示例

**用户输入**:
> "把今天关于AI测试方案的讨论写入飞书文档"

**执行**:
1. 创建飞书文档《AI测试方案讨论纪要》
2. 分段写入：概述 → 测试范围 → 技术方案 → 排期计划 → 待办事项
3. 转让文档所有者
4. 返回文档链接

## 注意事项

- 单次写入 block 数严格控制在 100-150 内
- 写入间隔至少 1 秒，避免触发频率限制
- 文档创建失败时检查 API 凭证是否有效
- 涉及敏感信息的文档需确认可见性设置