AI 原生
接进 AI Agent（Agent Skill）
Skill 是给 AI 的一份「说明书」：装一次，之后你问 A 股问题，它已经知道该调哪个端点、字段什么单位、出错怎么办 —— 不用你把用法每次贴给它。
和 MCP 有什么区别
MCP 给 AI「工具」（它自己去调）；Skill 给 AI「知识」（怎么调、字段什么语义、坑在哪）。两者并列，按你的客户端和使用习惯选 —— 一个客户端可以两个都装。
| MCP | Skill | |
|---|---|---|
| 本质 | 协议 + 服务端 | 一个文件夹 + Markdown |
| 需要什么 | URL + Key（要服务器） | 复制一个目录（纯文件） |
| 给 AI 的 | 工具（22 个，自动调用） | 知识（端点/字段/错误/SDK 用法） |
| 支持客户端 | 19 家（支持远程 MCP） | 45+ 家（开放标准） |
| 适合 | AI 自己查数（对话式） | AI 写代码 / 理解字段 / 不支持的客户端 |
安装（任选一种）
2方式二：一条命令（Mac / Linux / WSL）
把 `~/.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.zip3方式三：放进项目（团队共享）
把 `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+ 家）—— 各家安装路径以它们自己的官方文档为准：
Junie (JetBrains)官方文档 ↗OpenHands官方文档 ↗Goose (Block)官方文档 ↗Amp官方文档 ↗Kiro (AWS)官方文档 ↗TRAE (字节)官方文档 ↗Command Code官方文档 ↗Roo Code官方文档 ↗Cline官方文档 ↗Factory (Droids)官方文档 ↗Deep Code官方文档 ↗Mistral AI Vibe官方文档 ↗Letta官方文档 ↗Mux (Coder)官方文档 ↗Emdash官方文档 ↗OpenClaw官方文档 ↗Hermes Agent官方文档 ↗Qodo官方文档 ↗Tabnine官方文档 ↗Snowflake Cortex Code官方文档 ↗Databricks Genie Code官方文档 ↗Spring AI官方文档 ↗Laravel Boost官方文档 ↗Pulumi Neo官方文档 ↗Superconductor官方文档 ↗Ona官方文档 ↗pi官方文档 ↗VT Code官方文档 ↗fast-agent官方文档 ↗bub官方文档 ↗nanobot官方文档 ↗ZeroClaw官方文档 ↗Autohand Code CLI官方文档 ↗Firebender官方文档 ↗Vita官方文档 ↗Agentman官方文档 ↗Workshop官方文档 ↗Piebald官方文档 ↗Google AI Edge Gallery官方文档 ↗Claude (claude.ai)官方文档 ↗
怎么确认装好了
重启客户端后，问它一句 A 股相关的问题（不用提 skill 的名字）：
- 太极实业（600667）现在什么价？
- 帮我查一下贵州茅台最近 5 天的 K 线
- 今天哪些板块涨得最好？
- 帮我找 PE 小于 20 且 ROE 大于 15 的股票（这句需要 Key）
装好后的差别：它会主动用 ashareapi 的接口去取数，而不是让你自己贴代码 —— 而且报错时知道「无数据」和「取数失败」是两回事。
skill 里有什么
四个参考文件按需加载（不做一次性灌给 AI，省上下文）：
SKILL.md
决策树：你要什么 → 用哪个端点；四个必知语义（单位/字符串/日期/返回结构）
references/endpoints.md
32 个端点的参数与返回要点
references/fields.md
字段语义与单位（volume 手 / amount 元 / 比率是百分数…）
references/errors.md
401/429/ok:false/空结果 的区别与处理，PoW 提额
references/sdk.md
官方 SDK 用法（Python: pip install ashareapi · Node.js: npm install ashareapi）