飞书文档可读性优化

What This Skill Does

飞书文档可读性优化 (Feishu Doc Readability Optimizer) 是一款专门为飞书云文档（mi.feishu.cn）定制的格式化与安全维护工具。它通过引入“最小修改原则”和“带属性占位符”技术，解决了通过 API 自动写入文档时常见的排版紧凑、视觉层次模糊及富文本丢失问题。该 Skill 能够自动化处理段落间距、加粗规范以及列表格式，确保自动化修改后的文档符合专业的人工阅读排版标准。

Installation

在 OpenClaw 环境中，请在控制台执行以下命令进行安装： clawhub install openclaw/skills/skills/guoqunabc/feishu-readability 安装完成后，在处理任何飞书文档任务前，请先调用该 Skill 以加载其安全约束与排版规范。

Use Cases

本 Skill 适用于以下场景：

1. 自动化文档排版：将生成的 Markdown 文本同步至飞书，并希望其在飞书客户端拥有良好的阅读体验。
2. 格式规范化：批量修复文档中加粗标点粘连、标题间距过窄等排版瑕疵。
3. 高风险编辑：涉及包含图片、公式等富文本标签的文档修改，需要严格遵守最小修改原则，防止数据意外丢失。

Example Prompts

1. "请通过小米飞书MCP将当前的文档项目计划标题前增加适当的视觉间距，确保阅读体验更清晰。"
2. "修正文档中所有‘加粗文字：正文’的格式，确保冒号外侧有空格，并按照飞书格式卫生规范检查列表项标点。"
3. "在这个飞书文档中，将‘核心指标’章节下的内容进行微调，仅修改文案，严禁重写文档或破坏原有的图片资源引用。"

Tips & Limitations

1. 核心铁律：绝对禁止使用 overwrite 模式，避免丢失历史记录与评论。
2. 空白修复：若遇到飞书解析器自动清洗空白导致排版过于拥挤，请务必使用带 {align="center"} 属性的空段落进行强制占位。
3. 定位精准：利用唯一的标点符号或特有 Token 进行 selection_with_ellipsis 定位，避免大范围选区误伤其它内容。
4. 富文本保护：对于包含 <image> 等复杂标签的区块，修改前必须先行获取 Token，禁止在未解析原文件结构的情况下盲目覆盖。