Skywork Document

核心用法

Skywork Document 是一款专业级文档生成工具，通过调用 Skywork 云端 API 实现智能文档创作。主要工作流程分为三步：

1. 意图识别（关键步骤）：分析用户需求，判断是否需要引用文件、确定输出语言和格式（默认 docx）、提炼内容提示词
2. 文件解析（可选）：使用 parse_file.py 逐个解析用户上传的参考文件，提取 file_id 供后续调用
3. 文档生成：使用 create_doc.py 执行创作，支持自动联网搜索补充内容，生成后返回下载链接和本地路径

该技能内置多语言能力，支持英语、简体中文、繁体中文、日语、韩语、法语、德语、西班牙语等；输出格式覆盖 Word(docx)、PDF、HTML、Markdown 四种主流格式。

显著优点

• 一键专业排版：无需手动调整格式，API 自动生成美观的文档结构
• 智能内容增强：自动调用搜索引擎获取最新信息，减少用户前期资料搜集工作
• 多源融合创作：可同时基于多个上传文件（PDF、Excel、Word 等）进行改写、摘要、扩写、翻译等操作
• 实时进度反馈：通过 SSE 长连接推送生成进度，用户可感知 5-10 分钟的等待过程
• 自动双通道交付：同时提供云端下载链接和本地文件路径，兼顾分享与本地管理需求

潜在缺点与局限性

• 强依赖云端服务：所有文件上传、内容处理均在 Skywork 服务器完成，存在数据隐私风险，不适合处理机密敏感内容
• 付费墙限制：生成文档消耗 "benefit" 额度，免费用户可能遇到 Insufficient benefit 错误，需升级会员
• 生成耗时较长：复杂文档需等待 5-10 分钟甚至更久，无法即时响应
• 输出可控性有限：最终排版和细节依赖云端模型，用户对中间环节的干预能力较弱
• 格式约束：不支持代码文件、短文本回答、临时笔记等非文档类输出场景

适合人群

• 商务人士：快速生成报告、提案、合同、计划书
• 学术研究者：撰写论文、文献综述、研究摘要
• 内容创作者：博客文章、小说、营销文案
• 求职者：简历优化、求职信撰写
• 多语言工作者：需要跨语言文档翻译和本地化

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据隐私 | 用户文件和请求原文上传至第三方服务器，需评估信任度 |

| 服务可用性 | 依赖 Skywork API 稳定性，网络中断或服务器故障会导致失败 |

| 内容准确性 | 自动联网搜索结果可能存在时效性或准确性问题，需人工复核 |

| 账户权限 | API Key 失效或额度不足会阻断服务，需及时续费或轮换密钥 |

核心用法

Skywork Document 是一个基于 Skywork Office Doc API 的专业文档生成工具。用户通过配置 SKYWORK_API_KEY 环境变量后，即可调用脚本创建各类文档。

工作流程：

1. 意图识别（必需）——分析用户需求，确认是否需要引用文件、输出语言（默认English）、格式（默认docx）及内容提示词
2. 文件解析（可选）——使用 parse_file.py 上传并解析参考文件，获取 file_id 供后续引用
3. 创建文档——使用 create_doc.py 生成文档，支持传入标题、内容描述、引用文件、语言和格式参数
4. 结果交付——返回 file_url（云端下载链接）和 file_path（本地自动下载路径）双重访问方式

支持的文档类型：报告、提案、博客、论文、小说、备忘录、信函、合同、计划、简历、研究摘要、学习笔记等。

显著优点

• 格式专业：原生支持 docx、pdf、html、markdown 四种主流格式
• 智能增强：API 自动进行网络搜索获取最新内容，无需手动准备材料
• 多语言支持：覆盖中英日韩法德西俄阿等十余种语言
• 文件引用灵活：可基于上传文件重写简历、总结论文、扩写大纲、翻译文档
• 实时进度反馈：通过 SSE 长连接实时显示生成进度，用户体验友好
• 代码质量高：仅使用 Python 标准库，无第三方依赖，无 CVE 风险
• 密钥管理规范：API 密钥通过环境变量读取，无硬编码敏感信息

潜在缺点与局限性

• 数据外传必需：用户文件和完整请求内容必须上传至 Skywork 服务器处理，无法本地离线运行
• 耗时较长：文档生成通常需 5-10 分钟，复杂文档可能更久
• 会员门槛：高级功能或大量生成可能触发 "Insufficient benefit" 限制，需升级账户
• 第三方依赖：核心功能完全依赖 Skywork 服务可用性，存在单点故障风险
• 隐私合规责任：用户需自行评估 Skywork 隐私政策，对敏感内容上传需额外谨慎

适合人群

• 职场人士：快速生成商务报告、提案、合同、备忘录
• 研究人员：基于文献自动生成综述、研究摘要
• 内容创作者：批量生成博客、小说、多语言内容
• 学生群体：整理学习笔记、生成简历、撰写论文
• 跨国团队：需要多语言文档协作的国际化工作环境

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据隐私 | 文件内容、请求文本上传至第三方 | 审阅 Skywork 隐私政策，避免上传含身份证号、银行卡、商业机密等敏感信息的文件 |

| 服务可用性 | 依赖 Skywork API 在线服务 | 关键文档建议本地备份生成方案 |

| 账户限制 | 可能触发用量上限 | 监控使用频率，必要时升级账户或轮换 API Key |

| 网络传输 | 虽用 HTTPS/TLS 1.2+，但仍属外发 | 确保网络环境可信，避免中间人攻击 |

安全评估摘要

该 Skill 通过静态代码分析与动态行为审计，获得 S 级安全评级（满分100得82分）。代码结构清晰，无危险函数（eval/exec/system），无混淆或编码隐藏，依赖风险极低。主要扣分项来自功能必需的数据外传行为——用户文件和请求内容上传至 Skywork 服务器，此风险已通过文档充分披露，建议用户知情同意后使用。