china-skill-creator

china-skill-creator

用途

创建新的 china- 技能*——为中国金融服务插件生态系统搭建并模板化新技能。

适用场景

在以下情况下使用此技能：

• 从头创建新的 china-* 技能
• 将现有的 plugins/ 技能改编为适用于中国的版本
• 为 china/ 目录扩展新功能
• 确保与现有 china-* 技能模式保持一致

技能创建模式

第 1 步：选择垂直领域

垂直领域映射：

原始垂直领域	中国垂直领域	路径
financial-analysis/	china-finance/	china/vertical-plugins/china-finance/skills/
equity-research/	china-finance/	china/vertical-plugins/china-finance/skills/
investment-banking/	investment-banking/	china/vertical-plugins/investment-banking/skills/
private-equity/	private-equity/	china/vertical-plugins/private-equity/skills/
wealth-management/	wealth-management/	china/vertical-plugins/wealth-management/skills/
fund-admin/	fund-admin/	china/vertical-plugins/fund-admin/skills/
operations/	operations/	china/vertical-plugins/operations/skills/

第 2 步：命名规范

命名规则：

• 所有中国技能均使用 china- 前缀
• 沿用原技能名称：china-[original-name]
• 使用小写字母并以连字符分隔：china-3-statement-model
• 目录名称与技能名称一致

示例：

原始名称	中国版本
comps-analysis	china-comps-analysis
earnings-analysis	china-earnings-analysis
client-report	china-client-report

第 3 步：Frontmatter 模板

必需的 frontmatter：

---
name: china-[skill-name]
description: [Chinese + English description]. Triggers on "A股[keywords]", "[Chinese keywords]", "[English keywords]", or "[example usage]".
---

Frontmatter 规则：

• name：使用小写字母并以连字符分隔，前缀为 china-
• description：包含中文触发词和英文备用内容
• 必须包含 --- 分隔符

第 4 步：SKILL.md 结构模板

标准结构：

---
name: china-[skill-name]
description: [description with triggers]
---

# china-[skill-name]

## Purpose

[One-line description in Chinese + English]

## Data Sources

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

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

\```python
get_quote(ticker)                     → [what it returns]
get_financials(ticker, "income")      → [what it returns]
\```

### Secondary Sources
- 巨潮 — [usage]
- 上交所/深交所 — [usage]
- Wind / Choice — [usage]

## Workflow

### Step 1: [Step Name]

[Content]

### Step 2: [Step Name]

[Content]

[... more steps ...]

## China-Specific Considerations

### [Topic]

[China-specific guidance]

## Quality Checks

Before delivering:
- [ ] [Check 1]
- [ ] [Check 2]
- [ ] [Check 3]

第 5 步：中国适配检查清单

根据原始技能进行改编时：

适配领域	中国特定改动
数据来源	将西方数据源替换为 iFind/AkShare/巨潮/同花顺
会计	US GAAP → CAS
税务	美国税务 → 25% 中国企业所得税
货币	USD → CNY (¥)
单位	$M → 万元 / 亿元
术语	英文 → 中文（归母净利润等）
市场	美国市场 → A 股（主板/创业板/科创板）
监管	SEC → CSRC / 证监会
行业	美国行业板块 → 东方财富分类
报告	10-K/Q → 年报/季报

第 6 步：必需章节

每个 china-* SKILL.md 都必须包含：

章节	必需？	内容
name	✓	Frontmatter，使用 china- 前缀
description	✓	中文 + 英文，含触发词
## Purpose	✓	单行描述
## Data Sources	✓	iFind MCP（主要）+ AkShare（备用）
## Workflow	✓	分步流程
## China-Specific Considerations	✓	中国适配内容
## Quality Checks	✓	交付前检查清单

第 7 步：数据源工具参考（iFind + AkShare）

常用工具：

# Market data
get_quote(ticker)                    → Current quote
get_historical_data(ticker)          → Historical prices
get_index_data(index_code)           → Index data
get_market_overview()                → Market summary

# Financials
get_financials(ticker, "income")     → Income statement
get_financials(ticker, "balance")    → Balance sheet
get_financials(ticker, "cashflow")   → Cash flow

# Industry & peers
get_industry_stocks(industry="...")   → Industry peers
get_stock_info(ticker)               → Company info

# Funds
get_fund_data(fund_code)             → Fund data

# News (china-news MCP — separate server)
get_stock_news(ticker="{{TICKER}}")         → Individual stock news
get_market_headlines(top_n=20)              → Market headlines

第 8 步：常见模式

应使用的 CAS 会计术语：

• 营业收入（扣除增值税后的收入）
• 营业成本（销售成本）
• 归母净利润（归属于母公司的净利润）
• 扣非净利润（非 GAAP 净利润）
• 经营现金流（经营活动现金流）
• 资本支出（资本开支）
• EPS（每股收益）
• ROE（净资产收益率）
• 毛利率（毛利率）
• 净利率（净利率）

A 股惯例：

• 股票代码：6 位数字（例如，“600519”、“000001”）
• 不加交易所前缀
• 主板/创业板/科创板/北交所
• 涨跌停：±10%（创业板/科创板为 ±20%）
• 单位：千元 / 万元 / 亿元

税务惯例：

• 企业所得税：25%（高新技术企业为 15%）
• 增值税：13%（标准税率），不计入收入
• 印花税：卖方按 0.05% 缴纳
• 股息税：20%（持有超过 1 年为 10%）

第 9 步：禁止的模式

china-* 技能中绝不能使用：

西方数据源、指数和申报系统必须替换为中国本土的对应方案（iFind / AkShare / 巨潮 / 上交所 / 深交所 / 中证指数 / 东方财富 / 企查查 / 晨星中国）。check-china.py 验证脚本会对此进行强制检查——任何包含这些模式的技能都会验证失败。

完整映射请参阅“中国适配检查清单”（第 5 步）。

第 10 步：验证

创建新技能后：

# Check for forbidden patterns
cd china && python3 scripts/check-china.py

# Sync to agent bundles
python3 scripts/sync-china-skills.py

快速入门模板

---
name: china-[name]
description: [Chinese description with triggers].
---

# china-[name]

## Purpose

[Chinese + English description]

## Data Sources

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

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

\```python
get_quote(ticker) → [description]
\```

### Secondary Sources
- 巨潮 — [usage]

## Workflow

### Step 1: [Name]

[Content]

### Step 2: [Name]

[Content]

## China-Specific Considerations

[Content]

## Quality Checks

Before delivering:
- [ ] [Check 1]
- [ ] [Check 2]

示例：创建新技能

**场景：**创建 china-portfolio-optimization

1. 选择垂直领域：china-finance（金融分析）
2. 创建目录：china/vertical-plugins/china-finance/skills/china-portfolio-optimization/
3. **创建 SKILL.md：**使用上方模板
4. 添加中国适配：
   • 使用 A 股范围
   • 考虑涨跌停限制
   • 纳入北向资金流向因素
   • 使用东方财富行业分类
5. **同步：**运行 sync-china-skills.py
6. **验证：**运行 check-china.py

数据源模式切换：设置环境变量 IFIND_DATA_SOURCE_MODE 以控制数据源偏好。

• ifind-only（严格）：仅使用 iFind；不可用时返回错误
• ifind-fallback（默认）：优先使用 iFind，不可用时回退到 AkShare
• akshare-only：跳过 iFind，仅使用 AkShare