核心用法
Feishu Docx PowerWrite 是一个专注于飞书文档高质量输出的自动化技能，通过 feishu_docx_write_markdown 工具实现 Markdown 到飞书 Docx 的精准转换。
工作流程
1. 获取文档标识：从飞书文档 URL 中提取 document_id（即 docx/ 后的字符串）
2. 选择写入模式：
3. 编写 Markdown：使用标准 Markdown 语法，工具自动转换为飞书原生格式
- Append 模式（推荐）：在现有内容下方追加，适合会议纪要、日报等增量场景
- Replace 模式：全文档覆盖，需显式确认，适用于从零生成完整文档
格式支持
- 层级结构：
#一级标题、##二级标题、###三级标题 - 列表系统：无序列表（
-）、有序列表（1)）及嵌套组合 - 代码块：围栏代码块自动识别语言类型
- 分隔线与强调：水平线（
---）、粗体（**）等基础排版
显著优点
| 优势 | 说明 |
|------|------|
| **结构保真** | Markdown 的层级关系完整映射为飞书文档块结构，告别纯文本粘贴的混乱排版 |
| **双模式灵活** | Append 模式安全增量，Replace 模式支持全量重构，覆盖完整使用场景 |
| **批量友好** | 支持单次 300-600 行的内容块写入，适合自动化日报/周报生成 |
| **原生渲染** | 输出为飞书官方 Docx 格式，兼容性最佳，支持后续人工编辑 |
潜在局限
- 依赖 OpenClaw 平台：需配合 OpenClaw 的 Feishu OpenAPI 工具链使用，无法独立运行
- 格式边界：复杂表格、高级嵌入块（如图表、思维导图）需飞书端二次处理
- 权限前置：用户需预先配置 Feishu 应用凭证（app_id/app_secret）及
docx:document:write等权限范围 - 无实时预览：Markdown 侧无法直接可视化最终飞书效果，需写入后查验
适合人群
- 技术团队：需要将代码文档、API 说明、部署指南同步至飞书知识库
- 项目经理：自动化生成会议纪要、项目周报、进度追踪文档
- 运营人员：批量产出标准化活动文案、产品更新日志
- DevOps/SRE：将系统状态报告、告警汇总自动归档至协作平台
常规风险
| 风险类型 | 描述 | 缓解措施 |
|----------|------|----------|
| **误覆盖数据** | Replace 模式会清空原文档全部内容 | 强制要求 `confirm: true` 参数，建议先备份或使用 Append |
| **权限泄露** | 硬编码 token 或文档链接可能导致凭证暴露 | 技能内置安全约束：禁止在代码中硬写敏感信息，强制使用用户自有凭证 |
| **超长内容截断** | 单次写入过量内容可能触发 API 限制 | 建议分块处理，单批控制在 600 行以内 |
| **格式解析偏差** | 非标准 Markdown 语法可能渲染异常 | 遵循推荐模板结构，避免嵌套过深的复杂列表 |