excel-operations

star 3

Excel 报表生成技能。当需要导出监测数据表、统计汇总表或多期对比表为 .xlsx 文件时加载此技能,获取数据组织规范和工具调用指引。

railwise-cn By railwise-cn schedule Updated 3/2/2026

name: excel-operations description: Excel 报表生成技能。当需要导出监测数据表、统计汇总表或多期对比表为 .xlsx 文件时加载此技能,获取数据组织规范和工具调用指引。

适用场景

  • 监测日报/周报数据附表导出
  • 多测点多期次变形数据汇总表
  • 基坑支撑轴力统计表
  • 地下水位观测记录表
  • 测斜仪深层位移数据表
  • 任何需要以 Excel 格式交付给甲方或存档的结构化数据

可用工具

系统提供两个 Excel 导出工具,按场景选择:

excel_export(通用导出)

自由定义 Sheet 结构,适用于自定义格式的数据表。

参数说明:

参数 类型 说明
sheets 数组 工作表列表,每个包含 name/headers/rows
sheets[].name 字符串 Sheet 名称,如"沉降监测"、"轴力统计"
sheets[].headers 字符串数组 列标题
sheets[].rows 二维数组 数据行,元素可为字符串/数字/布尔/null
sheets[].columnWidths 数字数组 可选,各列宽度(字符数)
sheets[].freezeRow 数字 冻结前N行,默认1(冻结表头)
title 字符串 文件名(不含扩展名)
outputPath 字符串 可选,输出路径

monitoring_table_export(监测数据快捷导出)

专为监测数据设计,直接传入测点数据即可生成带预警标识的规范化报表。

参数说明:

参数 类型 说明
projectName 字符串 项目名称
monitoringType 枚举 settlement/displacement/axial_force/water_level/inclinometer/convergence
date 字符串 报表日期 YYYY-MM-DD
points 数组 测点数据列表
warningValue 数字 可选,预警值
alarmValue 数字 可选,报警值

数据组织规范

Sheet 命名

场景 推荐名称
地表沉降 地表沉降监测数据
桩顶位移 桩顶水平位移数据
深层位移 测斜仪深层位移
支撑轴力 支撑轴力监测数据
地下水位 地下水位观测记录
管片收敛 隧道收敛量测数据
数据汇总 监测数据汇总表

表头规范

标准监测数据表的列顺序:

测点编号 | 断面位置 | 初始值(mm) | 上期值(mm) | 本期值(mm) | 本期变化量(mm) | 累计变化量(mm) | 变化速率(mm/d) | 预警值(mm) | 状态

关键要求:

  • 数值列必须注明单位(mm、kN、m 等)
  • 变化量保留小数点后1位
  • 速率保留小数点后2位
  • 超限数据在"状态"列标注"⚠️预警"或"🔴报警"

多期数据对比表

当需要展示多期次数据变化时,按以下结构组织:

测点编号 | 第1期(日期) | 第2期(日期) | ... | 第N期(日期) | 累计变化量 | 状态

典型调用示例

沉降监测日报数据表

调用 excel_export,传入:
sheets: [{
  name: "地表沉降监测数据",
  headers: ["测点编号", "里程桩号", "初始值(mm)", "上期值(mm)", "本期值(mm)", "本期变化量(mm)", "累计变化量(mm)", "变化速率(mm/d)", "预警值(mm)", "状态"],
  rows: [具体数据行],
  freezeRow: 1
}]
title: "XX项目-沉降监测数据-20250301"

多项目汇总(多 Sheet)

调用 excel_export,传入多个 sheet:
sheets: [
  { name: "沉降监测", headers: [...], rows: [...] },
  { name: "位移监测", headers: [...], rows: [...] },
  { name: "轴力监测", headers: [...], rows: [...] },
  { name: "汇总统计", headers: [...], rows: [...] }
]
title: "XX项目-监测数据周报-第12周"

注意事项

  • 数据量大于 50 行时,优先使用 excel_export 而非在 Markdown 中写大表格
  • 报告正文(Word)中只放摘要表(关键测点、最大值、超限点),完整数据以 Excel 附件形式交付
  • monitoring_table_export 会自动根据预警值/报警值标注状态,优先使用
  • Excel 文件默认输出到当前工作目录
  • 工具生成的 .xlsx 文件兼容 WPS Office 和 Microsoft Excel
Install via CLI
npx skills add https://github.com/railwise-cn/RAILWISE-CLI --skill excel-operations
Repository Details
star Stars 3
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator