该技能用于在用户要求创建、修改、分析或可视化电子表格(.xlsx、.xls、.csv、.tsv)时,快速产出正确、规范的工作簿成品,评判标准包括布局、可读性、样式、行业惯例与正确性。
用途:面向财务、分析、研究、运营、仪表盘等任务,目标是达到分析师手工搭建的水平,而非仅是可用的表格。默认结构建议为:执行摘要或仪表盘、来源/假设、模型/明细表。模板或跟踪表等简单任务可优先快速完成。
主要能力:使用已安装的 @oai/artifact-tool JS 包进行创作、编辑、检查、渲染与导出;支持用 Workbook.create() 新建、importXlsx 导入、Workbook.fromCSV 读入 CSV。支持批量写入 range.values / range.formulas、fillDown/fillRight、动态数组公式锚点写入、数据校验、条件格式、图表、冻结窗格、筛选、表格结构等。可用 inspect 检查值/公式、扫描公式错误,用 render 渲染做视觉校验。
使用方式:优先用一个可执行的 .mjs builder 文件,从可写的会话专属临时或工作目录运行,不使用 NODE_PATH,不在 heredoc 内写脚本,不复制依赖目录。迭代时补丁并重跑同一文件。多工作表时先填非公式数据与表,再写跨表公式。分析可在 JS 或公式中完成,必要时用内置 Python(pandas/numpy)并把结果存为 JSON/CSV 供 builder 读取。最终导出:await SpreadsheetFile.exportXlsx(workbook),保存到 outputs/<unique_thread_id>/。交付回复需含简短摘要与最终 .xlsx 的 Markdown 链接,格式如 Revenue Model - model.xlsx,每行一个链接,不加反引号或项目符号。
限制:未明确提供价格、平台支持范围与效果数据。不要使用 openpyxl、xlsxwriter 或 pandas.ExcelWriter 作为替代,除非用户明确要求回退方案。避免无约束自动适配导致的过大宽高;派生值须为公式而非硬编码,不用魔法数字。编辑现有表时,若指定了单元格/行列范围则只改该范围,但需同步更新依赖的图表与条件格式。首次报错应先读错误、必要时对精确 API 执行一次 workbook.help 查询,再做最小补丁重试,避免无限循环。完成任务需满足:内容已填充且公式可计算、关键范围无公式错误、已导出、布局清晰可读。导出前至少对全部工作表做一次视觉检查,修复空白或损坏图表、被裁剪表头或数字、不可读颜色、明显公式错误等严重缺陷。