modelstudioai · XXPermanentXX · Aug 21, 2026 · Aug 21, 2026
diff --git a/README.md b/README.md
@@ -65,7 +65,7 @@ These skills ship with this repository and are maintained by the ModelStudio tea
 |-------|----------------|
 | [`bailian-docs-llm-wiki`](./skills/bailian-docs-llm-wiki/) | Routes the Agent through the in-repo **Bailian docs library** for model specs and pricing, API/error codes, agents/RAG/knowledge base, SDKs and multimodal, billing, etc. Start from `models/index.md` and `wiki/index.md`, then drill down. |
 | [`bailian-model-recommend`](./skills/bailian-model-recommend/) | **Model selection & recommendation**: given a scenario or feature need, picks the best-fit Bailian model and hands back ready-to-run sample code. Activates on "recommend / which model / compare." Reads the `models/` data from `bailian-docs-llm-wiki`. |
-| [`financial-expert`](./skills/financial-expert/) | **Financial data analysis** over China A-shares, funds, and bonds via `bl mcp` (`market-cmapi00073529`): stock/fund/fund-manager screening, financials (net profit / revenue / ROE), macro & industry time series (GDP / CPI), broker research reports, and listed-company filings. |
+| [`financial-expert`](./skills/financial-expert/) | **Financial data analysis** via `bl mcp` (`market-cmapi00073529`) for China and Hong Kong securities, funds, bonds, indices, global macro and industry series, broker research, company and fund announcements, financial news, and enterprise risk. Live tools include `NewsDataQuery` and `IcEnterpriseDataQuery`. |
 | [`happyhorse-prompt-studio`](./skills/happyhorse-prompt-studio/) | **Interactive prompt studio for HappyHorse 1.0 video**: guides scenario discovery with vivid examples, then assembles production-ready prompts in JP/CN/EN. Covers manga drama, character PV, manga motion, virtual idol MV, and free-form scenarios. |
 | [`spark-video`](./skills/spark-video/) | **End-to-end short-film production**: screenwriter ↔ director (per scene) → parallel render DAG → per-clip QA → stitch. Best for “make me an episode / a product ad in one go.” The entry skill registers as **`spark-video-episode`** (see [`SKILL.md`](./skills/spark-video/SKILL.md)). |
 | [`novel-game`](./skills/novel-game/) | **Novel-to-interactive-fiction game (React SPA)**: branching story engine + AI-generated character portraits & cutscenes (video or image) + optional TTS narration + procedural Web Audio music & SFX + localStorage save slots + multiple UI themes (pixel / cyberpunk / ink / minimalist). Activates on "interactive fiction / text adventure / visual novel / novel-to-game". Assets are generated offline via `bl video / image / speech`; runtime is fully local. |

diff --git a/README.zh.md b/README.zh.md
@@ -65,7 +65,7 @@ npx skills add modelstudioai/skills
 |------|------|
 | [`bailian-docs-llm-wiki`](./skills/bailian-docs-llm-wiki/) | 引导 Agent 查阅仓库内置的**百炼文档库**：模型规格与定价、API/错误码、智能体/RAG/知识库、SDK 与多模态、计费等。从 `models/index.md` 和 `wiki/index.md` 开始逐层查阅。 |
 | [`bailian-model-recommend`](./skills/bailian-model-recommend/) | **模型选型与推荐**：根据场景或功能需求，从百炼模型库中推荐最合适的模型并附可直接运行的示例代码。命中"推荐 / 选哪个 / 对比"等意图时激活，内部读取 `bailian-docs-llm-wiki` 的 `models/` 数据。 |
-| [`financial-expert`](./skills/financial-expert/) | **金融数据分析**：基于 `bl mcp`（`market-cmapi00073529`），覆盖中国 A 股、基金、债券。支持选股 / 基金 / 基金经理筛选、财务数据（净利润 / 营收 / ROE）、宏观与行业时序（GDP / CPI）、券商研报、上市公司公告检索。 |
+| [`financial-expert`](./skills/financial-expert/) | **金融数据分析**：基于 `bl mcp`（`market-cmapi00073529`），覆盖 A 股、港股、基金、债券与指数，支持股票 / 基金 / 基金经理筛选、财务估值、全球宏观与行业时序、券商研报、公司及基金公告、财经新闻和企业风险查询。实时工具包括 `NewsDataQuery` 与 `IcEnterpriseDataQuery`。 |
 | [`happyhorse-prompt-studio`](./skills/happyhorse-prompt-studio/) | **HappyHorse 1.0 视频提示词工作室**：用生动示例引导用户发现场景，再组装出 日/中/英 三语的成片级 Prompt。覆盖漫剧、角色 PV、漫画运动、虚拟偶像 MV 及自由创作场景。 |
 | [`spark-video`](./skills/spark-video/) | **端到端短片制作**：编剧 ↔ 导演（逐场景）→ 并行渲染 DAG → 逐 clip 审片 → 拼接。适合"帮我做一集短剧/产品广告"一句话出片。入口技能注册为 **`spark-video-episode`**（见 [`SKILL.md`](./skills/spark-video/SKILL.md)）。 |
 | [`novel-game`](./skills/novel-game/) | **小说改编互动小说网页游戏（React SPA）**：分支剧情引擎 + AI 生成角色立绘/过场（视频或图片）+ 可选 TTS 旁白 + 程序化 Web Audio 音频 + localStorage 存档 + 多种 UI 风格（像素 / 赛博朋克 / 水墨 / 简约）。命中"互动小说 / 文字冒险 / 视觉小说 / 小说改编游戏"时激活，全程通过 `bl video / image / speech` 离线生成素材后本地运行。 |

diff --git a/skills/financial-expert/README.md b/skills/financial-expert/README.md
@@ -1,89 +1,76 @@
-# financial-expert
+# Financial Data Analysis
 
-> [中文版 / Chinese →](README.zh.md)
+> [中文说明 →](README.zh.md)
 
-Financial data analysis skill powered by **Alibaba Cloud Model Studio MCP** (`bl mcp` + `market-cmapi00073529`) — covering China A-share stocks, mutual funds, bonds, macro indicators, broker research reports, and listed-company filings.
+This skill uses Aliyun Model Studio CLI `bl mcp` and the financial MCP server `market-cmapi00073529` to query China and Hong Kong securities, funds, fund managers, company financials and valuation, global macro and industry data, broker research, disclosures, financial news, and enterprise risk data. It provides sourced facts and neutral analysis only; it does not trade, recommend securities, or predict prices.
 
-## What it does
+## Coverage
 
-Ask your agent financial questions in natural language, and this skill will:
+- A-share screening, plus structured data for supported A-share, Hong Kong, fund, bond, and index instruments
+- Fund and fund-manager screening
+- GDP, CPI, core PCE, and industry production, sales, and price series across China and other major economies
+- Broker research reports
+- A-share, Hong Kong company, and public-fund announcements
+- Financial news and enterprise registration, compliance, and judicial-risk data
 
-1. **Parse your intent** — identify the target (stock / fund / industry), filters (ROE > 15%, growth > 30%), and data type
-2. **Route to the right tool** — stock screening, fund screening, fund manager screening, financial data query, macro/industry time-series, research reports, or company announcements
-3. **Call the MCP service** — `bl mcp call market-cmapi00073529.<Tool> --query "..."` and return structured results
-4. **Present the data** — formatted tables, charts, or summaries ready for analysis
+Treat the live tool schema as authoritative:
 
-## When to use
-
-| Scenario | Example |
-|----------|---------|
-| Stock screening | "Find consumption stocks with ROE > 15% and net profit growth > 30%" |
-| Fund screening | "Low-risk bond funds with 3-year annualized return above 5%" |
-| Fund manager screening | "Managers with AUM > 10B and top-quartile performance" |
-| Financial data | "Kweichow Moutai's net profit for the past 3 years" |
-| Macro / industry data | "China GDP quarterly growth for 2023–2025" |
-| Research reports | "Latest broker reports on the new energy vehicle sector" |
-| Company filings | "PetroChina's recent major-event announcements" |
+```bash
+bl mcp tools --server market-cmapi00073529 --output json
+```
 
-**Not for this skill:**
-- Non-China markets (US stocks, crypto, forex)
-- Real-time trading / order execution
-- Investment advice — data only, decisions are yours
+## Authentication
 
-## Quick examples
+- `bl mcp list` uses a Console session and is only needed to discover a Server Code.
+- `bl mcp tools` and `bl mcp call` use a DashScope API Key. When `market-cmapi00073529` is already known, skip `mcp list`.
 
 ```bash
-# Stock screening
-bl mcp call market-cmapi00073529.SmartStockSelection \
-  --query "筛选净利润增速超过 30% 且 ROE 大于 15% 的消费股"
+bl auth status --output json
 
-# Fund screening
-bl mcp call market-cmapi00073529.SmartFundSelection \
-  --query "近三年年化收益超过 10% 的股票型基金"
+# Only for mcp list; domestic is the default and may be selected explicitly
+bl auth login --console --console-site domestic
+```
 
-# Financial data
-bl mcp call market-cmapi00073529.FinQuery \
-  --query "贵州茅台 2024 年净利润和营收"
+## Tools
 
-# Macro data
-bl mcp call market-cmapi00073529.MacroIndustryData \
-  --query "2023-2025 中国季度 GDP 增速"
+| Tool | Purpose |
+|---|---|
+| `SmartStockSelection` | Multi-factor A-share screening |
+| `SmartFundSelection` | Fund screening |
+| `SmartFundManagerSelection` | Fund-manager screening |
+| `FinQuery` | Financials, market data, valuation, and instrument facts |
+| `MacroIndustryData` | Macro and industry time series across major economies |
+| `FinancialResearchReport` | Broker research |
+| `AnnouncementData` | A-share, Hong Kong company, and public-fund announcements |
+| `NewsDataQuery` | Financial news and public updates |
+| `IcEnterpriseDataQuery` | Enterprise registration, compliance, and judicial risk |
+
+## Quick example
 
-# Research reports
-bl mcp call market-cmapi00073529.FinancialResearchReport \
-  --query "新能源汽车行业最新券商研报"
+```bash
+bl mcp call \
+  --target market-cmapi00073529.FinQuery \
+  --query "Query Kweichow Moutai (600519.SH) revenue, parent net profit, and ROE for its latest complete fiscal year" \
+  --output json
 ```
 
-## Prerequisites
-
-This skill requires Alibaba Cloud Model Studio CLI (`bl`). Before using this skill, check if `bl` is installed:
+For “latest” or “latest complete fiscal year,” do not hard-code a year. Capture the actual query time and verify the reporting period returned by the tool:
 
 ```bash
-bl --version
+TZ=Asia/Shanghai date '+%F %T %Z'
 ```
 
-If not installed or the command is not found, follow the install guide:
+See [SKILL.md](SKILL.md) for routing, error handling, and output requirements.
 
-> https://bailian.aliyun.com/cli/install.md
+## Prerequisites
 
-Also log in to the Bailian console:
+Install [Aliyun Model Studio CLI](https://bailian.aliyun.com/cli/install.md) and configure a DashScope API Key:
 
 ```bash
-bl auth login --console
+export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
+bl auth status --output json
 ```
 
-## Available tools
-
-| Tool | Purpose |
-|------|---------|
-| `SmartStockSelection` | Multi-dimension A-share stock screening |
-| `SmartFundSelection` | Fund screening by performance, risk, holdings, type |
-| `SmartFundManagerSelection` | Fund manager screening by AUM, style, track record |
-| `FinQuery` | Structured financial data (income, valuation, quotes) |
-| `MacroIndustryData` | Macro & industry time-series (GDP, CPI, production) |
-| `FinancialResearchReport` | Broker research report search |
-| `AnnouncementData` | Listed-company filing / announcement search |
-
 ## License
 
 Apache-2.0
diff --git a/skills/financial-expert/README.zh.md b/skills/financial-expert/README.zh.md
@@ -2,88 +2,75 @@
 
 > [English →](README.md)
 
-基于**阿里云百炼 MCP**（`bl mcp` + `market-cmapi00073529`）的金融数据分析技能 — 覆盖中国 A 股、基金、债券、宏观指标、券商研报与上市公司公告。
+基于阿里云百炼 CLI `bl mcp` 与金融 MCP `market-cmapi00073529`，查询 A 股、港股、基金、基金经理、财务估值、全球宏观与行业数据、券商研报、公告、财经新闻和企业风险信息。仅提供数据与中立分析，不下单、不荐股、不预测涨跌。
 
-## 功能简介
+## 支持范围
 
-用自然语言向 Agent 提出金融问题，本技能会：
+- A 股筛选，以及 A 股、港股、基金、债券、指数等结构化查询
+- 基金与基金经理筛选
+- 中国及全球主要经济体 GDP、CPI、核心 PCE，以及行业产量、销量和价格时序
+- 券商研报
+- A 股、港股公司及公募基金公告
+- 财经新闻、企业工商、合规与司法风险
 
-1. **解析意图** — 识别标的（股票 / 基金 / 行业）、筛选条件（ROE > 15%、增速 > 30%）和数据类型
-2. **路由工具** — 选股、基金筛选、基金经理筛选、财务数据、宏观/行业时序、研报、公告
-3. **调用 MCP 服务** — `bl mcp call market-cmapi00073529.<工具> --query "..."` 返回结构化结果
-4. **呈现数据** — 格式化的表格、图表或摘要，方便分析
+实际范围以实时工具 schema 为准：
 
-## 适用场景
+```bash
+bl mcp tools --server market-cmapi00073529 --output json
+```
 
-| 场景 | 示例 |
-|------|------|
-| 选股 | "筛选 ROE > 15% 且净利润增速 > 30% 的消费股" |
-| 基金筛选 | "低风险债券基金，近三年年化 > 5%" |
-| 基金经理筛选 | "管理规模超百亿、业绩排名前 25% 的经理" |
-| 财务数据 | "贵州茅台近三年净利润" |
-| 宏观/行业数据 | "2023–2025 中国季度 GDP 增速" |
-| 券商研报 | "新能源汽车行业最新研报" |
-| 公司公告 | "中国石油最近的重大事项公告" |
+## 鉴权说明
 
-**不适用：**
-- 非中国市场（美股、港股、加密货币）
-- 实时交易 / 下单
-- 投资建议 — 仅提供数据，决策由你做
-
-## 快速示例
+- `bl mcp list` 使用 Console 登录态，仅用于发现 Server Code。
+- `bl mcp tools` 和 `bl mcp call` 使用 API Key；已知 `market-cmapi00073529` 时不必先调用 list。
 
 ```bash
-# 选股
-bl mcp call market-cmapi00073529.SmartStockSelection \
-  --query "筛选净利润增速超过 30% 且 ROE 大于 15% 的消费股"
+bl auth status --output json
 
-# 基金筛选
-bl mcp call market-cmapi00073529.SmartFundSelection \
-  --query "近三年年化收益超过 10% 的股票型基金"
+# 只有需要 mcp list 时才登录 Console；国内站是默认值，也可显式指定
+bl auth login --console --console-site domestic
+```
 
-# 财务数据
-bl mcp call market-cmapi00073529.FinQuery \
-  --query "贵州茅台 2024 年净利润和营收"
+## 可用工具
 
-# 宏观数据
-bl mcp call market-cmapi00073529.MacroIndustryData \
-  --query "2023-2025 中国季度 GDP 增速"
+| 工具 | 用途 |
+|---|---|
+| `SmartStockSelection` | A 股多维筛选 |
+| `SmartFundSelection` | 基金筛选 |
+| `SmartFundManagerSelection` | 基金经理筛选 |
+| `FinQuery` | 财务、行情、估值和证券资料 |
+| `MacroIndustryData` | 中国及全球主要经济体宏观与行业时序 |
+| `FinancialResearchReport` | 券商研报 |
+| `AnnouncementData` | A 股、港股公司及公募基金公告 |
+| `NewsDataQuery` | 财经新闻与公开动态 |
+| `IcEnterpriseDataQuery` | 企业工商、合规与司法风险 |
 
-# 券商研报
-bl mcp call market-cmapi00073529.FinancialResearchReport \
-  --query "新能源汽车行业最新券商研报"
-```
+## 快速示例
 
-## 前置要求
+```bash
+bl mcp call \
+  --target market-cmapi00073529.FinQuery \
+  --query "查询贵州茅台（600519.SH）最近一个完整财年的营业收入、归母净利润和 ROE" \
+  --output json
+```
 
-本技能依赖阿里云百炼 CLI（`bl`）。在使用本技能前，请先检查 `bl` 是否已安装：
+用户说“最新”或“最近一个完整财年”时，不要自行写死年份。先获取实际查询时间，再检查工具返回的报告期：
 
 ```bash
-bl --version
+TZ=Asia/Shanghai date '+%F %T %Z'
 ```
 
-如果未安装或命令不存在，请阅读以下安装文档并按照说明完成安装：
+完整调用、错误处理与输出规则见 [SKILL.md](SKILL.md)。
 
-> https://bailian.aliyun.com/cli/install.md
+## 前置要求
 
-此外还需登录百炼控制台：
+安装 [阿里云百炼 CLI](https://bailian.aliyun.com/cli/install.md)，并配置 DashScope API Key：
 
 ```bash
-bl auth login --console
+export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
+bl auth status --output json
 ```
 
-## 可用工具
-
-| 工具 | 用途 |
-|------|------|
-| `SmartStockSelection` | 多维度 A 股选股 |
-| `SmartFundSelection` | 按业绩、风险、持仓、类型筛选基金 |
-| `SmartFundManagerSelection` | 按管理规模、风格、业绩筛选基金经理 |
-| `FinQuery` | 结构化财务数据（利润、估值、行情） |
-| `MacroIndustryData` | 宏观与行业时序数据（GDP、CPI、产销价） |
-| `FinancialResearchReport` | 券商研报检索 |
-| `AnnouncementData` | 上市公司公告检索 |
-
 ## License
 
 Apache-2.0