核心用法
Skywork Excel 是一款面向复杂数据处理场景的 AI 增强型技能，用户通过自然语言指令即可完成传统需要 Excel 高级技能才能完成的任务。该技能采用后端 Agent 异步处理架构，典型任务耗时 5-25 分钟，通过轮询日志方式跟踪进度。
主要工作流：
1. 启动任务：调用 excel_api_client.py 传入用户原始查询（严禁改写），通过 --files 参数上传 Excel/CSV/PDF/图片等文件，后端自动处理读取与解析
2. 轮询监控：每 60 秒执行一次独立查询，提取 TASK PROGRESS UPDATE 区块展示当前阶段（数据加载→分析→图表生成→文件输出），心跳检测确保任务存活
3. 结果交付：完成后同时返回 OSS 下载链接和本地绝对路径，支持一键分享与本地存档
多轮会话：通过 --session 参数延续上下文，支持"在此基础上添加饼图"等迭代式 refinement，避免重复上传文件重建上下文。
---
显著优点
功能覆盖全面：原生支持公式嵌入、数据透视表、动态图表、HTML 报告生成，以及 PDF/图片→表格的 OCR 转换，相当于将 Excel + Python + BI 工具的能力集成到自然语言接口中。
实时数据能力：内置网络搜索模块，可直接抓取股价、汇率、统计数据等时效性信息，解决传统静态模板的更新滞后问题。
专业场景深耕：针对财务建模、预算编制、销售预测等垂直场景优化，输出结果具备可直接投入业务使用的专业度。
跨语言支持：内置 zh-CN/en-US 等多语言参数，支持中文指令生成符合本地习惯的报表格式。
架构设计合理：状态外置到日志文件、轮询而非长连接、自动错误恢复，确保长时间任务的稳定性与可观测性。
---
潜在缺点与局限性
实时性受限：异步轮询机制意味着用户无法即时看到结果，复杂任务需等待数分钟，不适合需要秒级响应的交互场景。
网络依赖重：所有计算发生在 Skywork 云端，本地仅作为文件中转和日志展示层，弱网环境或 API 波动会直接影响可用性。
数据隐私风险：用户文件和提示词需上传至第三方云服务处理，涉及敏感业务数据时需评估合规性，SKILL.md 已明确披露此风险。
免费额度限制：日志中出现的 Insufficient benefit 提示表明存在使用配额或会员等级限制，重度用户需付费升级。
调试透明度低：任务黑盒运行在云端，用户只能通过进度日志感知状态，遇到复杂错误时难以本地介入排查。
---
适合的目标群体
- 业务分析师：需要快速从原始数据生成带可视化图表的管理层汇报材料
- 财务人员：进行预算编制、财务建模、多版本 scenario 分析
- 运营团队：定期抓取竞品价格、库存数据、行业指标并生成自动化周报
- 非技术用户：没有 Excel 高级技能（VBA、复杂公式），但需要专业级输出
- 多语言团队：需要中文/英文/日文/韩文等多语言报表输出的跨国协作场景
---
常规使用风险
性能风险：默认 900 秒超时对超大数据集可能不足，需主动配置 --timeout 1500；轮询间隔固定 60 秒，频繁任务会占用执行资源。
凭证管理风险：SKYWORK_API_KEY 是核心依赖，过期会导致 401 未授权错误；需避免硬编码或提交至版本控制，建议通过 Claude Code env 配置。
数据残留风险：临时日志写入 /tmp 目录，虽无敏感凭证但可能包含业务数据摘要，共享环境需定期清理。
服务连续性风险：依赖 Skywork 云服务的长期可用性，若服务下线或 API 变更，技能将完全失效，存在供应商锁定效应。
文件格式兼容性：PDF/图片转表格依赖 OCR 识别质量，复杂排版或扫描件可能出现结构错乱，需人工校验关键数据。