用途:该技能面向电子表格(Excel/CSV 等)相关的 Python 操作,核心要求是在任何读写、转换、公式或格式化操作之前,先验证源数据是否可访问且完整;若源数据不可用,则按回退协议尝试替代来源并清晰报告阻塞原因。
主要能力: 1)数据源可用性校验:检查文件是否存在、是否可读,缺失或不可访问时输出明确错误并返回失败。 2)表格结构完整性校验:使用 openpyxl 检查必须的工作表与列标题是否存在,捕获异常并输出错误。 3)外部数据源校验:用 requests 通过 HEAD 请求检查 API 或网站可达性,支持超时与有限重试。 4)替代来源机制:为关键数据预置主源、本地备份、联邦或手动获取等替代来源,依次尝试直到成功。 5)标准化错误报告:记录时间戳、来源、错误类型、已尝试的替代数量与所需人工动作。 6)推荐工作流:先将校验脚本与处理脚本写入 .py 文件,再用 python3 执行,如 python3 validate_sources.py || exit 1,随后运行处理脚本并可选清理。
使用方式(基于资料):先写校验脚本检查 Path 是否存在,再写入处理脚本调用 openpyxl/pandas 等库,最后依次执行。资料建议优先使用文件式执行而非 heredoc 内联,以减少 shell_agent 解析失败。
适用场景:源数据必须先验证的批处理、包含多工作表或复杂格式的 Excel 读写、需先访问外部数据源、涉及多步骤且可能超出智能体步数限制、需要精细错误处理与调试、以及需预先指定回退来源的任务。
限制与注意事项:不适用于单单元格简单读写、需要交互式输入、需要迭代调整策略、或源数据已确保可用的场景。常见问题包括 heredoc 语法失败、路径或权限错误、SSL/代理导致的外部源不可达、大文件内存错误、样式不生效等;资料建议对不可达源最多重试 3 次后切换替代源,并避免在单一源上耗尽大量迭代。未提供相关收费、价格或平台信息。