核心用法
Skywork Document 是一款集成 Skywork Office Doc API 的专业文档生成技能，专为需要结构化、格式化输出的长文本任务设计。核心工作流程分为三步：意图识别 → 参考文件解析（可选）→ 文档生成。
意图识别是首要步骤，需分析用户是否提供参考文件、目标语言、输出格式（docx/pdf/html/md）以及内容需求。若用户上传了文件，需先调用 parse_file.py 逐个解析，提取 file_id 供后续使用。
文档生成通过 create_doc.py 完成，支持从零创建或基于参考文件改写。关键参数包括 --title（标题，不含空格）、--content（内容提示，需精准合成用户需求）、--files（参考文件 JSON 数组）、--language（多语言支持）和 --format（输出格式）。该 API 内置自动网络搜索功能，无需预搜索即可获取最新内容。
显著优点
1. 多格式专业输出：原生支持 Word、PDF、HTML、Markdown，满足不同场景需求
2. 智能内容增强：自动网络搜索补充素材，无需用户手动检索
3. 参考文件深度利用：可基于上传文档进行改写、扩写、摘要、翻译等操作
4. 长文生成能力：适合报告、提案、论文、合同等复杂文档，生成时间 5-10 分钟
5. 实时进度反馈：SSE 长连接提供进度条，用户体验透明可控
6. 多语言原生支持：覆盖中英日韩法德西等主流语言
潜在局限
1. 生成耗时较长：复杂文档需等待 5-10 分钟，不适合即时性需求
2. API 依赖性强：需配置 SKYWORK_API_KEY，存在服务可用性风险
3. 会员门槛：高级功能可能触发「Insufficient benefit」限制，需付费升级
4. 格式限制：不支持纯短文本、代码文件、临时笔记等非正式输出
5. 文件解析串行：多文件需逐个调用 parse_file.py，虽可并行但仍增加复杂度
适合人群
- 商务人士：快速生成提案、合同、报告
- 研究人员：整理文献、撰写论文、制作摘要
- 内容创作者：博客文章、社交媒体长文、小说创作
- 学生群体：简历制作、课程作业、学习笔记整理
- 跨语言工作者：多语言文档翻译与本地化
常规风险
- 认证失败：SKYWORK_API_KEY 配置错误或失效会导致 401 错误
- 网络超时：长生成任务可能因网络波动中断
- 内容合规：AI 生成内容需人工审核，避免用于法律、医疗等高风险场景
- 数据隐私：上传的参考文件会发送至 Skywork 服务器处理
- 配额耗尽：高频使用可能触发会员升级提示
使用建议
明确指定输出格式和语言，提供详细的 --content 提示以控制生成质量，复杂任务建议预上传参考文件以提升准确性。