SuperAPI AI 工具集

artifact_spreadsheet

办公与效率

查看项目

更新于 10-15 17:19

技能介绍

用途:创建、读取、编辑、修复或清理电子表格文件(.xlsx、.xlsm、.csv、.tsv)。当构建任务的产物类型为电子表格,或任务点名电子表格时使用。

主要能力与工具选择:用预装的 openpyxl 生成 xlsx,生成脚本放在 .src/ 下作为可编辑源;muse.read 将现有表转换为 markdown 分页查看,但不含单元格坐标,不能据此规划编辑;读取工作簿模型(公式及其值)用两次 load_workbook;批量或杂乱表格数据用标准库 Python csv,确需时运行 pip install --break-system-packages pandas;设计、结构、数字格式与模型约定见 /opt/hatch/skills/artifacts/spreadsheet/references/visual.md;公式、重算、编辑现有工作簿见 /opt/hatch/skills/artifacts/spreadsheet/references/formulas.md。

交付要求:设置非空 workbook.properties.title 和可读文件名;数据只能来自构建收集的内容,没有的值留空或标记疑问,不得编造;写公式而非预计算结果,如 sheet["B10"] = "=SUM(B2:B9)",使输入变化时工作表可重算;严格按用户规格,使用其指定的工作表名、列标题和公式;交付时公式零错误,须运行重算门禁并修复所指问题;在读者可见处(单元格注释或相邻标注单元格)记录假设和硬编码数字,注明真实来源或说明来自用户;供他人填写的文件需附简短图例说明可编辑单元格并给一行真实示例值,但不能在被要求编辑的文件中加示例行。

脚本与验证:/opt/hatch/skills/artifacts/scripts/recalc_xlsx.py 通过无界面 LibreOffice 就地重算,并以 JSON 报告所有公式错误单元格,凡是含公式的文件必须运行,errors_found 时退出码为 0,应读 JSON 而非退出码;/opt/hatch/skills/artifacts/scripts/validate_xlsx.py 做读回检查,包括 zip 完整性、工作表部件、填充单元格计数,失败时不要交付链接,csv 输出不做读回检查。验证顺序:先运行 recalc_xlsx.py(存在公式时),再运行 validate_xlsx.py,然后按 /opt/hatch/skills/artifacts/testing/SKILL.md。重算干净只证明公式可求值,不证明其正确,建完整网格前应抽查两三个公式是否取到预期值。

限制:资料未提供收费、价格、平台支持范围、运行环境要求等更多信息。