| name | ficc-analysis-report |
| description | FICC 经营分析报告生成系统 - 基于 Anthropic financial-services-plugins 架构,支持 18 个业务团队的多维度经营分析 |
| dependency | {"python":["anthropic>=0.42.0","pandas>=2.0.0","numpy>=1.24.0"]} |
FICC 经营分析报告生成系统
概述
本技能系统基于 Anthropic financial-services-plugins 架构设计,提供完整的 FICC(固定收益、外汇、大宗商品)经营分析能力,支持招商银行 18 个业务团队的多维度经营分析。
设计原则
遵循 Anthropic 的金融服务插件最佳实践:
- 清晰的接口契约 - 标准化的输入/输出定义
- 模块化设计 - 每个插件专注单一职责
- 可观测性 - 完善的日志、指标、追踪
- 安全优先 - 敏感数据访问控制
- 容错设计 - 优雅降级和错误处理
架构设计
ficc-analysis-report/
│
├── manifest.yaml # 技能包清单
├── config.yaml # 全局配置
│
├── src/ # 源代码
│ ├── __init__.py
│ ├── models/ # 数据模型
│ │ ├── __init__.py
│ │ ├── portfolio.py # 组合模型
│ │ ├── instrument.py # 工具模型
│ │ ├── market_data.py # 市场数据模型
│ │ └── report.py # 报告模型
│ │
│ ├── core/ # 核心能力
│ │ ├── __init__.py
│ │ ├── data_connector.py # 数据连接
│ │ ├── curve_builder.py # 曲线构建
│ │ ├── pricing_engine.py # 定价引擎
│ │ └── risk_engine.py # 风险引擎
│ │
│ ├── plugins/ # 业务插件
│ │ ├── __init__.py
│ │ ├── fixed_income.py # 固收业务
│ │ ├── fx_desk.py # 外汇交易
│ │ ├── commodities.py # 大宗商品
│ │ ├── client_solutions.py # 客户解决方案
│ │ └── sales_trading.py # 销售交易
│ │
│ └── workflows/ # 工作流
│ ├── __init__.py
│ ├── report_generator.py # 报告生成工作流
│ ├── data_collection.py # 数据收集工作流
│ └── analysis_pipeline.py # 分析流水线
│
├── tests/ # 测试
│ ├── unit/
│ ├── integration/
│ └── e2e/
│
└── docs/ # 文档
├── api/
├── architecture/
└── examples/
核心数据模型
组合模型 (Portfolio)
from dataclasses import dataclass
from typing import List, Dict, Optional
from decimal import Decimal
from datetime import date
@dataclass
class Portfolio:
"""投资组合模型"""
portfolio_id: str
name: str
business_line: str
team: str
as_of_date: date
positions: List['Position']
total_notional: Decimal
market_value: Decimal
ytd_pnl: Decimal
var_1d: Optional[Decimal] = None
var_10d: Optional[Decimal] = None
metadata: Dict = None
@dataclass
class Position:
"""持仓模型"""
position_id: str
instrument: 'Instrument'
quantity: Decimal
direction: str
avg_cost: Decimal
market_price: Decimal
market_value: Decimal
unrealized_pnl: Decimal
delta: Optional[Decimal] = None
gamma: Optional[Decimal] = None
vega: Optional[Decimal] = None
工具模型 (Instrument)
@dataclass
class Instrument:
"""金融工具基类"""
instrument_id: str
name: str
instrument_type: str
currency: str
notional: Decimal
maturity_date: Optional[date] = None
pricing_model: Optional[str] = None
model_params: Dict = None
@dataclass
class Bond(Instrument):
"""债券"""
face_value: Decimal
coupon_rate: Decimal
coupon_frequency: int
issue_date: date
issuer: str
credit_rating: Optional[str] = None
ytm: Optional[Decimal] = None
modified_duration: Optional[Decimal] = None
convexity: Optional[Decimal] = None
@dataclass
class IRSwap(Instrument):
"""利率互换"""
fixed_rate: Decimal
fixed_leg_currency: str
floating_index: str
floating_spread: Decimal
fixed_leg_tenor: str
floating_leg_tenor: str
npv: Optional[Decimal] = None
pv01: Optional[Decimal] = None
插件接口定义
固收业务插件 (Fixed Income)
from abc import ABC, abstractmethod
from typing import List, Dict, Optional
from decimal import Decimal
class FixedIncomePlugin(ABC):
"""固收业务插件接口"""
@abstractmethod
def analyze_bond(self, bond: Bond, market_data: Dict) -> Dict:
"""
分析债券
Returns:
{
"ytm": Decimal, # 到期收益率
"duration": Decimal, # 久期
"convexity": Decimal, # 凸性
"credit_metrics": Dict # 信用指标
}
"""
pass
@abstractmethod
def price_swap(self, swap: IRSwap, curves: Dict) -> Decimal:
"""
定价利率互换
Args:
swap: 互换合约
curves: {"discount": Curve, "forward": Curve}
Returns:
互换净现值
"""
pass
@abstractmethod
def calculate_pnl_attribution(self, portfolio: Portfolio,
start_date: date, end_date: date) -> Dict:
"""
计算损益归因
五维度归因:Carry, Roll-down, Rate Change, Spread Change, Other
"""
pass
使用示例
生成经营分析报告
from ficc_analysis_report import FICCReportGenerator
from datetime import date
report_gen = FICCReportGenerator(
config={
"business_line": "commodities",
"team": "precious_metals",
"data_mode": "guided"
}
)
report = report_gen.generate(
period="2025Q1",
report_type="business_analysis",
output_format=["markdown", "h5"]
)
print(f"报告已生成: {report.markdown_path}")
print(f"H5页面: {report.h5_url}")
文档版本
- Version: 3.0
- Architecture: Anthropic Financial Services Plugins
- Last Updated: 2026-03-01