接进 AI Agent(Agent Skill)
Skill 是给 AI 的一份「说明书」:装一次,之后你问 A 股问题,它已经知道该调哪个端点、字段什么单位、出错怎么办 —— 不用你把用法每次贴给它。
MCP 给 AI「工具」(它自己去调);Skill 给 AI「知识」(怎么调、字段什么语义、坑在哪)。两者并列,按你的客户端和使用习惯选 —— 一个客户端可以两个都装。
| MCP | Skill | |
|---|---|---|
| 本质 | 协议 + 服务端 | 一个文件夹 + Markdown |
| 需要什么 | URL + Key(要服务器) | 复制一个目录(纯文件) |
| 给 AI 的 | 工具(32 个,自动调用) | 知识(端点/字段/错误/SDK 用法) |
| 支持客户端 | 19 家(支持远程 MCP) | 45+ 家(开放标准) |
| 适合 | AI 自己查数(对话式) | AI 写代码 / 理解字段 / 不支持的客户端 |
安装(任选一种)
把 ~/.claude/skills 换成你客户端的目录(见下表)。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -sL https://ashareapi.com/ashareapi-skill.zip -o s.zip && unzip -oq s.zip && rm s.zip把 ashareapi/ 放进项目的 skills 目录并提交 git —— 之后团队每个人克隆下来就有。
客户端路径
| 客户端 | 全局(所有项目) | 项目内(提交 git) |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| opencode | ~/.config/opencode/skills/ | .opencode/skills/ |
| Cursor | ~/.claude/skills/ | .cursor/skills/ |
| Codex (OpenAI) | ~/.codex/skills/ | .codex/skills/ |
| Antigravity (Google) | ~/.gemini/antigravity/skills/ | .agents/skills/ |
| VS Code / GitHub Copilot | ~/.copilot/skills/ | .github/skills/ |
| WorkBuddy | — | .workbuddy/skills/ |
| DeepSeek Harness (DSH) | ~/.dsh/skills/ | .dsh/skills/ |
~ 是用户主目录。不知道用哪个?放 .claude/skills/ 或 .agents/skills/ 都行 —— 这两个是「通用目录」,Claude Code / opencode / Cursor / Antigravity / DeepSeek Harness 都能读到。完整客户端列表见 agentskills.io/clients。
.claude/skills/ · .agents/skills/
更多支持的客户端
同一开放标准还支持下面这些(共 45+ 家)—— 各家安装路径以它们自己的官方文档为准:
怎么确认装好了
重启客户端后,问它一句 A 股相关的问题(不用提 skill 的名字):
- 太极实业(600667)现在什么价?
- 帮我查一下贵州茅台最近 5 天的 K 线
- 今天哪些板块涨得最好?
- 帮我找 PE 小于 20 且 ROE 大于 15 的股票(这句需要 Key)
装好后的差别:它会主动用 ashareapi 的接口去取数,而不是让你自己贴代码 —— 而且报错时知道「无数据」和「取数失败」是两回事。
skill 里有什么
四个参考文件按需加载(不做一次性灌给 AI,省上下文):
免费端点(行情 / K线 / 热搜 / 市场总览 / 涨跌分布 / 文档检索)无需 Key —— 装上就能试。需要财报 / 资金流 / 龙虎榜时再拿 Key。