表格魔技
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-neowotech/table-magic-skill。
技能介绍
解决什么具体问题
Excel 自动化最常见的痛点是工具碎:想改一个单元格,要先开文件、再定位工作表、再写值;想批量写数据,又担心逐格调用把一次请求拖成几百次往返。很多 workflow 还会隐式假设本机装好 Microsoft Excel、Office 兼容组件,甚至打印机驱动,可 Agent 运行时通常是在一台没登录 Windows、没安装 Office 的机器上执行。
技能如何工作
表格魔技(TableMagic Skill)把这类需求收敛到 111 个 Excel 相关工具上。它按 Excel 对象模型组织能力:
- 工作簿/工作表:
create_workbook、open_workbook、create_worksheet、rename_worksheet、copy_worksheet、freeze_panes - 单元格/区域:
set_cell_value、get_range_values、clear_range、copy_range - 格式:
set_cell_format、set_border、merge_cells、set_column_width、insert_rows - 分析:
create_chart、create_pivot_table、get_range_statistics、calculate_profit_margin - 数据处理:
split_sheet_by_column、merge_sheets、export_sheets、transpose_columns
对 Agent 来说,最有价值的是面向表格而不是面向单个单元格的入口:用复合工具把多次操作打包成一次调用。
核心工作方式:
- 打开或创建工作簿。
- 定位到目标工作表/区域;必要时先读取已有结构。
- 优先使用复合工具:一次写入
headers + data,而不是逐格set_cell_value。 - 对多步骤动作使用
batch_call,在一次 MCP 调用里执行多步,减少进程创建和协议往返。 - 完成后保存、导出或继续后续处理。
数据库与 API 能力用于把外部数据拉进 Excel:connect_database 连接 SQL Server、MySQL、PostgreSQL、SQLite;execute_query 把查询结果写入工作表;fetch_api_data 从 REST API 取数。邮件群发、二维码、发票 OCR、PDF 导出等工具则覆盖本地文件操作之外的场景。
运行时是 sidecar 形态:MCP 协议通过 stdio 通信,Agent 与工具进程保持常驻连接,而不是每次调用都启动新进程。Windows x64 预编译包内嵌 .NET 运行时,使用 ClosedXML 读写 Excel,PDF 导出使用 QuestPDF。
关键执行约束
这个技能对 Agent 明确要求不要猜参数。缺少文件名、工作表名、区域、行列号或其他必需参数时,必须向用户追问,不使用含糊默认值。数据格式按 Excel 习惯约定:行列号从 1 开始,范围使用 A1:D10,颜色支持中文名和 #RRGGBB。
参数引导规则在批量操作中尤其重要:例如用户只说“创建一个表格”,Agent 应追问工作簿文件名、工作表名、表头和数据内容,而不是自动生成一个名为 example.xlsx 的文件。
适用边界与注意点
预编译二进制只支持 Windows x64。Linux、macOS、Windows ARM64 和 x86 环境需要自行从源码构建对应 RID 的 self-contained 包。运行前需要完成下载脚本获取 tablemagic.exe 和 LatoFont/;二进制本体约 55MB,首次安装会检查环境并校验文件完整性。
正确执行路径是技能安装目录下 prebuilt/tablemagic.exe,而不是项目里的 bin、obj 或源码目录。可执行文件缺失时要先补下载再调用。PDF 导出依赖 Lato 字体,字体数量不足时需重新补齐。外部 OCR 工具 PaddleOCR 缺失时,ocr_invoice 会返回安装提示,应由用户完成后再继续。
从工程角度看,它适合把 Excel 当作高价值交付物、把程序化生成表格作为核心流程的 Agent。若只是临时编辑少量单元格,直接写脚本可能更轻;如果需要公司级权限、审计和集中管理,仍需结合外部系统继续约束。
使用场景
- 运营拿到业务库的报表查询结果,需要定期导出为带格式的 Excel 文件分发给团队
- 销售经理按地区汇总全年数据后,需要按列拆分成多个独立工作簿分别存放
- 财务处理月度工资数据时需要生成工资条,并通过 SMTP 按行群发给员工
- 数据分析师把多张明细表合并进汇总工作簿后,需要生成数据透视表和对比图表
适合人员
- 需要把数据库查询结果定期变成 Excel 报表的后端工程师或数据工程师
- 每月处理工资条、对账单批量生成与邮件发放的财务或薪酬专员
- 每天拆分和合并多份销售、库存表格的运营专员
- 为团队开发 Excel 自动化 MCP 工具、需要现成表格工具集的应用开发者