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 次

内容格式化规则

文档权限设置

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

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 凭证是否有效
• 涉及敏感信息的文档需确认可见性设置