wind-mcp-skill

<!-- ENCODING: UTF-8. If Chinese text looks garbled, re-read this file as UTF-8 before routing. -->

Wind 金融数据查询

通过本 Skill 自带 CLI 调用 Wind MCP。金融事实以工具返回的数据与来源材料为依据；区分原始数据、来源观点和基于数据的推导，不把模型记忆、Web Search 或常识补全伪装成已核验数据。

按需渐进加载：明确需求 → 定位业务域 → 读取相关 reference 并确认工具覆盖 → 按需组织调用 → 核验结果。endpoint、请求头、认证和传输由 CLI 负责；模型不构造这些实现细节。

1. 定路由

根据金融对象和业务意图定位 server_type，再按契约确认工具是否支持所需数据、时间范围、粒度、口径及标的数量。已有信息足够时直接查询；缺少影响结果的必要信息且契约无适用默认值时，再向用户澄清。

server_type	首选场景	按需加载
stock_research	股票	references/stock/
fund_research	基金、ETF、REITs	references/fund/
options_data	期权	references/options/
futures_data	期货	references/futures/futures.md
company_data	企业、风控	references/company/
edb_data	宏观、行业与区域经济	references/economic/economic.md
index_data	指数、板块	references/index/index.md
bond_data	债券	references/bond/bond.md
financial_docs	公告与财经新闻	references/financial-docs/financial-docs.md
analytics_data	专项未覆盖的聚合与指标计算	references/analytics/analytics.md
general_data	专项未覆盖的通用金融行情、指标、报表、文档与投研参考资料	references/general/general.md

路由规则

优先使用能满足需求的专项工具；专项未覆盖所需数据、时间粒度、参数口径或批量能力时，检查 general_data 的对应契约。对象属于某一专项，不代表该专项覆盖其全部数据。例如，股票历史 K 线进入通用历史行情工具，指数 K 线使用指数专项工具。

单个工具支持完整需求时直接调用，包括契约支持的多标的或跨资产批量查询。只有需要不同工具或超过单次限制时才拆分；有依赖的调用先取得并复用前置结果。

交叉场景按所需结果分流：上市公司财务与估值进入 stock_research，工商、股权穿透与司法记录进入 company_data；行业研究资料与板块盘中综合分析进入 stock_research，指数档案、点位序列与预定义指标进入 index_data；公告与财经新闻检索优先 financial_docs，研报清单、单篇文档全文及精确类型/日期筛选进入 general_data 的文档链路。

analytics_data 用于预定义工具无法直接返回的跨标的聚合、自定义指标组合或数据加工，不替代已有行情、筛选、文档或宏观取数工具。基金归因、期权定价等已有专项计算优先使用对应专项工具。

文件导航

以下文件名相对于路由表中的对应目录，只读取与当前需求相关的文件：

• stock/：市场概览与热点读 market-overview.md；行业研究与板块盘中分析读 industry-sector-research.md；公司画像、财务、预期、估值与动态读 company-research.md；资金、技术与个股盘中分析读 trading-analysis.md；条件选股读 screener.md。
• fund/：档案与相似基金读 discovery-profile.md；业绩、风险、风格与归因读 performance-attribution.md；配置、持仓与 ETF 申赎清单读 allocation-holdings.md；净值、交易与申赎状态读 nav-trading.md；规模与财务读 size-financials.md；条件筛选读 screener.md。
• options/：期限、期权链、合约与品种行情统计读 contract-market.md；波动率曲面、锥与期限结构读 volatility.md；定价读 pricing.md；市场情绪读 sentiment.md。
• company/：主体搜索与工商读 discovery-registration.md；股权、人员与控制关系读 ownership-governance.md；客户、供应商与招投标读 business-relations.md；知识产权与资质读 intellectual-property-qualifications.md；司法记录读 judicial-enforcement.md；处罚、失信与税务读 compliance-tax.md；经营、融资与舆情风险读 operating-financing-risk.md；工具需要风险分类枚举时再读 risk-enums.md。
• 指数行情指定 indexes 字段时，再读 references/index/index-indicators.md；未指定时沿用工具默认字段。

2. 读契约

reference 用于选择工具和构造参数，MCP Server 负责最终校验。发现参数拒绝、工具缺失或契约疑似过期时，运行 node scripts/cli.mjs list-tools <server_type> 核对完整线上定义，定位相关工具，不必每次调用前重复获取。契约与实际返回仍冲突时，保留差异并说明限制，不猜参数或隐瞒兼容问题。

工具名与 server 名必须逐字使用：只能调用当前 reference 契约或 list-tools 返回中实际存在的 server_type 与 tool_name，不得凭记忆、推测或相似命名编造、改写工具名（包括大小写、单复数、前后缀变体）。目标工具在契约中找不到时，视为当前专项未覆盖，按路由规则改查 general_data 或运行 list-tools 核对，不尝试相似名称。

参数名、类型、枚举和必填项以当前工具契约为准；windcode、windCode、windCodes 不能互换，数组与逗号分隔字符串也须按字段类型填写。CLI 负责已实现的代码和参数兼容处理；Agent 不自行猜测交易所后缀。

工具支持自然名称且目标明确时，可直接查询，无需固定先调用筛选工具。需要识别、搜索或条件筛选时，按契约选择具备相应能力的工具；仅在实体、指标、报表或文档标识尚未明确且工具要求时执行前置发现。返回候选存在歧义或无法识别时，请用户确认准确全称或 Wind 标准代码，不静默选择。

用户未指定行业分类等口径时，保留工具契约的适用默认值，不统一强制填入 Wind 行业分类；多结果比较时核对分类、日期与统计口径是否一致。

3. 发命令

先切换到本 SKILL.md 所在目录，再执行：

node scripts/cli.mjs call <server_type> <tool_name> '<params_json>'

<server_type> 与 <tool_name> 直接取自已确认的契约条目，逐字替换，不做任何拼写调整。

示例：

node scripts/cli.mjs call stock_research stock_get_company_profile '{"windCode":"600519.SH"}'
node scripts/cli.mjs call fund_research fund_get_basic_info '{"windCodes":["005827.OF"]}'
node scripts/cli.mjs call company_data company_search_entity '{"searchKey":"贵州茅台"}'
node scripts/cli.mjs call edb_data economic_search_indicator '{"question":"中国GDP相关指标"}'

PowerShell、cmd 或被执行器二次包装时，优先将 UTF-8 JSON 从 stdin 传入并把最后一个参数写为 -，避免命令行转义破坏 JSON，也不需要向 Skill 安装目录写临时文件：

$requestJson='{"windCodes":["600519.SH"],"indexes":"\u6700\u65b0\u6210\u4ea4\u4ef7,\u4ea4\u6613\u65f6\u95f4"}'
$requestJson | node scripts/cli.mjs call general_data quote_get_realtime_indicators -

经过可能改写命令文本的 Windows 执行器时，命令中的非 ASCII JSON 值使用 \uXXXX 转义。已有 UTF-8 JSON 文件时也可用 @<文件路径> 传入；临时文件必须位于客户端允许写入的临时目录或工作区，不得写入 Skill 安装目录，也不得复用共享请求文件。

认证由 CLI 处理。仅在实际调用明确返回认证失败或凭证缺失时报告认证问题，不预先猜测；不得在输出、日志或交付文件中写入 Key。

批量与并发

优先使用工具支持的批量参数，并遵守单次上限。确需逐项调用时默认串行，先验证首项的结果与口径再继续。出现认证、限流或服务故障时停止受影响批次；参数问题按下方规则修正后再继续。用户明确要求并发时上限 10，有前置依赖的步骤仍按顺序执行。

4. 验回执

正常返回时 stdout 为 MCP 结果对象，正文通常位于 content[0].text，CLI 另附 cli_meta。检查相关 content 项：可解析为 JSON 时按结构读取，否则按原始文本或表格读取；同时检查 cli_meta.warnings。退出码为 0 或 isError: false 不代表业务成功，正文中的参数拒绝、认证或执行失败信息仍须处理。

核验代码、名称及实体类型与用户目标一致，例如基金管理公司不能作为基金产品作答。检查实际日期、频率、单位、量级、币种及统计口径；元数据缺失、互相矛盾或不适用于某个资产时，保留原值并说明限制，不猜测或强行换算。需要计算或单位转换时，必须有明确输入口径和可说明的计算依据。

按请求的标的、字段和区间核对覆盖范围，不能仅信返回的总数或成功摘要。仅当整个目标无有效数据且无执行错误时报告 NO_RESULTS；部分有效时返回有效部分并说明缺失、失败或不适用项，标为 DONE_WITH_LIMITS。缺失值不得当作 0，也不得将局部空表视为整个请求无结果。

错误与恢复

CLI 失败通常返回 { "ok": false, "code": "...", "message": "..." }，也可能在 MCP 正文中出现失败说明。backend_error 可能包含可修正的参数错误，不能仅凭该代码判定服务故障。依据错误内容处理：

• 缺字段、类型、枚举或参数组合错误：按明确错误及当前契约修正，保持用户的筛选条件、日期和口径；必要值无法确定时澄清，不擅自补值。
• 身份歧义或实体类型错配：不使用错配结果作答，确认目标后再查询。
• 认证、额度或限流：停止受影响调用，按实际原因说明；限流不等同额度耗尽。
• 明确后端执行故障：保留原始错误，标为 BLOCKED_BACKEND，无需通过其他服务复现；本地执行或网络传输阻断标为 BLOCKED_RUNTIME，说明具体阶段。

同一请求的有效结果在时点仍适用时复用。参数错误须有修正依据才重试；明确可重试的暂时性故障仅在满足返回的恢复条件后原样重试一次，仍失败则停止，不用换工具掩盖失败。只有契约表明原工具不支持需求时才调整业务路由。合法空结果不盲目重试或放宽条件。

成功返回数据时，在答复末尾附与用户语言一致的来源声明：

数据来源于 Wind Alice 万得金融数据服务。

Data sourced from Wind Alice Financial Data Service.