@v587d/capital-generation 2.7.3 → 2.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/CHANGELOG.md +100 -0
  2. package/README.md +17 -7
  3. package/THIRD_PARTY_NOTICES.md +71 -24
  4. package/capital-config/client.js +4 -4
  5. package/capital-config/package.json +1 -1
  6. package/capital-watchlist/package.json +1 -1
  7. package/chart-ui/package.json +1 -1
  8. package/lib/web-retriever/local-fetch.d.ts +1 -1
  9. package/lib/web-retriever/local-fetch.js +1 -1
  10. package/lib/web-retriever/sources.d.ts +1 -1
  11. package/lib/web-retriever/sources.js +1 -1
  12. package/lib/web-retriever/wind-client.d.ts +1 -1
  13. package/lib/web-retriever/wind-client.js +1 -1
  14. package/package.json +2 -1
  15. package/selected-skills/README.md +6 -1
  16. package/selected-skills/catalog.js +176 -0
  17. package/selected-skills/claude-for-financial-services-cn/LICENSE +201 -0
  18. package/selected-skills/claude-for-financial-services-cn/UPSTREAM.md +173 -0
  19. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-3-statement-model/SKILL.md +287 -0
  20. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-accrual-schedule/SKILL.md +182 -0
  21. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-audit-xls/SKILL.md +231 -0
  22. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-break-trace/SKILL.md +217 -0
  23. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +258 -0
  24. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-clean-data-xls/SKILL.md +237 -0
  25. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-comps/SKILL.md +104 -0
  26. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-comps-analysis/SKILL.md +196 -0
  27. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-dcf/SKILL.md +81 -0
  28. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-dcf-model/SKILL.md +68 -0
  29. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-deal-screening/SKILL.md +212 -0
  30. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-deck-refresh/SKILL.md +221 -0
  31. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-earnings-analysis/SKILL.md +237 -0
  32. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-earnings-preview/SKILL.md +239 -0
  33. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-gl-recon/SKILL.md +232 -0
  34. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-ib-check-deck/SKILL.md +252 -0
  35. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +277 -0
  36. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-initiating-coverage/SKILL.md +271 -0
  37. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-lbo-model/SKILL.md +273 -0
  38. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-market-data/SKILL.md +229 -0
  39. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-model-update/SKILL.md +219 -0
  40. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-morning-note/SKILL.md +227 -0
  41. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-ppt-template-creator/SKILL.md +231 -0
  42. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-pptx-author/SKILL.md +240 -0
  43. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-roll-forward/SKILL.md +189 -0
  44. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +257 -0
  45. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-skill-creator/SKILL.md +304 -0
  46. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-tax-loss-harvesting/SKILL.md +200 -0
  47. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-thesis-tracker/SKILL.md +237 -0
  48. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-variance-commentary/SKILL.md +262 -0
  49. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-xlsx-author/SKILL.md +256 -0
  50. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-accrual-schedule/SKILL.md +190 -0
  51. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-break-trace/SKILL.md +182 -0
  52. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-gl-recon/SKILL.md +200 -0
  53. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-nav-tieout/SKILL.md +233 -0
  54. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-roll-forward/SKILL.md +178 -0
  55. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/fund-admin/skills/china-variance-commentary/SKILL.md +190 -0
  56. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-buyer-list/SKILL.md +198 -0
  57. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-cim-builder/SKILL.md +223 -0
  58. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-competitive-analysis/SKILL.md +233 -0
  59. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-datapack-builder/SKILL.md +232 -0
  60. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-deal-tracker/SKILL.md +151 -0
  61. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-merger-model/SKILL.md +226 -0
  62. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-pitch-deck/SKILL.md +231 -0
  63. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-process-letter/SKILL.md +249 -0
  64. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-strip-profile/SKILL.md +196 -0
  65. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/investment-banking/skills/china-teaser/SKILL.md +235 -0
  66. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/operations/skills/china-kyc-doc-parse/SKILL.md +252 -0
  67. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/operations/skills/china-kyc-rules/SKILL.md +223 -0
  68. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-ai-readiness/SKILL.md +184 -0
  69. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-dd-checklist/SKILL.md +217 -0
  70. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-dd-meeting-prep/SKILL.md +290 -0
  71. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-deal-sourcing/SKILL.md +224 -0
  72. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-ic-memo/SKILL.md +230 -0
  73. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-portfolio-monitoring/SKILL.md +214 -0
  74. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-returns-analysis/SKILL.md +176 -0
  75. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-unit-economics/SKILL.md +192 -0
  76. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/private-equity/skills/china-value-creation-plan/SKILL.md +193 -0
  77. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-client-report/SKILL.md +205 -0
  78. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-client-review/SKILL.md +218 -0
  79. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-financial-plan/SKILL.md +259 -0
  80. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-investment-proposal/SKILL.md +271 -0
  81. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-portfolio-rebalance/SKILL.md +191 -0
@@ -0,0 +1,200 @@
1
+ ---
2
+ name: china-gl-recon
3
+ description: General ledger reconciliation for A-share fund administration. Tracks fund accounting reconciliations including securities, cash, income, and expense accruals. Adapted from the original gl-recon skill for fund accounting standards. Triggers on "基金总账核对", "基金科目核对", "GL reconciliation fund", "fund accounting recon", or "reconcile [fund] books".
4
+ ---
5
+
6
+ # china-gl-recon
7
+
8
+ ## Purpose
9
+
10
+ Perform **基金总账核对** — comprehensive general ledger reconciliation for fund accounting.
11
+
12
+ ## Data Sources
13
+
14
+ ### Tier 0 — 万得 Wind(最全面付费数据)
15
+ - 覆盖:A股/港美股/基金/指数/债券/宏观/研报/分析(44个工具)
16
+ - MCP 服务:`wind-mcp`(需 `WIND_API_KEY` 密钥,以 `ak_` 开头)
17
+ - 优势:全市场覆盖面最广、数据最全面、包含研报和量化分析
18
+ - 密钥申请:https://aifinmarket.wind.com.cn/#/home
19
+
20
+ ### Tier 1 — 同花顺 iFind(付费精确数据)/ AkShare MCP(Tier-2 免费备选)
21
+
22
+ ```python
23
+ get_financials(ticker, "balance") → Portfolio company BS
24
+ get_fund_data(fund_code) → Fund holdings and NAV
25
+ get_quote(ticker) → Security prices
26
+ ```
27
+
28
+ ### Secondary Sources
29
+ - 基金公司 — fund accounting system
30
+ - 托管行 — custody records
31
+ - Wind / Choice — market data
32
+
33
+ ## Workflow
34
+
35
+ ### Step 1: Identify GL Accounts
36
+
37
+ **Fund accounting COA:**
38
+
39
+ | Category | Accounts | Purpose |
40
+ |----------|----------|---------|
41
+ | 资产 (Assets) | Securities, cash, receivables | Investments |
42
+ | 负债 (Liabilities) | Payables, accruals | Amounts owed |
43
+ | 所有者权益 | NAV | Fund value |
44
+ | 收入 (Revenue) | Dividends, interest, gains | Investment income |
45
+ | 费用 (Expenses) | Management fee, custodian fee | Fund costs |
46
+ | 已实现损益 | Realized gains/losses | Trading P&L |
47
+ | 未实现损益 | Unrealized appreciation | Mark-to-market |
48
+
49
+ ### Step 2: Securities Reconciliation
50
+
51
+ **Securities holdings recon:**
52
+
53
+ | Security | Ticker | Fund Records | Custodian | Difference | Status |
54
+ |----------|--------|-------------|-----------|------------|--------|
55
+ | | | | | | |
56
+ | | | | | | |
57
+ | **Total** | | | | | |
58
+
59
+ **Reconciliation items:**
60
+ - 在途交易 (Trades in transit)
61
+ - 配股/增发 (Rights issues)
62
+ - 分红到账 (Dividend settlements)
63
+ - 利息到账 (Interest settlements)
64
+
65
+ ### Step 3: Cash Reconciliation
66
+
67
+ **Cash recon:**
68
+
69
+ | Account | GL Balance | Bank Statement | Custodian | Difference |
70
+ |---------|-----------|----------------|-----------|------------|
71
+ | 清算备付金 | | | | |
72
+ | 结算备付金 | | | | |
73
+ | 银行存款 | | | | |
74
+ | **Total** | | | | |
75
+
76
+ ### Step 4: Income Reconciliation
77
+
78
+ **Income reconciliation:**
79
+
80
+ | Type | Fund Records | Custodian | Source Docs | Difference |
81
+ |------|-------------|-----------|-------------|------------|
82
+ | 现金股息 | | | | |
83
+ | 股票股息 | | | | |
84
+ | 债券利息 | | | | |
85
+ | 回购利息 | | | | |
86
+ | 基金分红 | | | | |
87
+ | 已实现利得 | | | | |
88
+ | **Total** | | | | |
89
+
90
+ ### Step 5: Expense Reconciliation
91
+
92
+ **Expense reconciliation:**
93
+
94
+ | Expense | Fund Records | Custodian | Invoice/Contract | Difference |
95
+ |---------|-------------|-----------|-----------------|------------|
96
+ | 管理费 | | | | |
97
+ | 托管费 | | | | |
98
+ | 交易佣金 | | | | |
99
+ | 审计费 | | | | |
100
+ | 信息披露费 | | | | |
101
+ | 律师费 | | | | |
102
+ | **Total** | | | | |
103
+
104
+ ### Step 6: Accrual Reconciliation
105
+
106
+ **Accrual reconciliation:**
107
+
108
+ | Accrual Type | Calculation | Custodian | Difference |
109
+ |-------------|-------------|-----------|------------|
110
+ | 应收股息 | | | |
111
+ | 应收利息 | | | |
112
+ | 应付管理费 | | | |
113
+ | 应付托管费 | | | |
114
+ | 应付交易费用 | | | |
115
+
116
+ ### Step 7: NAV Reconciliation
117
+
118
+ **NAV reconciliation:**
119
+
120
+ | Component | Fund Books | Custodian | Difference |
121
+ |-----------|-----------|-----------|------------|
122
+ | Securities | | | |
123
+ | Cash | | | |
124
+ | Receivables | | | |
125
+ | Payables | | | |
126
+ | Accruals | | | |
127
+ | **NAV** | | | |
128
+
129
+ **NAV per unit check:**
130
+
131
+ | | Fund | Custodian | Difference |
132
+ |--|------|-----------|------------|
133
+ | NAV (¥) | | | |
134
+ | Shares outstanding | | | |
135
+
136
+ ### Step 8: P&L Reconciliation
137
+
138
+ **P&L reconciliation:**
139
+
140
+ | P&L Item | Fund Books | Verified | Notes |
141
+ |----------|-----------|----------|-------|
142
+ | 收入合计 | | | |
143
+ | 费用合计 | | | |
144
+ | 已实现损益 | | | |
145
+ | 未实现损益 | | | |
146
+ | 利润合计 | | | |
147
+
148
+ ### Step 9: Trade Reconciliation
149
+
150
+ **Trade recon:**
151
+
152
+ | Trade Date | Security | Type | Quantity | Price | Fund | Custodian | Match? |
153
+ |-----------|----------|------|----------|-------|------|-----------|--------|
154
+ | | | | | | | | |
155
+
156
+ ### Step 10: Exception Report
157
+
158
+ **Exception log:**
159
+
160
+ | # | Exception | Type | Amount | Resolution | Status |
161
+ |---|-----------|------|--------|-------------|--------|
162
+ | | | | | | |
163
+
164
+ ## China-Specific Considerations
165
+
166
+ ### Fund Accounting Standards
167
+
168
+ | Standard | Applies |
169
+ |----------|---------|
170
+ | 基金会计核算 | All funds |
171
+ | 企业会计准则 | Private funds |
172
+ | 证券投资基金信息披露 | Disclosure requirements |
173
+
174
+ ### Common Issues
175
+
176
+ | Issue | Cause | Resolution |
177
+ |-------|-------|-----------|
178
+ | 交易时滞 | T+1 settlement | Track trades in transit |
179
+ | 分红时滞 | Ex-date vs pay-date | Accrue correctly |
180
+ | 费用计提 | Timing differences | Standardize cut-off |
181
+ | 估值差异 | Different pricing sources | Agree on source |
182
+
183
+ ## Quality Checks
184
+
185
+ Before completing:
186
+ - [ ] Securities reconciled
187
+ - [ ] Cash reconciled
188
+ - [ ] Income reconciled
189
+ - [ ] Expenses reconciled
190
+ - [ ] Accruals reconciled
191
+ - [ ] NAV tied out
192
+ - [ ] P&L reconciled
193
+ - [ ] Exceptions resolved
194
+ - [ ] Sign-offs obtained
195
+ > **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
196
+ > - `ifind-only` (strict): Use iFind only, error if unavailable
197
+ > - `ifind-fallback` (default): iFind preferred, fallback to AkShare
198
+ > - `akshare-only`: Skip iFind, use AkShare only
199
+ > - `wind-only`: Wind only, error if unavailable
200
+ > - `wind-fallback`: Wind first, fallback to iFind → AkShare
@@ -0,0 +1,233 @@
1
+ ---
2
+ name: china-nav-tieout
3
+ description: Net asset value (NAV) reconciliation and tie-out for Chinese funds and investment portfolios. Adapts the original nav-tieout skill for A-share holdings, Chinese fund accounting standards, and domestic custody arrangements. Triggers on "A股净值核对", "NAV计算", "NAV tie-out China", "基金净值", "net asset value [fund]", or "portfolio valuation [date]".
4
+ ---
5
+
6
+ # china-nav-tieout
7
+
8
+ ## Purpose
9
+
10
+ Perform **A股投资组合净值核算** — comprehensive NAV reconciliation and valuation for Chinese investment portfolios.
11
+
12
+ ## Data Sources
13
+
14
+ ### Tier 0 — 万得 Wind(最全面付费数据)
15
+ - 覆盖:A股/港美股/基金/指数/债券/宏观/研报/分析(44个工具)
16
+ - MCP 服务:`wind-mcp`(需 `WIND_API_KEY` 密钥,以 `ak_` 开头)
17
+ - 优势:全市场覆盖面最广、数据最全面、包含研报和量化分析
18
+ - 密钥申请:https://aifinmarket.wind.com.cn/#/home
19
+
20
+ ### Tier 1 — 同花顺 iFind(付费精确数据)/ AkShare MCP(Tier-2 免费备选)
21
+
22
+ ```python
23
+ get_quote(ticker) → Latest prices for holdings
24
+ get_fund_data(fund_code) → Fund NAV data
25
+ get_index_data("000001") → Benchmark data
26
+ ```
27
+
28
+ ### Secondary Sources
29
+ - 基金公司 — fund NAV calculations
30
+ - 托管行 — custody valuations
31
+ - Wind / Choice — portfolio analytics
32
+ - 交易所 — closing prices
33
+
34
+ ## Workflow
35
+
36
+ ### Step 1: Gather Portfolio Holdings
37
+
38
+ **Holdings snapshot:**
39
+
40
+ | Security | Ticker | Type | Quantity | Market Value | Cost | Unrealized P/L |
41
+ |----------|--------|------|----------|--------------|------|----------------|
42
+ | | | | | | | |
43
+ | Cash | | | | | | |
44
+ | Receivables | | | | | | |
45
+ | Payables | | | | | | |
46
+ | **Total NAV** | | | | | | |
47
+
48
+ ### Step 2: Value Each Holding
49
+
50
+ **Valuation methodology:**
51
+
52
+ | Security Type | Valuation Method | Source |
53
+ |---------------|-----------------|--------|
54
+ | A股上市股票 | Closing price (收盘价) | 交易所 |
55
+ | A股停牌股票 | Last closing / 估值 | 中基协 guidelines |
56
+ | 基金 (ETF/LOF) | NAV / market price | 基金公司 |
57
+ | 债券 | 中债估值 / 收盘价 | 中债/交易所 |
58
+ | 逆回购 | Principal + interest | Calculated |
59
+ | 存款 | Principal + interest | Bank |
60
+ | 衍生品 | Mark-to-market | Exchange/Counterparty |
61
+
62
+ **A-share valuation rules:**
63
+ - 上市股票: 收盘价 (closing price)
64
+ - 停牌股票:
65
+ - <1 month: last closing
66
+ - 1-3 months: 中基协 AMAC guidelines
67
+ - >3 months: independent valuation
68
+ - 涨跌停股票: Ceiling/floor price
69
+
70
+ ### Step 3: Calculate NAV
71
+
72
+ **NAV calculation:**
73
+
74
+ | Component | Amount | Notes |
75
+ |-----------|--------|-------|
76
+ | Market value of securities | ¥XX | |
77
+ | Cash and cash equivalents | ¥XX | |
78
+ | Accrued income | ¥XX | Dividends, interest |
79
+ | Receivables | ¥XX | |
80
+ | Other assets | ¥XX | |
81
+ | **Gross Assets** | **¥XX** | |
82
+ | | | |
83
+ | Payables | ¥XX | |
84
+ | Accrued expenses | ¥XX | Management fees, etc. |
85
+ | Other liabilities | ¥XX | |
86
+ | **Total Liabilities** | **¥XX** | |
87
+ | | | |
88
+ | **Net Assets** | **¥XX** | |
89
+ | | | |
90
+ | Shares outstanding | XX 份 | |
91
+ | **NAV per share/unit** | **¥X.XXXX** | |
92
+
93
+ ### Step 4: Income Accruals
94
+
95
+ **Accrued income:**
96
+
97
+ | Type | Security | Amount | Ex-date | Pay-date |
98
+ |------|----------|--------|---------|----------|
99
+ | 现金股息 | | | | |
100
+ | 股票股息 | | | | |
101
+ | 债券利息 | | | | |
102
+ | 基金分红 | | | | |
103
+ | 逆回购利息 | | | | |
104
+ | **Total accrued income** | | | | |
105
+
106
+ ### Step 5: Expense Accruals
107
+
108
+ **Accrued expenses:**
109
+
110
+ | Type | Amount | Calculation Basis |
111
+ |------|--------|-------------------|
112
+ | 管理费 (Management fee) | ¥XX | AUM × annual rate × days/365 |
113
+ | 托管费 (Custodian fee) | ¥XX | AUM × annual rate × days/365 |
114
+ | 交易佣金 (Trading commission) | ¥XX | Actual trades |
115
+ | 税费 (Taxes) | ¥XX | |
116
+ | 其他费用 | ¥XX | |
117
+ | **Total accrued expenses** | | |
118
+
119
+ ### Step 6: Reconciliation
120
+
121
+ **Reconciliation checklist:**
122
+
123
+ | Item | Portfolio System | Custodian | Difference | Resolved |
124
+ |-------|-----------------|-----------|------------|----------|
125
+ | Securities holdings | | | | |
126
+ | Cash balance | | | | |
127
+ | Accrued income | | | | |
128
+ | Accrued expenses | | | | |
129
+ | Total NAV | | | | |
130
+
131
+ **Common reconciling items:**
132
+ - Trade date vs settlement date differences
133
+ - 在途交易 (Trades in transit)
134
+ - 分红在途 (Dividends pending)
135
+ - 费用计提差异 (Accrual timing)
136
+
137
+ ### Step 7: Performance Calculation
138
+
139
+ **Performance metrics:**
140
+
141
+ | Metric | Period Return | Annualized |
142
+ |--------|--------------|------------|
143
+ | Portfolio return | X.XX% | X.XX% |
144
+ | Benchmark return | X.XX% | X.XX% |
145
+ | Active return | X.XX% | X.XX% |
146
+ | Volatility | X.XX% | X.XX% |
147
+ | Sharpe ratio | | X.XX |
148
+ | Max drawdown | X.XX% | |
149
+ | Best period | | X.XX% |
150
+ | Worst period | | X.XX% |
151
+
152
+ ### Step 8: Compliance Checks
153
+
154
+ **Fund compliance (China):**
155
+
156
+ | Check | Requirement | Status |
157
+ |-------|-------------|--------|
158
+ | 投资范围 | Within mandate | |
159
+ | 投资比例 | Per fund contract | |
160
+ | 集中度 | Single stock limit | |
161
+ | 流动性 | Liquid assets ratio | |
162
+ | 杠杆率 | Leverage limits | |
163
+ | 关联交易 | Within limits | |
164
+ | 估值方法 | Per regulations | |
165
+
166
+ ### Step 9: Reporting
167
+
168
+ **NAV report format:**
169
+
170
+ ```
171
+ 【净值报告】[Fund Name] [Date]
172
+ 报告日期: YYYY年MM月DD日
173
+ 单位净值: ¥X.XXXX
174
+ 累计净值: ¥X.XXXX
175
+ 日涨跌幅: +/-X.XX%
176
+
177
+ 资产组合:
178
+ 股票投资: ¥XX亿 (XX%)
179
+ 债券投资: ¥XX亿 (XX%)
180
+ 现金及等价物: ¥XX亿 (XX%)
181
+ 其他: ¥XX亿 (XX%)
182
+ 合计: ¥XX亿
183
+
184
+ 净值计算人: _________
185
+ 复核人: _________
186
+ ```
187
+
188
+ ## China-Specific Considerations
189
+
190
+ ### Fund Types
191
+
192
+ | Type | Regulation | Valuation |
193
+ |------|-----------|-----------|
194
+ | 公募基金 (Public fund) | 证监会 | Daily NAV |
195
+ | 私募基金 (Private fund) | 中基协 | Weekly/Monthly |
196
+ | 券商资管 | 证监会 | Per contract |
197
+ | 信托计划 | 银保监会 | Per contract |
198
+ | 保险资管 | 银保监会 | Per contract |
199
+
200
+ ### Valuation Standards
201
+
202
+ | Standard | Source |
203
+ |----------|--------|
204
+ | 基金会计核算 | 财政部 / 证监会 |
205
+ | 估值指引 | 中基协 AMAC |
206
+ | 证券投资基金 | 基金合同 |
207
+ | 托管协议 | 托管行 |
208
+
209
+ ### Common Issues
210
+
211
+ | Issue | Resolution |
212
+ |-------|-----------|
213
+ | 停牌股票估值 | AMAC guidelines |
214
+ | 汇率折算 | PBOC rate |
215
+ | 费用计提 | Per fund contract |
216
+ | 分红处理 | Ex-dividend adjustment |
217
+
218
+ ## Quality Checks
219
+
220
+ Before finalizing:
221
+ - [ ] All holdings priced correctly
222
+ - [ ] Income and expenses accrued
223
+ - [ ] Reconciliation complete
224
+ - [ ] Performance calculated accurately
225
+ - [ ] Compliance verified
226
+ - [ ] Documentation complete
227
+ - [ ] Sign-offs obtained
228
+ > **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
229
+ > - `ifind-only` (strict): Use iFind only, error if unavailable
230
+ > - `ifind-fallback` (default): iFind preferred, fallback to AkShare
231
+ > - `akshare-only`: Skip iFind, use AkShare only
232
+ > - `wind-only`: Wind only, error if unavailable
233
+ > - `wind-fallback`: Wind first, fallback to iFind → AkShare
@@ -0,0 +1,178 @@
1
+ ---
2
+ name: china-roll-forward
3
+ description: Roll forward fund accounting records for new reporting periods. Adapts the original roll-forward skill for Chinese fund administration and reporting requirements. Triggers on "基金账务滚动", "账务更新", "roll forward fund", "update fund books", "基金新期间", or "roll forward [fund] [period]".
4
+ ---
5
+
6
+ # china-roll-forward
7
+
8
+ ## Purpose
9
+
10
+ Roll forward **基金账务** — update fund accounting records for new periods.
11
+
12
+ ## Data Sources
13
+
14
+ ### Tier 0 — 万得 Wind(最全面付费数据)
15
+ - 覆盖:A股/港美股/基金/指数/债券/宏观/研报/分析(44个工具)
16
+ - MCP 服务:`wind-mcp`(需 `WIND_API_KEY` 密钥,以 `ak_` 开头)
17
+ - 优势:全市场覆盖面最广、数据最全面、包含研报和量化分析
18
+ - 密钥申请:https://aifinmarket.wind.com.cn/#/home
19
+
20
+ ### Tier 1 — 同花顺 iFind(付费精确数据)/ AkShare MCP(Tier-2 免费备选)
21
+
22
+ ```python
23
+ get_financials(ticker, "income") → Holdings financials
24
+ get_fund_data(fund_code) → Fund NAV data
25
+ get_quote(ticker) → Latest prices
26
+ ```
27
+
28
+ ### Secondary Sources
29
+ - 基金公司 — fund accounting system
30
+ - 托管行 — custody records
31
+ - 巨潮 — portfolio company filings
32
+
33
+ ## Workflow
34
+
35
+ ### Step 1: Identify New Period
36
+
37
+ **Fund reporting periods:**
38
+
39
+ | Period | Type | Frequency | Deadline |
40
+ |--------|------|-----------|----------|
41
+ | 日 | Daily | Daily | T+1 |
42
+ | 周 | Weekly | Weekly | |
43
+ | 月 | Monthly | Monthly | |
44
+ | 季 | Quarterly | Quarterly |季报后 |
45
+ | 半年 | Semi-annual | Semi-annual |中报后 |
46
+ | 年 | Annual | Annual |年报后 |
47
+
48
+ ### Step 2: Close Prior Period
49
+
50
+ **Period-end closing checklist:**
51
+
52
+ | Item | Action |
53
+ |------|--------|
54
+ | 收入确认 | Close all income accruals |
55
+ | 费用计提 | Close all expense accruals |
56
+ | 已实现损益 | Calculate realized P&L |
57
+ | 未实现损益 | Mark-to-market |
58
+ | 分红处理 | Process distributions |
59
+ | 费用分配 | Allocate to NAV |
60
+
61
+ ### Step 3: Carry Forward Balances
62
+
63
+ **Balance carry-forward:**
64
+
65
+ | Account | Ending Balance | Carried Forward | Notes |
66
+ |---------|---------------|----------------|-------|
67
+ | 银行存款 | | | |
68
+ | 证券投资 | | | |
69
+ | 应收利息 | | | |
70
+ | 应收股利 | | | |
71
+ | 应付费用 | | | |
72
+ | 实收基金 | | | |
73
+ | 未分配利润 | | | |
74
+
75
+ ### Step 4: Update Holdings
76
+
77
+ **Holdings update:**
78
+
79
+ | Security | Ticker | Prior Qty | Trades | New Qty | Price | Market Value |
80
+ |----------|--------|-----------|--------|---------|-------|--------------|
81
+ | | | | | | | |
82
+
83
+ ### Step 5: Update Accruals
84
+
85
+ **Accrual roll-forward:**
86
+
87
+ | Accrual Type | Prior | Additions | Usage | Reversal | New |
88
+ |-------------|-------|-----------|-------|----------|-----|
89
+ | 应收股息 | | | | | |
90
+ | 应收利息 | | | | | |
91
+ | 应付管理费 | | | | | |
92
+ | 应付托管费 | | | | | |
93
+
94
+ ### Step 6: Calculate New NAV
95
+
96
+ **NAV calculation:**
97
+
98
+ | Item | Amount |
99
+ |-------|--------|
100
+ | Beginning NAV | ¥XX |
101
+ | + Income earned | ¥XX |
102
+ | + Realized gains | ¥XX |
103
+ | + Unrealized gains | ¥XX |
104
+ | - Expenses | ¥XX |
105
+ | - Distributions | ¥XX |
106
+ | **Ending NAV** | **¥XX** |
107
+ | Shares outstanding | XX |
108
+ | **NAV per share** | **¥XX** |
109
+
110
+ ### Step 7: Update Financial Statements
111
+
112
+ **Fund financial statements:**
113
+
114
+ | Statement | Update |
115
+ |-----------|--------|
116
+ | 资产负债表 | New balances |
117
+ | 利润表 | New period activity |
118
+ | 净值变动表 | NAV changes |
119
+ | 会计报表附注 | Disclosures |
120
+
121
+ ### Step 8: Performance Calculation
122
+
123
+ **Performance update:**
124
+
125
+ | Metric | MTD | QTD | YTD | Since Inception |
126
+ |--------|-----|-----|-----|-----------------|
127
+ | Return | X.XX% | X.XX% | X.XX% | X.XX% |
128
+ | Benchmark | X.XX% | X.XX% | X.XX% | X.XX% |
129
+ | Active return | X.XX% | X.XX% | X.XX% | X.XX% |
130
+
131
+ ### Step 9: Reconciliation
132
+
133
+ **New period reconciliation:**
134
+
135
+ | Item | Fund Books | Custodian | Match? |
136
+ |-------|-----------|-----------|--------|
137
+ | Securities | | | |
138
+ | Cash | | | |
139
+ | NAV | | | |
140
+ | P&L | | | |
141
+
142
+ ## China-Specific Considerations
143
+
144
+ ### Fund Accounting Calendar
145
+
146
+ | Event | Timing |
147
+ |-------|--------|
148
+ | 估值日 | Daily / T+1 |
149
+ | 净值公告 | T+2 for daily NAV |
150
+ | 季报披露 | Within 15 days of quarter-end |
151
+ | 半年报 | Within 60 days of H1 end |
152
+ | 年报 | Within 90 days of year-end |
153
+
154
+ ### Cut-off Rules
155
+
156
+ | Item | Cut-off Rule |
157
+ |------|-------------|
158
+ | 交易 | Trade date basis |
159
+ | 收入 | Ex-dividend date |
160
+ | 费用 | Incurrence basis |
161
+ | 税费 | Withholding date |
162
+
163
+ ## Quality Checks
164
+
165
+ Before completing:
166
+ - [ ] Prior period closed properly
167
+ - [ ] Balances carried forward
168
+ - [ ] New period activity recorded
169
+ - [ ] NAV calculated correctly
170
+ - [ ] Reconciliation complete
171
+ - [ ] Performance calculated
172
+ - [ ] Reports generated
173
+ > **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
174
+ > - `ifind-only` (strict): Use iFind only, error if unavailable
175
+ > - `ifind-fallback` (default): iFind preferred, fallback to AkShare
176
+ > - `akshare-only`: Skip iFind, use AkShare only
177
+ > - `wind-only`: Wind only, error if unavailable
178
+ > - `wind-fallback`: Wind first, fallback to iFind → AkShare