前言¶
在对话里问「这只票现在多少钱」「早盘有没有放量」，如果 Agent 没有固定数据源和脚本，往往只能泛泛而谈或让你自己去行情软件里查。自己写爬虫则要处理沪深代码规则、接口限流和分时聚合，维护成本不低。
下面介绍 SkillHub 社区 Skill a-stock-analysis-gavin（坐标 @user_3aadcde8/a-stock-analysis-gavin，版本 1.0.0）。它把实时行情、分时量能、主力信号判断和本地持仓管理写进 SKILL.md 与配套脚本，供 Cursor、Claude Code 等支持 Skills 的客户端在合适场景自动调用。标签标明 requires_api_key=false，无需单独配置行情 API Key。
这是什么¶
a-stock-analysis-gavin 面向 A 股（沪深、北交所）的实时行情与分时量能分析，并支持持仓记录与盈亏查看。发布者为 SkillHub 用户 user_3aadcde8，来源为 community，分类为 data-analysis。SkillHub 页面显示评分 100000、下载 1163 次（统计以 SkillHub 为准）。
Skill 内说明通过公开行情接口拉取数据（文档中列出新浪财经实时与分时相关接口），由 analyze.py、portfolio.py 等脚本完成查询与分析，Agent 按描述中的 Use when 条件选用即可。
核心功能¶
以下能力均来自 Skill 官方 SKILL.md 与 SkillHub 简介，可按需裁剪使用。
- 实时行情：沪深股票现价、涨跌、成交量、成交额等；支持单只或多只股票一次查询。
- 分时量能分析（
--minute）：按早盘 30 分、上午中段、下午中段、尾盘 30 分统计成交占比；给出放量时段 TOP 10；结合阈值判断抢筹/出货类信号与涨停封单关注点。 - 主力动向规则（文档内阈值）：例如早盘 30 分成交占比 >30% 记为早盘主力抢筹明显；尾盘 30 分 >25% 记为尾盘异动等（详见 Skill 内表格）。
- 持仓管理：添加、更新、删除持仓，并对全部持仓做含分时量能的分析。
- 输出形式：默认终端友好文本；支持
--json便于后续处理。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
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
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常见路径如下（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令：
skillhub install @user_3aadcde8/a-stock-analysis-gavin --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent 目录即可。也可按 SkillHub 页面提示，让 AI 参照 https://skillhub.cn/install/skillhub.md 完成安装。
3. 运行环境¶
脚本通过 uv run 执行，需本机已安装 uv。安装 Skill 后重启或刷新 Agent，使新 Skill 被索引。
典型用法¶
以下示例中的 {baseDir} 表示该 Skill 的安装目录（例如 ~/.cursor/skills/@user_3aadcde8/a-stock-analysis-gavin）。股票代码使用 6 位数字，Skill 会自动区分沪市（6 开头）、深市（0/3 开头）、北交所（8/4 开头）。
查询实时行情¶
uv run {baseDir}/scripts/analyze.py 600789
一次查询多只股票：
uv run {baseDir}/scripts/analyze.py 600789 002446 002342
含分时量能与 JSON¶
uv run {baseDir}/scripts/analyze.py 600789 --minute
uv run {baseDir}/scripts/analyze.py 600789 --json
--minute 会输出各时段成交占比、放量分钟 TOP 10 以及文档中定义的「主力动向判断」文案。
持仓管理¶
uv run {baseDir}/scripts/portfolio.py show
uv run {baseDir}/scripts/portfolio.py add 600789 --cost 10.416 --qty 3400
uv run {baseDir}/scripts/portfolio.py update 600789 --cost 10.2
uv run {baseDir}/scripts/portfolio.py remove 600789
uv run {baseDir}/scripts/portfolio.py analyze
Skill 文档写明持仓数据文件路径为：
~/.clawdbot/skills/a-stock-analysis/portfolio.json
若你升级或迁移过 OpenClaw 系环境，请以本机实际路径为准，必要时对照安装目录下的说明。
在 Agent 对话中，当任务符合简介中的 Use when——查询 A 股实时行情、分析主力资金动向、查看分时成交量分布、管理股票持仓、分析持仓盈亏——即可直接描述股票代码与需求（例如「600789 带分时量能」），由 Agent 按 Skill 调用上述脚本。
适用场景与注意¶
适合谁：需要在 IDE/CLI 里做轻量看盘、量能粗判、持仓台账与盈亏回顾的开发者或量化爱好者；不想为每次问答单独写行情脚本的用户。
数据与延迟：Skill 文档给出实时行情约 3 秒级延迟、分时 K 线约 1 分钟级延迟，并说明支持批量拉取以减少请求次数。非交易时段得到的是收盘相关数据。
范围限制（Skill 内「限制」一节）：仅 A 股；分时数据最多约 250 条（约一个交易日）。量能与主力信号基于规则阈值，属于辅助解读，不能替代合规投资研究或交易决策。
合规与稳定性：数据来自第三方公开接口，可用性与字段格式可能随源站调整；生产环境或自动化交易前应自行验证并承担使用风险。
结尾¶
a-stock-analysis-gavin 把 A 股实时行情、分时量能分布、文档化主力信号和持仓分析收敛到一个社区 Skill，配合 SkillHub 安装即可挂到常用 Agent。需要查看版本、评分与安装提示时，可打开官方页面：
- SkillHub：https://www.skillhub.cn/skills/user_3aadcde8/a-stock-analysis-gavin
- API 坐标页：https://api.skillhub.cn/user_3aadcde8/a-stock-analysis-gavin
