报表配置基础版

支持单一数据源的基础报表配置，提供字段映射、求和计数平均聚合及Markdown/JSON/CSV格式导出功能。

Install

openclaw skills install @thcjp/report-free

报表配置基础版

核心能力

单一数据源接入：支持 CSV、JSON、Markdown 表格等单一数据源的读取与解析
字段映射与基础聚合：将源数据字段映射到报表维度，支持求和、计数、平均值等基础聚合
基础过滤与排序：按字段值过滤行数据，按一个或多个字段升序/降序排序
标准格式导出：将结果导出为 Markdown 表格、JSON 或 CSV 格式
报表元信息记录：记录数据源、生成时间、记录数等基础元信息关键词: report

快速开始

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用场景

场景	输入	输出
销售汇总	CSV 销售明细	按产品汇总的销售额表
任务统计	JSON 任务列表	按状态分组的任务计数
日志分析	Markdown 日志表	按 ERROR 级别过滤的日志表
数据导出	任意支持格式源	转换为指定格式的文件

不适用于：多数据源合并、跨表关联（JOIN）、复杂时间序列预测、可视化图表生成、实时流数据处理等场景（请使用高级版）

使用流程

确认运行环境满足依赖说明中的要求
提供单一数据源路径与基础报表配置（字段映射、聚合方式、过滤条件）
解析数据源并按配置进行字段映射与聚合
生成报表内容并按指定格式导出
输出报表文件路径与元信息

输入格式

参数名	类型	必填	说明
source	string	是	数据源文件路径或内联数据
source_format	string	否	源数据格式，可选: csv/json/markdown，默认: csv
fields	array	否	字段映射列表，每项包含 source_field 与 target_field
aggregation	string	否	聚合方式，可选: sum/count/avg/none，默认: none
group_by	array	否	分组字段列表
filter	string	否	过滤表达式，如 "status=ERROR"
sort_by	string	否	排序字段，格式: field:asc 或 field:desc
output_format	string	否	输出格式，可选: markdown/json/csv，默认: markdown

输出格式

json

{
  "success": true,
  "data": {
    "report_path": "reports/summary_20260721.md",
    "row_count": 24,
    "columns": ["product", "total_sales", "order_count"],
    "aggregation": "sum",
    "group_by": ["product"],
    "preview": "| product | total_sales | order_count |\n|---|---|---|\n| 商品A | 12500 | 30 |",
    "metadata": {
      "source": "data/sales.csv",
      "source_format": "csv",
      "generated_at": "2026-07-21T10:30:00Z",
      "duration_ms": 1200
    }
  },
  "error": null
}

异常处理

错误场景	原因	处理方式
数据源不存在	路径错误或文件未找到	检查路径是否为绝对路径，确认文件存在
格式不匹配	source_format 与实际格式不符	提示用户提供正确的 source_format 或自动识别
字段缺失	fields 中指定的字段在源数据中不存在	列出实际可用字段，建议用户更正映射
聚合失败	聚合字段非数值类型	提示用户选择数值字段或更换聚合方式
网络错误	远程数据源连接超时	检查网络连接和配置后重试，建议优先使用本地数据源

依赖说明

运行环境

Agent平台: 支持SKILL.md规范的任意AI Agent
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

本Skill基于指令驱动，无需额外API Key（除内容中明确标注的外部API）

可用性分类

分类: MD+EXEC（）
说明: 基于Markdown的AI Skill，

案例展示

示例1：销售数据汇总

text

输入: source=data/sales.csv, aggregation=sum, group_by=["product"], output_format=markdown
处理: 解析 CSV -> 按产品分组 -> 对销售额求和 -> 导出 Markdown 表格
输出: reports/sales_summary.md，包含每个产品的总销售额

示例2：任务状态统计

text

输入: source=tasks.json, aggregation=count, group_by=["status"], output_format=json
处理: 解析 JSON -> 按状态分组 -> 计数 -> 导出 JSON
输出: reports/task_status.json，包含各状态的任务数量

常见问题

Q1: 如何开始使用报表配置基础版？

A: 查看使用流程章节，准备一个单一数据源文件（CSV / JSON / Markdown），然后按"输入格式"提供配置即可.

Q2: 遇到字段缺失怎么办？

A: 基础版会列出源数据中的实际可用字段，请根据提示更正 fields 配置后重试.

Q3: 报表配置基础版支持多数据源合并吗？

A: 不支持。基础版仅支持单一数据源的报表生成，如需多源合并、跨表关联（JOIN）、复杂调度与可视化图表，请升级至高级版.

Q4: 如何获取多源合并、可视化图表、定时调度等高级能力？

A: 这些属于高级版能力。基础版聚焦单一数据源的基础报表，如需复杂的数据整合与可视化能力，请升级至高级版.

错误处理

错误场景(续)	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	检查网络连接和配置后重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

已知限制

仅支持单一数据源，不支持多源合并与跨表关联（JOIN）
聚合方式仅支持求和、计数、平均值，不支持中位数、百分位、自定义聚合函数
不支持可视化图表生成（如柱状图、折线图、饼图等）
不支持定时调度与周期性自动生成
不支持实时流数据处理
过滤表达式仅支持基础相等比较，不支持复杂逻辑组合（AND/OR/NOT）