前言¶
做 A 股盯盘时，常见做法是开交易软件盯屏，或用脚本定时拉行情再自己比对阈值。前者占注意力，后者要把查询、日志和告警拆成多套小工具。若你已经在 Cursor、Claude Code 等环境里用 Skill 扩展 Agent 能力，可以把「查价、巡检、记日志、改监控列表」收敛到一条对话或一条定时任务里。下面介绍 SkillHub 上的 股票交易监测系统（坐标 @user_62138798/stock-price-monitor，v1.0.0），它面向 A 股实时行情与价格/涨跌幅预警，官方说明称使用过程中不消耗 token，适合低成本长期挂着检查。
这是什么¶
股票交易监测系统（Stock Monitor）是社区来源（community）的 Agent Skill，分类为 data-analysis，发布者为 user_62138798。Skill 通过新浪财经接口（文档写明为 hq.sinajs.cn）获取 A 股行情，在本地脚本中完成查询、预警判断和日级价格日志。标签 requires_api_key=false，无需额外申请 API Key。
当用户提到「股票」「监控」「股价」「预警」「查股价」「看行情」等意图时，Agent 可按 Skill 说明选用对应指令。
核心功能¶
依据官方简介与 Skill 文档，能力可归纳为四类：
-
实时查询（
query/查询）
返回配置中所有监控标的的实时价格与涨跌幅。 -
预警检查（
check/检查）
执行一轮行情检查；价格触高/触低或涨跌幅触及阈值时返回告警文案，否则可返回「指标正常」类提示（具体文案以脚本返回为准）。 -
日志（
log/日志，log_history/历史日志）
log查看当日价格日志（开盘/收盘/最高/最低及预警记录）；log_history查看最近 7 天摘要。日志文件为scripts/stock_daily_log.json，在check/query时自动更新。 -
配置管理
通过scripts/stock_config.json维护监控标的、价格上下限、涨跌幅阈值，以及检查间隔、是否每日仅提醒一次等选项。
文档还说明：盘前或休市时价格为 0 或昨收无效会跳过；同日同条件告警可配置为只提醒一次（only_once 推荐 true）。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（示例为推荐方式）：
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
安装本 Skill¶
SkillHub 页面给出的安装提示为：参照 SkillHub 安装说明，安装 @user_62138798/stock-price-monitor。
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例命令（将目录换成你当前环境对应路径）：
skillhub install @user_62138798/stock-price-monitor --dir ~/.cursor/skills/
安装完成后，按你所用客户端的要求刷新或重启 Agent，以便加载新 Skill。
配置文件¶
编辑 Skill 目录下 scripts/stock_config.json。文档中的字段含义如下：
{
"stocks": [
{
"code": "688599",
"name": "天合光能",
"price_high": 17,
"price_low": 15,
"rise_pct": 99,
"fall_pct": -99
}
],
"check_interval": 30,
"only_once": true
}
code：股票代码（6 开头上证，非 6 开头深证）name：名称（便于日志与输出阅读）price_high/price_low：价格预警上下限rise_pct/fall_pct：涨跌幅预警阈值（文档示例用 ±99 表示可视为禁用涨跌幅预警）check_interval：检查间隔相关配置（与定时任务配合时使用）only_once：是否同一自然日对同条件告警只提醒一次
典型用法¶
在对话里让 Agent 执行¶
直接向 Agent 说明意图即可，例如「用股票交易监测系统查一下当前监控列表行情」或「执行 check 看有没有预警」。Skill 将 run() 映射到以下指令（中英文均可）：
| 指令 | 说明 |
|---|---|
check / 检查 |
一轮检查，有预警则返回告警 |
query / 查询 |
所有监控标的实时价与涨跌幅 |
log / 日志 |
当日价格与预警日志 |
log_history / 历史日志 |
近 7 日日志摘要 |
命令行直接调用¶
进入 Skill 的 scripts 目录后执行：
cd <skill-dir>/scripts/
python3 stock_monitor_skill.py check
python3 stock_monitor_skill.py query
python3 stock_monitor_skill.py log
python3 stock_monitor_skill.py log_history
定时巡检（OpenClaw / Clawdbot 示例）¶
文档给出了用 Cron 周期性触发 check 的示例（间隔与 payload 可按需调整）：
openclaw-cn cron add \
--name "股票交易监控系统" \
--every 120000 \
--payload '{"kind":"systemEvent","text":"【股票交易监控系统 检查】运行 stock_monitor_skill 的 check 函数，触发真实告警才汇报，否则保持沉默。"}' \
--session-target main
建议检查频率为交易时段内每 1–5 分钟一次；非交易时段脚本会按文档逻辑跳过无效行情。
适用场景与注意¶
适合谁
- 已在 Agent 工作流里处理资讯或自动化任务，希望把少量自选股的价格/涨跌幅阈值检查嵌进对话或定时任务。
- 需要本地日级开盘、收盘、最高、最低与预警时间留档，而不是只在聊天里临时问一次价。
限制与注意
- 行情依赖新浪财经公开接口，字段为文档所述的精简格式（现价、涨跌额、涨跌幅、成交量、成交额等），不适合作为唯一交易决策依据。
- 仅覆盖 Skill 文档描述的 A 股代码规则与行情逻辑；港股、美股等不在本文核实范围内。
- 定时任务、Cron 集成示例针对 Clawdbot/OpenClaw 生态；其他客户端需自行把「周期性执行
check」映射到各自的调度方式。 - SkillHub 页面标注版本 v1.0.0；商店统计（截至页面展示）评分 100000、下载 5293 次，安装数为 0（以 SkillHub 列表为准）。
结尾¶
股票交易监测系统把 A 股查价、阈值预警、日日志和配置维护收进一个 Skill：Agent 侧用 query / check / log 等指令即可驱动，本地用 stock_config.json 管标的与阈值，并可配合定时任务做静默巡检。官方入口：
- API 坐标页：https://api.skillhub.cn/user_62138798/stock-price-monitor
- SkillHub 展示页：https://www.skillhub.cn/skills/user_62138798/stock-price-monitor
