核心用法
Skywork Document 是一款企业级文档生成技能，通过调用 Skywork Office Doc API 实现专业文档的自动化创作。其核心工作流分为三步：意图识别 → 文件解析（如有参考资料）→ 文档生成。
触发条件：任何可能产生文档输出的任务均应触发此技能，包括但不限于报告撰写、提案起草、论文创作、简历优化、合同生成等。当预期输出超过简短回答且需要结构化格式时，默认使用本技能。
关键特性：
- 多格式输出：支持 Word(docx)、PDF、HTML、Markdown 四种主流格式
- 智能参考资料处理：可解析用户上传的 PDF、Excel、Word 等文件作为创作基础
- 内置网络搜索：API 自动按需执行网络检索，无需预搜索
- 多语言支持：覆盖中文、英文、日语、韩语、法语、德语、西班牙语等
典型场景：
1. 从零创建：输入主题自动生成完整文档
2. 基于材料创作：上传参考资料进行改写、扩写、翻译或摘要
3. 结构化输出：将大纲扩展为正式报告，或将数据转化为分析文档
显著优点
- 专业格式化输出：生成的文档具备商业级排版质量，非纯文本可比
- 长文生成能力：支持 5-10 分钟的长时生成任务，适合深度内容创作
- SSE 实时进度：通过 Server-Sent Events 提供实时生成进度，用户体验友好
- 文件 ID 桥接机制：参考资料通过 file_id 传递，无需手动粘贴内容
- 智能意图识别：内置多语言触发关键词库，覆盖 10+ 种语言的文档请求
潜在缺点与局限性
- 依赖外部 API：必须配置 SKYWORK_API_KEY，且服务可用性受制于远程服务器
- 数据隐私风险：用户文件和请求原文会上传至 Skywork 服务端处理，敏感机密内容需谨慎
- 会员门槛：超出免费额度后需升级会员才能继续使用
- 生成耗时：复杂文档需 5-10 分钟，不适合即时性要求高的场景
- 非本地处理：网络搜索由服务端执行，非本地脚本实现
适合人群
- 商务人士：快速生成商业提案、合同、备忘录、会议纪要
- 学术研究者：撰写论文、研究报告、文献综述、实验记录
- 内容创作者：博客文章、社交媒体长文、新闻稿、故事创作
- 学生群体：课程报告、简历、求职信、学习笔记整理
- 跨国团队：多语言文档翻译与本地化适配
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据泄露 | 敏感文件上传至第三方服务器 | 避免上传机密合同、个人隐私文件；优先使用脱敏素材 |
| 认证失效 | API Key 过期或无效导致 401 错误 | 定期检查 SKYWORK_API_KEY 有效性，保留错误码以便排查 |
| 服务中断 | 网络问题或服务器不可用 | 检查本地网络连接，关注官方服务状态公告 |
| 额度耗尽 | 免费额度用尽导致生成失败 | 监控使用量，及时升级会员或调整使用频率 |
| 输出偏差 | AI 生成内容可能与预期不符 | 在 --content 参数中提供详细、明确的结构要求 |
安全等级说明：本技能涉及用户文件上传至远程服务器处理，存在数据隐私风险，建议用户充分了解 Skywork 的数据处理政策后再使用敏感内容。