# Send feishu-doc-long-content to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-doc-long-content",
    "name": "feishu-doc-long-content",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/Josephyb97/feishu-doc-long-content",
    "canonicalUrl": "https://clawhub.ai/Josephyb97/feishu-doc-long-content",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-doc-long-content",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-doc-long-content",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package.json",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-doc-long-content"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-doc-long-content",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-doc-long-content",
    "agentUrl": "https://openagent3.xyz/skills/feishu-doc-long-content/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-doc-long-content/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-doc-long-content/agent.md"
  }
}
```
## Documentation

### feishu-doc-long-content

飞书文档长内容写入实战经验，解决 content 超长截断问题

### 问题背景

飞书文档工具 feishu_doc 的 write / create action 对单次 content 长度有限制（约 1KB），超出后会：

直接返回 400 错误
或部分写入后截断（显示空白）

### 1. create 只是创建空白文档

{
  "action": "create",
  "title": "新文档"
}

返回 doc_id，但文档内容是空的。

### 2. 必须用 write 写入内容

{
  "action": "write",
  "doc_token": "ABC123",
  "content": "# 标题\\n内容..."
}

### 3. content 必须控制在 1KB 以内

经验值：

< 800 字节：安全写入
800-1500 字节：可能失败
> 1500 字节：基本失败

### 4. 长内容解决方案

方案A：拆分章节
将内容拆成多个小文档，每个 < 800 字节：

文档1：第1-2章
文档2：第3-4章
文档3：第5-6章
文档4：第7-8章

方案B：多次 append
创建文档后，分多次 append（但 append 也有累积限制）

方案C：先存本地文件
将内容写入本地 md 文件，让用户自己查看或转换

### 正确流程

// 1. 创建文档
{ "action": "create", "title": "笔记 Ch1" }
// → { "doc_id": "ABC123", "url": "..." }

// 2. 写入内容（控制 < 800 字节）
{ "action": "write", "doc_token": "ABC123", "content": "精简版内容..." }

// 3. 验证
{ "action": "read", "doc_token": "ABC123" }

### 常见错误

错误表现原因解决方案文档创建后空白create 后没写 content用 write 写入write 返回成功但内容截断content 超过 1KB拆分内容write 返回 400 错误content 过长精简内容或拆分

### 判断内容长度

在写入前估算：

纯文本：约 1 字符 = 1 字节
Markdown：约 1 字符 = 1 字节（含格式符）
经验：800 字符约等于 800 字节（中文英文混合时略大）

### 最佳实践

先在本地写 md 文件，确认内容完整
写入飞书前精简，移除冗余格式和重复内容
分章节输出，每章一个文档
写入后立即验证，用 read 检查 block_count

经验来源：2026-02-25 初级会计实务笔记输出实战
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Josephyb97
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-doc-long-content)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-doc-long-content/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-doc-long-content/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-doc-long-content/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-doc-long-content)