SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场performance-reporting

performance-reporting

数据与分析

查看项目

更新于 10-15 15:13

技能介绍

Performance Reporting 是 joellewis/finance_skills 中一个面向投资组合绩效报告生成的金融技能，定位于 Reporting & Communication（报告与沟通）。

【用途】 该技能用于生成清晰、准确的投资组合绩效报告，包含基准对比、归因分析和风险仪表盘。适用于需要向客户或机构汇报投资组合业绩、解释超额或落后原因、追踪目标达成进度的场景。

【主要能力】

  1. 收益报告：报告标准时间段收益，包括 MTD（月初至今）、QTD（季初至今）、YTD（年初至今）、1Y、3Y、5Y、10Y 以及自成立以来（需注明确切成立日期）。区分累计收益与年化收益，仅对大于 1 年的期间进行年化。区分费前与费后收益，费后收益为投资者实际体验，应作为主要呈现，若展示费前收益需同时展示费用拖累。区分时间加权收益（TWR，用于评估管理人能力）与资金加权收益（MWR/IRR，用于评估投资者实际结果）。机构报告需遵循 GIPS（全球投资绩效标准）要求。

  2. 计算引擎：scripts/performance_reporting.py 实现报告背后的收益计算。Modified Dietz（ModifiedDietz）通过对外部现金流按投资期间占比加权近似 TWR，公式为 R = (V_end - V_start - sum(CF)) / (V_start + sum(w_i * CF_i))，其中 w_i = (D - d_i)/D；在无每日估值时可作为 GIPS 可接受的近似。True TWR（TimeWeightedReturn）链结子期间收益，prod(1 + r_t) - 1，其年化辅助函数拒绝小于 1 年的期间。IRR / MWR（MoneyWeightedReturn）使用 Brent 求根法（scipy.optimize.brentq）在区间内数值求解 NPV(rate) = 0，返回年化资金加权收益。GIPS 组合（CompositeReturn）以期初值为权重计算资产加权组合收益，并提供等权收益以及 GIPS 要求的资产加权内部离散度（适用于 6 个以上组合）。标准期间（PeriodReturns）从日收益序列生成 MTD/QTD/YTD 式滚动窗口（1M 至 10Y）及成立至今收益，仅对 1 年及以上期间年化。

  3. 基准对比：强调孤立收益数字无意义，需基准提供上下文。基准须匹配组合的投资风格、地域、市值和资产类别构成，多资产组合使用混合基准，基准应可投资，需记录基准选择理由并保持一致以避免挑选有利基准。主动收益（alpha）为组合收益减基准收益。报告中同时呈现跟踪误差和信息比率。

  4. 风险仪表盘：当前快照指标包括年化波动率、最大回撤和当前回撤、95% 和 99% 置信水平的 VaR、相对基准的 Beta。滚动指标包括 12 个月滚动 Sharpe、12 个月滚动波动率、36 个月滚动 Beta、滚动回撤图。风险暴露分解包括行业集中度与相对基准权重、因子暴露（价值、成长、动量、质量、规模）、地域配置、久期与信用质量（固收）。

  5. 归因摘要：Brinson 归因（配置、选择、交互）与因子分解，报告中每个效应用一句通俗语言总结。列出贡献最大正负的前 5-10 只持仓，展示持仓收益及其对组合总收益的贡献（权重 x 收益），并提供简要评论。

  6. 目标进度追踪：进行是否按计划进行的评估（领先、落后或超前），使用蒙特卡洛模拟估计达成目标的概率，比较所需收益与预期收益以标记规划缺口，以资金到位百分比表达进度。

  7. 可视化最佳实践：1 万美元增长图（长期使用对数刻度）、滚动收益图、回撤图、资产配置饼图/柱状图、风险-收益散点图。

  8. 报告频率与结构：月度简报 1 页，季度详细报告 3-5 页，年度综合报告 8-15 页。

  9. 通俗语言沟通：将数字转化为含义，说明绩效相对预期和计划的好坏，使用受众易懂的类比，首次使用术语时定义，先给结论再给细节。

【使用方式】 运行脚本：使用 uv run scripts/performance_reporting.py（PEP 723 头部自动解析 numpy/scipy），或在 pip install numpy scipy 后使用 python3 scripts/performance_reporting.py。裸运行会打印五个演示：Modified Dietz 收益、链结 TWR、通过 Brent 法求解的 IRR、GIPS 组合摘要和标准期间收益表。使用 --verify 断言演示输出与预期值匹配（PASS 时退出码 0），使用 --help 查看类概览。该文件主要作为模块导入使用（如 from performance_reporting import ModifiedDietz, MoneyWeightedReturn）。

【适用场景】 提供两个工作示例：季度绩效报告摘要（平衡型组合 60/40，Q3 收益 3.2% 对基准 2.8%，YTD 8.1% 对 7.5%）和退休资金目标进度（目标 200 万美元，当前 85 万，15 年期限，蒙特卡洛显示 68% 成功概率）。技能还列出常见误区，如挑选有利时间段、只展示收益不展示风险、使用不恰当基准、术语过多、对短期间进行年化、只展示 TWR 而忽略资金流影响、组合报告中的生存者偏差、忽略税收等。

【限制】 该技能的收益率、风险指标、归因方法等计算依赖数据质量；GIPS 合规需要验证计算与完整披露。工具未提供实际数据源或数据获取方式，未说明收费或价格信息，未提供官方网页以外的平台与效果说明。