| name | portfolio-attribution-assistant |
| description | 当用户需要对基金、组合、账户或策略进行收益归因分析时使用本技能，尤其适用于需要拆解总收益来源、
识别行业配置贡献、个券选择贡献、风格因子贡献、仓位变化影响、相对基准超额来源、阶段性胜负手的场景。
当用户提到“组合归因”“收益归因”“超额收益拆解”“行业贡献”“选股贡献”“配置贡献”“Brinson归因”
“行业数据支持”“基金组合分析”“相对基准表现解释”等需求时，应优先调用本技能。
本技能特别适用于公募基金、专户组合、研究组合、策略回测结果的归因分析，且在存在较完整行业分类、行业收益、
基准权重、组合持仓权重和价格/收益数据时效果最佳。
|
技能概述
本技能用于支持基金与投资组合的收益归因分析，帮助使用者回答“收益从哪里来、超额从哪里来、哪些行业和个券贡献最大、
业绩是否来自可持续能力还是阶段性暴露”这类问题。
本技能特别强调行业数据支撑。在基金投研分析场景中，行业维度常常是最重要的中观归因层。若缺少统一行业分类、
行业收益序列、行业基准权重或组合穿透持仓，则归因解释力度会明显下降。输出时必须明确说明：哪些结论是强证据，
哪些只是弱推断，哪些仍需补充数据验证。
适用范围
- 基金产品收益归因
- 组合相对基准超额收益归因
- 行业配置贡献与选股贡献分析
- 风格与因子暴露解释
- 阶段性收益来源拆解
- 组合经理复盘、路演材料、投委会分析、业绩解释
不适用范围
- 缺少最基本收益序列和持仓信息，无法形成有效归因框架
- 用户要求给出确定性的投资建议或未来收益承诺
- 仅凭单一时点持仓就要求做高可信动态归因，且没有区间交易/估算规则
- 数据口径严重冲突且无法校准时，不应给出看似精确的结论
输入要求
优先级从高到低如下：
- 组合区间收益、基准区间收益
- 组合区间持仓权重或多个观察点持仓
- 基准成分及权重
- 统一行业分类映射表
- 行业区间收益数据
- 个券区间收益数据
- 风格因子暴露或风格标签
- 换手、仓位、现金比例等辅助数据
若缺少行业数据，必须在结果中显式标注：
- 行业配置贡献只能粗略估计
- 行业内选股贡献可信度下降
- 归因结果更适合作为解释性草案，而非正式投研结论
核心任务
- 建立归因口径
- 明确分析对象、比较基准、分析区间、收益口径、行业分类口径
- 拆分总收益来源
- 拆解行业归因
- 识别关键贡献项
- 贡献最大的行业、拖累最大的行业、贡献最大的个券、拖累最大的个券
- 识别风格与结构特征
- 输出业务可读结论
推荐工作流
第一步：确认归因框架
优先采用以下层级：
- 总收益归因
- 资产层归因（若有股票/债券/现金/衍生品）
- 行业层归因
- 个券层归因
- 风格层归因
若数据较全，可使用经典的配置/选股拆解思路；若数据不全，可采用简化解释框架，但必须说明简化假设。
第二步：统一数据口径
必须检查以下问题：
- 组合和基准是否使用同一分析区间
- 行业分类是否统一
- 收益率是否采用同一复权口径
- 持仓权重是期初、期末、均值还是估算均值
- 个券是否存在停牌、退市、复权异常
- 港股、美股、ETF、可转债等是否单独归类
第三步：进行行业归因
在行业数据较完整时，至少输出：
- 各行业组合权重与基准权重差异
- 各行业区间收益
- 行业配置贡献
- 行业内选股贡献
- 行业总贡献排序
第四步：进行个券与风格补充解释
对贡献靠前和拖累靠前的个券进行解释，结合风格暴露补充回答：
- 组合赚钱主要靠哪些个股/主题/风格
- 超额是否集中于少数行业或少数个券
- 业绩是否存在较强偶然性或集中度风险
第五步：形成结论与建议
输出时至少回答：
- 组合收益和超额收益主要来自哪里
- 最重要的行业贡献项是什么
- 最重要的个券贡献项是什么
- 当前业绩解释中最有说服力的数据证据是什么
- 当前分析最明显的数据缺口是什么
- 下一步还应补充哪些行业数据或估值数据
输出要求
最终输出应尽量包含以下模块：
- 执行摘要
- 归因口径说明
- 收益总览
- 行业归因结果
- 个券贡献结果
- 风格暴露与结构特征
- 主要正向贡献与负向拖累
- 风险提示与数据缺口
- 后续跟踪建议
风险与合规边界
- 不得将归因结果表述为未来收益保证
- 不得在证据不足时把相关性解释成稳定能力
- 不得在行业分类口径冲突时硬性输出精细行业结论
- 对估算口径必须显式披露
- 当行业数据不足时，必须降低结论强度
文件使用说明
- 详细业务规则：见
references/attribution_methodology.md
- 行业数据要求：见
references/industry_data_requirements.md
- 常见问题与红旗：见
references/common_risks_and_pitfalls.md
- 输出结构：见
references/output_schema.md
- 报告模板：见
assets/templates/portfolio_attribution_report_template.md
- 数据缺口提示模板：见
assets/templates/data_gap_notice_template.md
脚本说明
scripts/industry_weight_mapper.py：将持仓映射到行业并汇总行业权重scripts/brinson_attribution.py：执行简化版行业配置/选股归因scripts/render_attribution_report.py：将归因结果渲染为中文 Markdown 报告
成功标准
本技能的高质量输出应满足以下要求：
- 能清楚解释收益和超额收益的来源
- 行业层结论可核验、可复述、可追踪
- 能明确指出结论依赖了哪些关键行业数据
- 在数据不足时不会假装精确
- 能直接服务于基金复盘、投研会议和对内汇报
