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：フロントマターのテンプレート

必須のフロントマター：

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

フロントマターのルール：

• 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	✓	フロントマター、china- プレフィックス
description	✓	中国語 + 英語、トリガー
## Purpose	✓	1 行の説明
## 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 会計用語：

• 营业收入（売上高、VAT 控除後）
• 营业成本（売上原価）
• 归母净利润（親会社株主に帰属する純利益）
• 扣非净利润（非 GAAP 純利益）
• 经营现金流（営業キャッシュフロー）
• 资本支出（設備投資）
• EPS（1 株当たり利益）
• ROE（自己資本利益率）
• 毛利率（粗利益率）
• 净利率（純利益率）

A 株の慣例：

• 株式コード：6 桁（例："600519"、"000001"）
• 取引所の接頭辞なし
• 主板/创业板/科创板/北交所
• 値上がり・値下がり制限：±10%（创业板/科创板 は ±20%）
• 千元 / 万元 / 亿元 単位

税制上の慣例：

• 法人税：25%（高新技术企业 は 15%）
• VAT：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 のみを使用