# China Variance Commentary

> Write variance commentary for A-share fund performance and portfolio changes. Adapts the original variance-commentary skill for fund accounting and Chinese fund reporting conventions. Triggers on "基金业绩点评", "组合表现分析", "variance commentary fund", "基金表现分析", "业绩归因", or "commentary on [fund] performance".

- **Type:** Skill
- **Install:** `agentstack add skill-jwangkun-claude-for-financial-services-cn-china-variance-commentary`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jwangkun](https://agentstack.voostack.com/s/jwangkun)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [jwangkun](https://github.com/jwangkun)
- **Source:** https://github.com/jwangkun/claude-for-financial-services-cn/tree/main/agent-plugins/china-earnings-reviewer/skills/china-variance-commentary

## Install

```sh
agentstack add skill-jwangkun-claude-for-financial-services-cn-china-variance-commentary
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# china-variance-commentary

## Purpose

Write professional **基金业绩点评** — structured variance commentary on fund performance and portfolio changes.

## Data Sources

### Tier 0 — 万得 Wind（最全面付费数据）
- 覆盖：A股/港美股/基金/指数/债券/宏观/研报/分析（44个工具）
- MCP 服务：`wind-mcp`（需 `WIND_API_KEY` 密钥，以 `ak_` 开头）
- 优势：全市场覆盖面最广、数据最全面、包含研报和量化分析
- 密钥申请：https://aifinmarket.wind.com.cn/#/home

### Tier 1 — 同花顺 iFind（付费精确数据）/ AkShare MCP（Tier-2 免费备选）

```python
get_fund_data(fund_code)              → Fund NAV, performance
get_quote(ticker)                     → Individual security performance
get_index_data("000001")              → Benchmark data
```

### Secondary Sources
- 基金公司 — fund performance data
- 托管行 — custody data
- Wind / Choice — performance analytics

## Workflow

### Step 1: Gather Performance Data

**Performance snapshot:**

| Metric | Period | Benchmark | Active Return |
|--------|--------|-----------|--------------|
| 净值增长率 | X.XX% | X.XX% | X.XX% |
| 年化收益率 | X.XX% | X.XX% | X.XX% |
| 波动率 | X.XX% | X.XX% | |
| 夏普比率 | X.XX | | |
| 最大回撤 | X.XX% | | |
| 卡尔马比率 | X.XX | | |

### Step 2: Attribution Analysis

**Performance attribution:**

| Factor | Contribution | Description |
|--------|-------------|-------------|
| 资产配置 (Allocation) | X.XX% | Sector/security weight decisions |
| 个股选择 (Selection) | X.XX% | Security picking within sectors |
| 交互效应 (Interaction) | X.XX% | Combined effect |

### Step 3: Sector Attribution

**Sector performance:**

| Sector | Weight | Return | Contribution | Benchmark Weight | Benchmark Return | Allocation Effect | Selection Effect |
|--------|--------|--------|-------------|-----------------|-----------------|-----------------|-----------------|
| | | | | | | | |
| **Total** | **100%** | | | | | | |

### Step 4: Top/Bottom Contributors

**Best/worst performers:**

| # | Security | Ticker | Weight | Period Return | Contribution |
|---|----------|--------|--------|--------------|-------------|
| 1 (Best) | | | | | |
| 2 | | | | | |
| 3 | | | | | |
| ... | | | | | |
| (Worst) | | | | | |
| (2nd Worst) | | | | | |
| (3rd Worst) | | | | | |

### Step 5: Risk Analysis

**Risk metrics:**

| Metric | Value | Benchmark | Assessment |
|--------|-------|-----------|-----------|
| 波动率 | X.XX% | X.XX% | Higher/Lower |
| 最大回撤 | X.XX% | X.XX% | |
| 下行偏差 | X.XX% | X.XX% | |
| VaR (95%) | X.XX% | | |
| Beta | X.XX | | |
| Alpha | X.XX% | | |

### Step 6: Holdings Changes

**Changes since last period:**

| Action | Security | Ticker | Reason | Impact |
|--------|----------|--------|--------|--------|
| New buy | | | | |
| Add to | | | | |
| Reduce | | | | |
| Sold | | | | |

### Step 7: Market Context

**Market environment:**

| Factor | Current | Prior Period | Change |
|--------|---------|-------------|--------|
| 上证指数 | | | |
| 沪深300 | | | |
| 创业板指 | | | |
| 北向资金 | | | |
| 成交量 | | | |

### Step 8: Commentary

**Standard format:**

```
【业绩点评】[Fund Name] [Period]
报告期：[Date]
单位净值：¥X.XXXX
净值增长率：+/-X.XX%
基准收益率：+/-X.XX%
超额收益：+/-X.XX%

一、业绩概览
   [Overall performance summary]

二、归因分析
   [Attribution breakdown]

三、行业分析
   [Sector attribution]

四、重仓股表现
   [Top/bottom contributors]

五、风险指标
   [Risk metrics]

六、持仓变动
   [Changes in portfolio]

七、市场回顾
   [Market context]

八、展望
   [Forward outlook]
```

## China-Specific Considerations

### Fund Benchmarks

| Fund Type | Typical Benchmark |
|-----------|------------------|
| 股票型基金 | 沪深300 / 创业板指 |
| 债券型基金 | 中债综合指数 |
| 混合型基金 | 沪深300 × 50% + 中债 × 50% |
| 指数基金 | Tracking index |
| QDII | Relevant foreign index |

### Performance Presentation

| Convention | China Practice |
|-----------|----------------|
| Return calculation | Geometric |
| Benchmark | Contractual |
| Reporting frequency | Daily for public funds |
| Risk metrics | Standard set |

## Quality Checks

Before delivering:
- [ ] Performance data accurate
- [ ] Attribution complete
- [ ] Top/bottom contributors identified
- [ ] Risk metrics calculated
- [ ] Holdings changes documented
- [ ] Market context current
- [ ] Commentary balanced
> **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
> - `ifind-only` (strict): Use iFind only, error if unavailable
> - `ifind-fallback` (default): iFind preferred, fallback to AkShare
> - `akshare-only`: Skip iFind, use AkShare only
> - `wind-only`: Wind only, error if unavailable
> - `wind-fallback`: Wind first, fallback to iFind → AkShare

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jwangkun](https://github.com/jwangkun)
- **Source:** [jwangkun/claude-for-financial-services-cn](https://github.com/jwangkun/claude-for-financial-services-cn)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jwangkun-claude-for-financial-services-cn-china-variance-commentary
- Seller: https://agentstack.voostack.com/s/jwangkun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.