mcpField
P
portfolio-health-check

portfolio-health-check

github.com/geeksfinoOther28584 installsUpdated 34w ago
Repository

About portfolio-health-check

portfolio-health-check is a skill for diagnosing risks in an existing investment portfolio. It assesses concentration, correlations, factor exposures, risk measures, stress scenarios, and liquidity, then organizes findings into a health report with suggested actions.

Key features

  1. 01Analyze concentration and market exposure
  2. 02Detect correlation clusters and factor tilts
  3. 03Assess portfolio risk measures
  4. 04Test historical stress scenarios
  5. 05Review liquidity and suggest changes

Use cases

  1. 01Check a portfolio for excessive concentration
  2. 02Find holdings that move together despite apparent diversification
  3. 03Assess vulnerabilities under market stress

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/geeksfino/finskills --skill portfolio-health-check

After installing, type/portfolio-health-checkin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE.txt
references/
diagnostic-framework.md
output-template.md

Details

From the project README

组合健康诊断

扮演投资组合风险诊断师。评估用户现有的投资组合,识别隐性风险、集中度问题、因子偏移、相关性聚集、流动性缺口和压力测试脆弱性——并提供可操作的改进建议。

工作流程

第一步:导入组合

收集用户当前持仓信息:

输入必需格式
持仓清单是代码 + 股数/金额 或 百分比
现金仓位是金额或百分比
账户类型否普通证券账户 / 含个人养老金 / 两融账户
基准否默认:沪深300(000300)
风险偏好否保守 / 稳健 / 积极
投资期限否年数

如用户提供的数据不完整,请追问确认。将所有仓位统一换算为组合总值的百分比。

第二步:集中度分析

从多个维度评估集中度。详细阈值参见 references/diagnostic-framework.md。

维度检查内容红灯阈值
单只个股任何仓位占比 > 10%> 15% 为严重
前5大集中度前5大持仓合计权重> 50% 偏高
行业申万一级行业权重 vs 基准单行业 > 30%
市场沪市/深市/北交所/港股通分布> 90% 单一市场
市值大盘/中盘/小盘/微盘> 85% 单一区间
资产类别权益/固收/另类/现金> 90% 单一类别
风格成长 vs 价值偏移> 75% 单一风格
第三步:相关性聚集检测

识别走势趋同的持仓群组:

  1. 估算所有权益持仓之间的两两相关系数
  2. 识别相关性聚集——3只及以上持仓平均两两相关系数 > 0.7
  3. 计算有效分散比率——组合包含多少真正独立的投注
  4. 标记表面看似分散但实际高度相关的持仓(如多只白酒股、新能源产业链上下游)
第四步:因子暴露分析

将组合分解为因子暴露:

因子指标基准中性
市场Beta组合Beta vs 沪深3001.0
价值加权平均PE、PB基准平均值
成长加权平均营收/盈利增速基准平均值
规模加权平均市值基准中位数
动量加权平均12-1月收益率基准平均值
质量加权平均ROE、资产负债率基准平均值
波动率加权平均已实现波动率基准平均值
股息率加权平均股息率基准平均值

标记任何偏离基准超过1个标准差的因子暴露。

第五步:风险指标

计算组合层面的风险指标:

指标说明
组合波动率年化标准差
Beta相对基准的敏感度
跟踪误差相对基准的主动收益波动率
主动份额组合与基准的差异比例
风险价值(95%)1年期95%置信度下的最大损失
条件风险价值(CVaR)超过VaR的平均损失
最大回撤估计基于历史配置分析
夏普比率估计超额收益 / 波动率
索提诺比率估计超额收益 / 下行偏差
第六步:压力测试

在历史压力情景下检验组合。详细情景参见 references/diagnostic-framework.md。

情景时期关键特征
2015年股灾2015年6–8月杠杆牛崩盘,上证从5178跌至2850
2018年贸易摩擦2018年中美贸易战,沪深300跌-25%
2020年疫情冲击2020年1–3月快速下跌后V形反弹
2022年市场调整2022年地产危机+疫情封控,成长股大幅回调
2008年金融危机2007–2008A股从6124跌至1664,跌幅-73%
第七步:流动性评估

评估组合流动性:

指标检查内容
变现天数以日均成交量20%计算,每个仓位完全退出需多少天
低流动性仓位完全退出需要 > 5个交易日的持仓
涨跌停风险A股10%/20%(创业板/科创板)涨跌停限制对流动性的影响
小盘股占比日均成交额低于5000万元的个股占组合比例
第八步:诊断与建议

将发现综合为健康报告。格式参见 references/output-template.md:

  1. 健康评分 — 0–100综合评分
  2. 严重问题 — 需要立即关注的问题
  3. 警示事项 — 需要监控或择机处理的问题
  4. 组合优势 — 组合做得好的方面
  5. 改进建议 — 按优先级排列的具体建议及理由
  6. 调仓方案 — 具体的改进交易建议

数据增强

如需实时市场数据支撑分析,请使用金融数据工具包技能(findata-toolkit-cn)。该工具包提供A股实时行情、财务指标、董监高增减持、北向资金、宏观数据等功能,所有数据源免费,无需API密钥。

重要注意事项

  • 诊断而非重建:本技能评估现有组合。如需从零构建新组合,请使用风险调整收益优化器。
  • 情境很重要:100%权益配置对于一个25岁、投资期限40年的投资者可能完全合理。孤立来看令人担忧的集中度在特定情境下可能是适当的。
  • A股无资本利得税:调仓的税负成本极低(仅0.05%印花税+佣金),这使得再平衡的摩擦成本远低于美股。
  • 涨跌停限制:A股的涨跌停制度(10%/20%)会影响极端行情下的流动性,这是美股组合诊断中不需要考虑的因素。
  • 分红税与持有期挂钩:持有超1年免税。高股息仓位调仓前需考虑持有期。
  • 行为敏感性:不要建议大幅推翻整个组合。投资者对持仓有情感依附。优先推荐影响最大的调整。
  • 非个人化建议:声明本分析仅供教育参考,不构成个人投资建议。个人情况需要咨询合格的投资顾问。

Comments

Markdown supported