AI Skills 概述
MCP 工具是「原子能力」——单次取一类数据,由模型按需自动调用。Skills 则是面向场景的高层技能:把「调哪些工具、怎么算、怎么归纳」编排成一段专家写好的模板,通过 MCP 协议的 Prompts 能力暴露,让用户在客户端里一键触发一条完整分析链路。
Skills 落地为真正的 MCP Prompts(prompts/list + prompts/get),server 在 initialize 声明 capabilities.prompts。支持 Prompts 的客户端(Claude Desktop、Claude Code、Cursor、Cline 等)会把技能渲染成 斜杠命令 / 模板选项。
技能是怎么工作的
关键认知:server 不执行技能。prompts/get 只是把一段插值好参数的「任务说明书」交给客户端的模型,说明书里点名该调哪些真实工具。真正的多步执行由客户端模型 + tools/call 循环完成。
一次 analyze_stock 的完整交互:
- 发现:客户端连上 server 后发
prompts/list,把技能渲染成 UI 里的斜杠命令 / 模板。 - 选择 + 填参:用户选
analyze_stock,按参数填symbol(必填)、period(可选,默认 daily)。 - 取模板:客户端发
prompts/get,server 插值出任务说明书,回一条usermessage。 - 注入:说明书作为用户轮的起始内容进入对话——server 到此退场。
- 模型自跑:模型按说明书依次
tools/call(search→get_kline_with_indicators→get_kline_signals)。 - 产出:模型按模板规定的结构作答,且用用户的语言(模板末尾统一指示「respond in the user's language」,指令体是英文但你中文提问仍得中文分析)。
所以 Skill 的价值不在「解锁能力」,而在标准化编排 + 降低模型漏调/错调 + 给非专家用户一键入口 + 统一免责与安全纪律。
内置了哪些技能
分 core(默认 4 个)与 full(进阶 3 个)两级,与工具集独立过滤:
- core:
analyze_stock个股技术分析、screen_stocks智能选股、market_overview市场概览、monitor_watchlist自选监控 - full:
analyze_capital_flow资金面、analyze_fund基金分析、diagnose_stock综合诊断
每个技能的参数、底层工具与提问示例见 技能清单。
启用与触发
所有 MCP 客户端走同一个入口 npx -y stock-sdk mcp,只有配置文件路径和 UI 入口不同。以 Claude Desktop 为例(claude_desktop_config.json):
{
"mcpServers": {
"stock-sdk": {
"command": "npx",
"args": ["-y", "stock-sdk", "mcp"],
"env": {
"STOCK_SDK_MCP_TOOLS": "full", // 工具集范围(已有)
"STOCK_SDK_MCP_PROMPTS": "full" // 技能集范围(缺省 core)
}
}
}
}- Claude Code:
claude mcp add stock-sdk -e STOCK_SDK_MCP_PROMPTS=full -- npx -y stock-sdk mcp,技能作为斜杠命令/mcp__stock-sdk__analyze_stock出现。 - Cursor / Cline:粘贴同一段
mcpServersJSON 到.cursor/mcp.json或扩展的 MCP 设置。
STOCK_SDK_MCP_PROMPTS 取值:core(默认,4 个)/ full(全部 7 个)/ 逗号分隔的技能名单。不支持 Prompts 的老客户端会自动只看到工具,不受影响。
full 技能需要 full 工具集
技能集与工具集独立过滤。3 个 full 技能(analyze_capital_flow / analyze_fund / diagnose_stock)会点名 full 层工具,所以启用 full 技能时务必同时设 STOCK_SDK_MCP_TOOLS=full。若只开 STOCK_SDK_MCP_PROMPTS=full 而工具集仍是默认 core,模型编排到 full 工具那步会拿到「Unknown tool」。server 启动时若检测到这种错配,会在 stderr 打一条告警。上面的示例配置已成对设好,照抄即可。
只读安全
所有技能底层全是只读工具,且每个模板结尾统一声明「仅取数与分析,不下单、不移动资金;数据缺失就如实说明」。相对同类「能下单」的金融 MCP,这是明确的安全边界。