基于 OpenClaw 的飞书文档智能写作助手，将 Markdown 一键转换为专业排版的企业级文档，提升团队协作效率。
说明：
## 核心用法
Feishu Docx PowerWrite 是一款专注于飞书文档格式化的专业工具，核心功能是将 Markdown 内容转换为结构清晰、排版精美的飞书 Docx 文档。用户通过获取文档 ID（从飞书文档 URL 中提取 `docx/>` 部分），选择写入模式（Append 追加或 Replace 全量替换），即可调用 `feishu_docx_write_markdown` 工具完成内容写入。
该技能支持完整的 Markdown 语法映射：标题层级自动转换为飞书文档的标题样式，列表（有序/无序）保持嵌套结构，代码块以围栏格式呈现，分割线用于内容区隔。推荐采用”标题+摘要+章节+子章节”的模块化写作模式，单次追加内容控制在 300-600 行以内以保证渲染性能。
## 显著优点
**格式保真度高**：相比直接粘贴 Markdown，该技能通过 OpenClaw 调用飞书 OpenAPI，能完整保留标题层级、列表缩进、代码高亮等格式细节，避免手动排版的繁琐。
**操作安全性设计**：Append 模式作为默认推荐，避免误覆盖现有内容；Replace 模式强制要求 `confirm: true` 确认，防止破坏性操作。这种双模式设计兼顾了日常增量更新和全量生成的场景需求。
**开箱即用的模板体系**：内置会议纪要、周报、项目提案等企业常用文档模板，配合故障排除指南，降低新用户上手门槛。
**架构解耦**：自身不处理网络请求和身份认证，完全依赖 OpenClaw 管理飞书 API 调用和凭证安全，技能本身仅作为”最佳实践指南”存在，攻击面极小。
## 潜在缺点与局限性
**功能边界明确**：该技能本质是”写作指南+工具调用封装”，并非独立的文档编辑器。用户仍需自行准备 Markdown 内容，无法直接在对话中可视化编辑文档结构。
**依赖外部工具链**：必须预先安装配置 OpenClaw 并完成飞书应用授权，环境准备成本较高。若 OpenClu 版本不兼容或飞书 API 变更，可能导致功能失效。
**无实时预览能力**：写入操作是”盲操作”，用户无法在执行前预览最终渲染效果，需依赖飞书端打开文档确认，调试成本较高。
**长文档性能瓶颈**：虽然建议单次 300-600 行，但对于万字以上的技术文档或书籍，需要手动拆分为多次追加，破坏了内容的完整性体验。
## 适合的目标群体
– **企业知识管理者**：需要批量将技术文档、API 文档从 Markdown 迁移至飞书知识库
– **项目经理/助理**：高频产出会议纪要、周报、项目提案，追求格式标准化
– **开发团队**：将代码仓库中的 README、设计文档同步至飞书供非技术人员阅读
– **内容运营**：在多平台发布场景下，以 Markdown 为单一信源，向飞书渠道快速分发
## 使用风险
**操作不可逆风险**：Replace 模式会清空文档全部历史内容，虽有多重确认机制，但用户误操作或 prompt 注入攻击仍可能导致数据丢失。建议关键文档先手动备份。
**外部依赖稳定性**：OpenClaw 和飞书 OpenAPI 的任何变更（权限收紧、接口废弃、速率限制）都会直接影响技能可用性。企业用户应关注 OpenClaw 版本更新日志。
**凭证配置复杂度**：虽然技能本身不接触 Token，但用户需独立完成飞书应用创建、权限申请、凭证配置等流程，配置错误会导致写入失败，排查需具备一定的开发者背景。
**内容隐私边界**：Markdown 内容会经 OpenClaw 传输至飞书服务器，虽无持久化风险，但对极度敏感的内网文档，需评估飞书云端存储的合规性要求。
会员专属
