关于 tres-report-analyzer
用于分析 TRES Finance 的 XLSX 报告导出并总结可执行发现的技能。它根据工作簿结构识别报告类型，执行针对性检查，并突出异常、指标和后续行动。
主要功能
- 01根据工作表和列识别报告
- 02使用 Python 脚本提取指标
- 03检查差异和报告特定指标
- 04总结发现并提出行动建议
适用场景
- 01检查对账失败项
- 02查找重大余额变化或持仓
- 03分析已实现收益和交易模式
- 04检查 ERP 配置及同步失败
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/tres-report-analyzer确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/analysis-playbook.mdscripts/analyze_report.py详细介绍
TRES 报告分析器
你可以分析 TRES Finance 报告导出文件（XLSX 文件），并生成清晰、可执行的结果摘要。目标是自动提炼最重要的信息，帮助用户省去数小时的手动电子表格审查工作，包括异常、未通过的检查、大幅变动和关键指标。
工作原理
- 识别报告类型：根据上传文件的工作表名称和列标题判断
- 运行分析脚本：执行针对特定报告的检查
- 呈现发现结果：以结构化摘要展示，并将最重要的内容放在前面
第 1 步：识别报告类型
用户上传 XLSX 文件后，首先识别它属于哪种 TRES 报告。主要依据工作表名称进行判断：
| 工作表特征 | 报告类型 |
|---|---|
Summary、Inventory Reconciliation、Running Token Reconciliation、Running Fiat Reconciliation、Historical Token Reconciliation、Historical Fiat Reconciliation、Roll Forward Reconciliation | 账本对账 |
Summary Per Asset、Summary Per Year、Summary per Tx Activity、raw_data（含有 Realized Gain 列） | 已实现盈亏 |
By Asset、By Wallet、By Platform、By Position、Cost Basis、raw_data（含有 Previous Amount 列） | 余额趋势 |
By Asset、By Wallet、By Platform、By Position、Cost Basis、raw_data（不含 Previous Amount 列） | 资产余额 |
By Asset、By Wallet、By Platform、By Position、Cost Basis、raw_data（含有 Historical Balance 列，且已启用 Time Capsule） | 历史余额格式 |
Asset Balances - PT、Cost Basis、raw_data | 资产余额 V2 |
Fiat Value Summary、Amount Summary By Application、Amount Summary、raw_data | 资产余额 - 存档 |
Overview、raw_data（含有 Safety Check 列） | 资产滚转 |
Summary、Inventory Reconciliation、raw_data（含有 Cost Basis 列，约 29 列） | 成本基础滚转 |
Chart of Accounts Summary、raw_data（含有 Configuration Status） | ERP 同步前 |
单个 raw_data 工作表，含有 COGS Lot 列 | 成本明细 |
单个 raw_data 工作表，含有 Rollup Parent TX Hash | 汇总明细 |
单个 raw_data 工作表，约 8 列，含有 Sync Status | ERP 同步后 |
单个 raw_data 工作表，含有 Price Source 列 | 资产法币价值 |
单个 raw_data 工作表，含有 Purchase Date、Remaining Quantity | 成本基础堆栈 |
单个 raw_data 工作表，含有 Sub TX Index、Is Taxable | 成本基础库存 |
单个 raw_data 工作表，含有钱包注册表列 | 组织钱包 |
单个 raw_data 工作表，含有基本交易列 | 交易账本 |
如果无法识别报告类型，请告知用户，并请他们确认报告类型。
第 2 步：运行分析
使用 scripts/analyze_report.py 中的 Python 脚本，从 XLSX 文件中提取数据。按如下方式运行：
python /path/to/skill/scripts/analyze_report.py "/path/to/uploaded/file.xlsx" --output /path/to/output.json
脚本会输出一个包含提取指标的 JSON 文件。如果脚本运行失败，或脚本尚不支持该报告类型，则改为直接使用 openpyxl 读取文件并进行分析。
按报告类型进行分析
阅读 references/analysis-playbook.md，了解每种报告类型的详细分析清单。一般模式如下：
对账报告（Ledger Reconciliation、Asset Roll Forward、Cost Basis Roll Forward）：
- 检查列：通过和未通过的数量分别是多少？
- 哪些资产或钱包的差异最大？
- 滑点或差额总计是多少？
- 是否存在规律（同一个钱包、同一项资产、同一个平台）？
余额报告（Asset Balances、Historical Balance Format、V2、Archives、Balance Trends）：
- 投资组合总价值
- 按法币价值排名的主要持仓
- 是否存在余额为零或负数的条目？
- 对于 Balance Trends：变动最大的项目（绝对变化最大）
- 未验证的代币或缺失的价格
交易报告（Transaction Ledger、Realized Gains & Losses、Cost Breakdown）：
- 交易总数和日期范围
- 按法币价值排名的最大交易
- 已实现收益／亏损总额（如适用）
- 分类明细（每种类型各有多少笔）
- 是否存在未分类的交易？
成本基础报告（Cost Basis Stack、Cost Basis Inventory、Cost Basis Roll Forward）：
- 成本基础总额和未实现收益
- 未实现亏损最大的批次（税损收割的候选批次）
- 批次持有时长（是否有非常早的批次？）
- 减值金额（如适用）
ERP 报告（Pre-Sync、Post-Sync）：
- 配置状态明细（已就绪和配置错误的数量分别是多少）
- 缺失的账户映射
- 同步失败情况及错误规律
- 借贷余额检查
步骤 3：呈现发现
按以下结构组织回复。保持简洁——用户需要的是洞察，而不是数据堆砌。
格式
用一行说明报告类型及其涵盖的期间。
然后按重要性依次呈现发现：
- 警示事项（如有）：检查未通过、重大差异、缺失数据、同步失败
- 关键指标：总价值、数量、收益／亏损——最重要的数字
- 值得关注的项目：最大交易、主要持仓、变动最大的项目——值得了解的信息
- 后续操作（如有）：用户应调查或修复的具体事项
最后简短说明用户可以提出哪些后续问题（例如：“如果你想深入了解，我可以进一步分析任何特定资产或钱包。”）。
风格规则
- 使用数据中的实际数字，不要使用含糊的描述
- 对较大的数字进行合理取整（$1,234,567.89 -> $1.23M）
- 不要使用 em-dash 或 en-dash（改用 --）
- 总回复控制在 500 个词以内，除非用户要求提供更多详情
- 如果发现较多，优先列出最重要的 5 项，并说明用户还可以询问“N 项其他发现”