portfolio-attribution-calculation

# 组合归因计算 Skill

## 数据来源

本 Skill 支持多种组合数据输入格式，核心数据来源包括：

### 1. 组合持仓数据
- **持仓明细**：证券代码、持仓数量、持仓成本、当前市值
- **权重数据**：各证券在组合中的权重占比
- **行业分类**：证券所属行业、板块分类
- **风格标签**：价值/成长、大盘/小盘等风格标签

### 2. 收益率数据
- **组合收益率**：组合整体收益率序列
- **基准收益率**：基准指数收益率序列
- **证券收益率**：组合中各证券的收益率序列
- **行业收益率**：各行业的收益率序列

### 3. 数据格式要求
- **CSV格式**：标准持仓和收益率数据
- **Excel格式**：支持多工作表组合数据
- **JSON格式**：结构化组合数据
- **数据库连接**：支持SQL数据库直接查询

> 说明：本 Skill 不包含数据采集功能，需要用户提供清洗后的组合持仓和收益率数据。建议数据时间跨度不少于1年，以便进行准确的归因分析。

---

## 功能

本 Skill 提供全面的组合归因分析能力，涵盖多种归因方法：

### 1. 收益归因分析
- **Brinson归因**：将超额收益分解为资产配置、证券选择和交互效应
- **多因子归因**：基于多因子模型的收益归因分析
- **行业归因**：按行业分解组合收益贡献
- **风格归因**：按投资风格分解组合收益贡献

### 2. 风险归因分析
- **风险贡献度**：计算各证券对组合风险的贡献
- **行业风险贡献**：计算各行业对组合风险的贡献
- **因子风险贡献**：计算各因子对组合风险的贡献
- **集中度风险**：分析组合的集中度风险

### 3. 归因指标计算
- **归因贡献度**：各归因因子的贡献度
- **归因稳定性**：归因结果的稳定性分析
- **归因一致性**：不同时期归因结果的一致性

### 4. 归因报告生成
- **归因报告**：生成详细的归因分析报告
- **可视化图表**：生成归因结果的可视化图表
- **对比分析**：与基准或同类组合的对比分析

### 5. 数据处理能力
- **缺失值处理**：支持前向填充、插值等方法
- **异常值检测**：基于统计方法识别和处理异常数据
- **数据标准化**：支持不同数据源的格式统一
- **权重归一化**：自动归一化组合权重

---

## 使用示例

### 输出示例
```json
{
  "portfolio": "组合A",
  "period": "2024-01-01 to 2024-12-31",
  "attribution": {
    "total_return": 15.8,
    "benchmark_return": 12.5,
    "excess_return": 3.3,
    "allocation_effect": 1.2,
    "selection_effect": 1.8,
    "interaction_effect": 0.3
  },
  "industry_attribution": {
    "金融": 0.8,
    "科技": 1.5,
    "消费": 0.6,
    "其他": 0.4
  },
  "style_attribution": {
    "value": 1.2,
    "growth": 1.1,
    "large_cap": 0.7,
    "small_cap": 0.3
  },
  "risk_attribution": {
    "total_risk": 18.5,
    "idiosyncratic_risk": 12.3,
    "systematic_risk": 6.2
  }
}
```

---

## 注意事项与限制

### 1. 数据质量要求
- 持仓和收益率数据需要经过清洗和验证
- 权重数据需要准确且归一化
- 基准数据需要与组合数据时间对齐

### 2. 归因方法选择
- 不同归因方法的结果可能不同
- Brinson归因适用于主动管理组合
- 多因子归因需要准确的因子暴露数据

### 3. 时间序列分析
- 归因分析应结合时间序列分析
- 不同时间区间的归因结果不可直接比较
- 市场环境变化会影响归因结果

### 4. 综合判断原则
- 单一归因指标不能全面反映组合表现
- 需要结合风险指标进行综合分析
- 应结合投资策略和市场环境进行判断

### 5. 使用限制
- 本 Skill 输出为技术分析结果，不构成投资建议
- 使用者应结合专业判断和具体业务场景
- 对于重大决策，建议咨询专业投资顾问

---

## 参考资料
- 见 references/ 目录中的相关文档，包括：
  - 组合归因分析方法手册
  - Brinson归因模型说明
  - 多因子归因模型指南
  - 数据处理方法说明文档

## License
- 本 skill 代码部分采用 MIT License，详见 `LICENSE` 文件
- 依赖与运行环境以 `requirements.txt` 为准
- 文档内容采用 CC BY 4.0 许可