| name | bank-t185-wealth-management-volatility-explanation-assistant |
| description | 当用户需要在银行财富管理场景下，对客户持仓波动进行成因拆解、指标解读、驱动项归因并输出可沟通的解释与后续动作建议时使用本技能。适合在持仓波动沟通、客户陪伴或阶段性诊断场景中触发。 |
客户持仓波动解释助手
本技能用于在银行财富管理场景中，围绕客户持仓波动进行结构化解释与沟通输出。目标是把“波动事实、成因拆解、风险提示、后续动作”拆开讲清楚，并在信息不足时给出清晰的补充清单与风险边界。
适用范围
- 面向理财经理、财富顾问、私行团队的客户陪伴与波动沟通
- 组合阶段性回撤/上涨解释、资产大类贡献归因、单品种波动说明
- 需要把量化数据转化为可解释的业务话术与行动建议
何时使用
- 需要对客户持仓的区间波动进行成因拆解与归因说明时
- 需要形成“可直接向客户解释”的结构化输出时
- 需要同步补件清单、后续追问方向和风险提示时
何时不要使用
- 需要正式估值报告、审计或法律意见才能下结论的场景
- 只有口号、没有任何事实或数据支撑的波动解释需求
- 试图将本技能输出作为收益承诺或适当性审批依据时
默认工作流
- 明确诊断对象、时间区间、基准口径与客户关注点
- 汇总持仓数据，计算组合收益与资产大类贡献
- 定位单品种贡献，识别集中度与结构性驱动
- 结合市场事件，形成“事实-解释-推断”三层输出
- 输出客户可理解的解释稿、后续动作与待补信息清单
输入要求
- 客户信息：风险偏好、投资目标、期限与流动性约束
- 持仓信息：资产名称、资产类别、权重、区间收益
- 诊断口径：观察区间、估值时点、基准或对比口径
- 市场信息：关键事件、市场摘要或策略观点
输出要求
- 波动结论摘要与关键证据
- 资产大类与单品种贡献清单
- 风险提示、集中度/结构性问题提示
- 客户可理解的话术版本与下一步沟通建议
- 待补充信息清单与优先核验项
风险与边界
- 不得承诺收益、保证回本或绕过适当性要求
- 不得把相关性直接写成因果关系
- 不得把推断性内容写成确定性结论
- 不得伪造市场事件、产品材料或监管口径
信息不足时的处理
- 先列出已确认事实，再明确缺失字段
- 对缺失的关键口径标注“待补充/待确认”
- 输出以框架+待补清单为主，不输出强结论
配套脚本
当需要稳定复用的归因口径、结构化报告或批量处理时，使用脚本输出标准化结果。
scripts/volatility_explainer.py
功能：
- 计算组合区间收益、资产大类贡献、单品种贡献
- 识别集中度风险与核心驱动
- 输出结构化 JSON 或 Markdown 报告
输入格式（JSON 示例）：
{
"client": {
"name": "张三",
"risk_profile": "稳健",
"investment_goal": "稳健增值",
"horizon": "3-5 年",
"liquidity_needs": "中等"
},
"portfolio": {
"as_of_date": "2026-03-01",
"period": "2026-02-01 ~ 2026-02-29",
"total_value": 1200000,
"base_currency": "CNY",
"positions": [
{"name": "权益A", "asset_class": "权益", "weight": 0.35, "return_pct": -0.042},
{"name": "固收B", "asset_class": "固收", "weight": 0.45, "return_pct": 0.006},
{"name": "另类C", "asset_class": "另类", "weight": 0.20, "return_pct": -0.015}
]
},
"benchmark": {"name": "稳健组合基准", "return_pct": -0.018},
"market": {
"summary": "权益市场波动放大，利率曲线小幅下行",
"key_events": ["权益板块估值回调", "利率中枢下移"]
}
}
命令行示例：
python scripts/volatility_explainer.py --input input.json --format markdown --output report.md
输出说明：
markdown：用于客户沟通或内部汇报的结构化说明json：用于后续系统处理或二次加工
scripts/run_skill.py
功能：
- 快速调用
volatility_explainer.py 的入口脚本
交付标准
- 输出必须回答“现在发生了什么、为什么、下一步怎么做”
- 输出中明确区分事实、解释和推断
- 输出可直接用于客户沟通或内部复核
- 对缺失信息明确给出补充清单与优先核验项
