> Source: https://ashareapi.com/skill/ · Markdown version for LLMs / AI agents 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 写代码 / 理解字段 / 不支持的客户端 ## 安装（任选一种） 1 方式一：下载解压（最省事） 下载 zip，解压到你的客户端 skills 目录（下表）。装完**重启客户端**即可。 [下载 ashareapi-skill.zip](/ashareapi-skill.zip) 约 20 KB · 5 个文件 · MIT 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.zip ``` 3 方式三：放进项目（团队共享） 把 `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) 官方文档 ↗](https://junie.jetbrains.com/docs/agent-skills.html)[OpenHands 官方文档 ↗](https://docs.openhands.dev/overview/skills)[Goose (Block) 官方文档 ↗](https://block.github.io/goose/docs/guides/context-engineering/using-skills/)[Amp 官方文档 ↗](https://ampcode.com/manual#agent-skills)[Kiro (AWS) 官方文档 ↗](https://kiro.dev/docs/skills/)[TRAE (字节) 官方文档 ↗](https://www.trae.ai/blog/trae_tutorial_0115)[Command Code 官方文档 ↗](https://commandcode.ai/docs/skills)[Roo Code 官方文档 ↗](https://docs.roocode.com/features/skills)[Cline 官方文档 ↗](https://docs.cline.bot/customization/skills)[Factory (Droids) 官方文档 ↗](https://docs.factory.ai/cli/configuration/skills)[Deep Code 官方文档 ↗](https://deepcode.vegamo.cn/en/docs/configuration/agent-skills)[Mistral AI Vibe 官方文档 ↗](https://github.com/mistralai/mistral-vibe)[Letta 官方文档 ↗](https://docs.letta.com/letta-code/skills/)[Mux (Coder) 官方文档 ↗](https://mux.coder.com/agent-skills)[Emdash 官方文档 ↗](https://docs.emdash.sh/skills)[OpenClaw 官方文档 ↗](https://docs.openclaw.ai/tools/skills)[Hermes Agent 官方文档 ↗](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)[Qodo 官方文档 ↗](https://www.qodo.ai/blog/how-i-use-qodos-agent-skills-to-auto-fix-issues-in-pull-requests/)[Tabnine 官方文档 ↗](https://docs.tabnine.com/main/getting-started/tabnine-cli/features/agent-skills)[Snowflake Cortex Code 官方文档 ↗](https://docs.snowflake.com/en/user-guide/cortex-code/extensibility#extensibility-skills)[Databricks Genie Code 官方文档 ↗](https://docs.databricks.com/aws/en/assistant/skills)[Spring AI 官方文档 ↗](https://spring.io/blog/2026/01/13/spring-ai-generic-agent-skills/)[Laravel Boost 官方文档 ↗](https://laravel.com/docs/12.x/boost#agent-skills)[Pulumi Neo 官方文档 ↗](https://www.pulumi.com/docs/ai/skills/)[Superconductor 官方文档 ↗](https://superconductor.com/docs/project/mcp-and-skills)[Ona 官方文档 ↗](https://ona.com/docs/ona/agents-md#skills-for-repository-specific-workflows)[pi 官方文档 ↗](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md)[VT Code 官方文档 ↗](https://github.com/vinhnx/vtcode/blob/main/docs/skills/SKILLS_GUIDE.md)[fast-agent 官方文档 ↗](https://fast-agent.ai/agents/skills/)[bub 官方文档 ↗](https://bub.build/docs/build/skills/)[nanobot 官方文档 ↗](https://nanobot.wiki/docs/0.1.5/use-nanobot/skills)[ZeroClaw 官方文档 ↗](https://docs.zeroclawlabs.ai/master/en/tools/skills.html)[Autohand Code CLI 官方文档 ↗](https://autohand.ai/docs/working-with-autohand-code/agent-skills.html)[Firebender 官方文档 ↗](https://docs.firebender.com/multi-agent/skills)[Vita 官方文档 ↗](https://www.vita-ai.net/docs/features/agent-skills)[Agentman 官方文档 ↗](https://agentman.ai/agentskills)[Workshop 官方文档 ↗](https://docs.workshop.ai/core-concepts/working-with-the-agent#create-your-own-agents)[Piebald 官方文档 ↗](https://piebald.ai)[Google AI Edge Gallery 官方文档 ↗](https://github.com/google-ai-edge/gallery/tree/main/skills)[Claude (claude.ai) 官方文档 ↗](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) [官方客户列表（完整名单） →](https://agentskills.io/clients) ## 怎么确认装好了 重启客户端后，问它一句 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） 开始用 免费端点（行情 / K线 / 热搜 / 市场总览 / 涨跌分布）**无需 Key** —— 装上就能试。需要财报 / 资金流 / 龙虎榜时再拿 Key。 [获取 Key](/pricing)[看 MCP 接入（另一种方式） →](/mcp)