mcpField
C
custom-report

custom-report

github.com/openaccountant数据与数据库103426 次安装29 周前更新
代码仓库

关于 custom-report

custom-report 是用于生成财务报告的工作流技能，可按日期范围、类别、交易类型和金额门槛筛选。它将类别汇总与交易明细结合，并可导出为 CSV 或 Markdown。

主要功能

  1. 01按日期范围和类别筛选
  2. 02选择收入、支出或两者
  3. 03支持最低交易金额条件
  4. 04整合汇总数据与交易明细
  5. 05导出为 CSV 或 Markdown

适用场景

  1. 01生成指定季度的报告
  2. 02查看选定类别的支出
  3. 03导出筛选后的财务数据以供分析

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openaccountant/skills --skill custom-report

安装后在 Claude Code 中输入/custom-report确认已加载。

详细介绍

自定义报告

概述

通过指定日期范围、类别筛选条件、交易类型和输出格式，生成量身定制的财务报告。在一份报告中整合支出汇总和交易明细。

使用的 Wilson 工具

  • spending_summary — 汇总指定期间内各类别的支出
  • transaction_search — 提取符合筛选条件的详细交易记录
  • export_transactions — 将报告数据导出为 CSV 或 Markdown

工作流

  1. 询问用户报告应涵盖哪些内容：
    • 日期范围：具体日期、“过去 3 个月”、“2025 年第一季度”、“年初至今”
    • 类别：全部、指定类别，或排除某些类别
    • 交易类型：仅支出、仅收入，或两者均包含
    • 最低金额：可选阈值（例如，“仅包含金额超过 $50 的交易”）
  2. 使用 spending_summary 生成该日期范围内的类别汇总数据。
  3. 使用 transaction_search 提取符合筛选条件的单笔交易。
  4. 整理报告，包含：
    • 汇总表（各类别总额、百分比）
    • 按金额排列的主要交易
    • 各类别的交易数量和平均金额
    • 在报告顶部注明日期范围和筛选参数
  5. 询问用户所需的输出格式：终端显示、Markdown 文件或 CSV 导出。
  6. 如果选择 Markdown 或 CSV，则使用 export_transactions 写入文件。

不使用 Wilson

你可以在电子表格中创建自定义报告：

Google Sheets / Excel 设置
  1. 将交易记录导入或粘贴到包含以下列的工作表中：Date、Description、Amount、Category。
  2. 日期筛选：添加筛选条件，或使用 =FILTER(A:D, A:A >= DATE(2025,1,1), A:A <= DATE(2025,3,31)) 筛选 2025 年第一季度的数据。
  3. 类别汇总透视表：
    • 选择数据 > 插入 > 数据透视表
    • 行：类别
    • 值：金额总和、金额计数
    • 筛选条件：日期范围
  4. 手动汇总公式： 
    Total Expenses:  =SUMIFS(C:C, C:C, "<0", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
Total Income:    =SUMIFS(C:C, C:C, ">0", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
Category Total:  =SUMIFS(C:C, D:D, "Groceries", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
  5. 主要交易：按金额排序（支出金额最大的排在前面），并取前 10 笔。
CLI 替代方案（csvkit）
# Filter by date range
csvgrep -c Date -r "2025-0[1-3]" transactions.csv | csvsort -c Amount | head -20
# Summary by category
csvstat -c Amount --group Category transactions.csv

重要说明

  • 日期范围包含起止两端。
  • 支出汇总以绝对值（正数）显示支出金额，便于阅读。
  • 更改参数后可以重新生成报告，无需重新导入数据。
  • Markdown 导出会包含带有报告元数据（生成日期、应用的筛选条件）的 YAML 标头。

评论

支持 Markdown