前言¶
在 Cursor、Claude Code 等环境里做 A 股或港股相关问答时，常见做法是临时写脚本拉行情，或把网页内容复制进对话。数据口径不统一、缺少结构化输出，也不方便复用。下面介绍 SkillHub 上的社区技能「A股-股市分析和投资顾问」，把行情、基本面、指数与文本检索等能力封装成 Agent 可调用的 Skill，用自然语言驱动查询与分析流程。
这是什么¶
「A股-股市分析和投资顾问」是面向中国 A 股、港股的只读数据查询与分析 Skill。坐标为 @user_38ebd01e/a-stocks-analysis，当前版本 0.2.2，来源为 community，分类为 professional，由 SkillHub 用户 user_38ebd01e 发布；SkillHub 页面标注作者为 roamerxv。
官方简介说明：支持行情、基本面、指数、文本等数据内的检索，并提供多种专业的分析方法和建议。SkillHub 元数据标签 requires_api_key=true，表示启用前需要配置 API Key。该技能不提供交易下单能力，使用时应以公开、只读的历史与行情类数据为边界。
核心功能¶
依据 SkillHub 已公开说明，可核实的能力包括：
- 多类数据检索：行情、基本面、指数，以及在文本类数据中的检索。
- 分析辅助：在数据检索之上，提供多种专业分析思路与建议性输出（具体方法以技能包内
SKILL.md及运行时说明为准）。 - 只读定位：面向查询与分析，不承担证券交易或账户操作。
SkillHub 统计（页面展示）：评分 100000，下载 10282，安装 540。
安装与启用¶
安装前需具备 SkillHub CLI。若尚未安装，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本技能时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。SkillHub 文档给出的常见路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令示例（将 <skills 目录> 替换为实际路径）：
skillhub install @user_38ebd01e/a-stocks-analysis --dir <skills 目录>
也可以在对话中让 AI 按官方提示安装：先阅读 https://skillhub.cn/install/skillhub.md，再安装 @user_38ebd01e/a-stocks-analysis。
经过上面的步骤，技能会落入对应 skills 目录。因 requires_api_key=true，安装后还需在技能说明或发布者要求的环境中配置 API Key，否则数据接口无法鉴权通过。具体变量名与获取方式以技能包内文档为准。
典型用法¶
官方页面未给出固定 CLI 子命令列表，典型用法是在已启用该 Skill 的 Agent 对话中，用自然语言描述标的与分析需求，由 Agent 按 SKILL.md 调用技能所封装的数据接口并整理结果。下列表述方式与官方简介中的能力范围一致，便于复现意图（实际返回字段以接口与技能版本为准）：
- 查询某只 A 股或港股近期行情与关键价位上下文。
- 拉取指定代码的基本面指标，并请求对比或摘要。
- 检索与某指数成分、走势或相关文本说明有关的信息。
- 在以上数据基础上，要求给出结构化分析（例如分「数据摘要 / 指标解读 / 关注点」几段输出）。
若安装后行为与预期不符，优先在 skills 目录中查看 @user_38ebd01e/a-stocks-analysis 下的 SKILL.md 与配套说明，确认 API Key、可用市场与接口范围。
适用场景与注意¶
适合谁
- 需要在 IDE 或 CLI Agent 内快速查 A 股/港股公开数据、做研究草稿或代码旁注的开发者。
- 希望用统一 Skill 约束数据检索与分析输出格式，减少每次手写爬虫或临时脚本。
限制与注意
- 数据与功能以技能包及后端接口为准；社区来源（community）意味着更新节奏与 SLA 需自行关注版本 0.2.2 及后续变更。
- 必须正确配置 API Key（
requires_api_key=true），并遵守接口提供方的使用条款。 - 技能定位为只读查询与分析辅助，不能替代合规的投资顾问服务；任何「建议」类输出都应人工复核，不应直接作为交易依据。
结尾¶
「A股-股市分析和投资顾问」把 A 股/港股的行情、基本面、指数与文本检索收敛到一条 Skill 坐标上，适合在 Cursor 等环境中做可复用的只读分析工作流。安装与优先源配置以 SkillHub 文档为准；技能主页与 API 入口如下：
- SkillHub 页面：https://www.skillhub.cn/skills/user_38ebd01e/a-stocks-analysis
- 官方地址：https://api.skillhub.cn/user_38ebd01e/a-stocks-analysis
