前言¶
在 Agent 里做「按条件找标的」，常见做法是让用户自己拼筛选器，或把需求拆成多轮结构化字段。条件一多（行业 + 财务 + 技术面 + 行情），对话很容易变长，也容易漏掉用户原话里的时间、排序和组合逻辑。
下面介绍 SkillHub 上的 AI涨乐–条件选股（坐标 @user_d9eea1c5/zhangle-select-stock，当前版本 1.0.2）。它把「条件选股」收敛成一条自然语言查询，由华泰证券 AI涨乐后端解析并返回结果，适合挂在支持 Skill 的编码助手或 OpenClaw 类环境里使用。
这是什么¶
AI涨乐–条件选股 是社区来源（community）、分类为 professional 的金融 Skill：根据自然语言筛选条件，查询符合条件的股票、ETF、基金等金融标的。
- 维护方：华泰证券（SKILL 元数据与 README 均标注 Huatai Securities / 华泰证券）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_d9eea1c5/zhangle-select-stock
- 安装 API 入口：https://api.skillhub.cn/user_d9eea1c5/zhangle-select-stock
它与「个股怎么样、值不值得买」类深度分析不同：官方说明中明确 不应 用于个股分析，此类需求应走 financial-analysis 等 Skill。
核心功能¶
已核实的能力边界如下。
适用触发场景¶
当用户要 按条件筛选 股票 / ETF / 基金等标的时启用，包括但不限于：
- 行业 / 板块：如白酒、半导体、AI 概念、新能源等。
- 财务指标：市盈率、净利润增速、ROE 等。
- 技术指标：均线金叉、MACD、连板等表述。
- 行情数据：涨跌幅、主力净流入、换手率等。
- 业绩超预期：财报或业绩是否超预期类筛选。
- 组合多条件：上述维度的任意组合。
- 主观推荐类：如「推荐几只好股票」「有什么好的 ETF」。
官方在 SKILL 描述中给出的示例问句包括：
- 科技板块上周涨幅前 10 的股票
- 有哪些主力净流入超过 1 亿的
- 市盈率低于 20 且营收同比增长超过 30% 的股票
- 业绩超预期的股票有哪些
- 推荐几只好股票
执行方式¶
Skill 约定 Agent 调用本地脚本 select_stock.py，工具名 selectStock，将用户问句作为 query 传入：
python3 select_stock.py selectStock --query "<筛选条件自然语言>"
调用策略（来自 SKILL.md）：
- 第一次使用 用户原始问句，不做改写。
- 若无结果，按附录中的「查询改写规则」补全语义后再试 一次。
- 仍无结果则停止，告知用户未检索到符合条件的标的。
- 展示给用户的标的 不超过 10 个；返回的 Markdown 不得被 Agent 改格式。
成功时 JSON 形如 { "ok": true, "data": { "result": "..." }, "error": null }，data.result 为 Markdown 选股结果。
依赖与环境¶
- 需要本机
python3，README 要求 Python 3.9+，并依赖requests。 - SkillHub 标签
requires_api_key=true：必须配置华泰涨乐 API Key 后才能调用后端。
安装与启用¶
通过 SkillHub 安装（推荐）¶
SkillHub 页面提示：让 Agent 按 https://skillhub.cn/install/skillhub.md 安装本 Skill。人工操作时，先确认已安装 skillhub CLI，再用 --dir 指向当前 Agent 的 skills 目录（装到错误目录会导致 Skill 不被加载）。
command -v skillhub && skillhub --version
skillhub install @user_d9eea1c5/zhangle-select-stock --dir <你的 Agent skills 目录>
常见 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按各客户端要求刷新或重启，使 Skill 被识别。
配置 API Key（必填）¶
在 https://ai.zhangle.com/nzl/skill-manage/skills.html 注册 / 登录，在 【API KEY 管理】 创建并复制 Key。
方式 A：环境变量
export HT_APIKEY=你的API_KEY
方式 B：配置文件（跨 shell 持久化）
mkdir -p ~/.htsc-skills
printf "HT_APIKEY=%s\n" "你的API_KEY" > ~/.htsc-skills/config
chmod 600 ~/.htsc-skills/config
读取优先级：HT_APIKEY 环境变量 → ~/.htsc-skills/config。
可选环境变量¶
| 变量 | 必填 | 说明 |
|---|---|---|
HT_APIKEY |
是 | 认证密钥 |
SELECT_STOCK_SERVICE_URL |
否 | 后端地址，默认 https://ai.zhangle.com |
SELECT_STOCK_TIMEOUT_SEC |
否 | 超时（秒），默认 300 |
SKILL.md 要求：语义存在歧义时按改写规则 直接执行，不得以反问打断用户；收到选股请求后应 立即调用脚本，而不是先追问。
典型用法¶
在对话里使用¶
用户用自然语言描述筛选条件即可，例如：
半导体板块里，市盈率低于 30、近一周涨幅前 5 的股票有哪些？
Agent 应进入已安装的 select-stock Skill，执行：
python3 select_stock.py selectStock --query "半导体板块里，市盈率低于 30、近一周涨幅前 5 的股票有哪些？"
将 stdout 中 ok: true 时的 data.result 原样展示给用户。
命令行自测¶
进入 Skill 安装目录后可直接调试：
python3 select_stock.py selectStock --query "科技板块上周涨幅前10的股票"
python3 select_stock.py selectStock --help
失败时根据 error.category 区分：network 可提示稍后重试；business 表示业务侧无数据或限制，不宜立刻重复相同查询。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 或 OpenClaw 生态中使用 Skill 的开发者或量化 / 研究同学，需要快速把口语化选股条件交给专业数据源。
- 需要统一「条件选股」入口、又不想在 Agent 里手写筛选 DSL 的团队。
限制与注意
- 必须联网并配置
HT_APIKEY，否则无法访问涨乐后端；密钥不要提交到仓库。 - 不是投研报告工具：单票基本面、估值叙事类问题应换用
financial-analysis等 Skill。 - 结果条数与格式：最多展示 10 个标的，且不得改动返回 Markdown。
- 耗时：默认超时 300 秒，选股接口可能较慢，Agent 侧需有耐心等待完成的预期。
- 数据与合规：选股结果来自华泰证券服务端，使用前请遵守平台协议与本地监管要求；本文不构成投资建议。
SkillHub 侧当前评分为 100000，下载 1260 次（以页面展示为准，会随时间变化）。
结尾¶
AI涨乐–条件选股 把「行业、财务、技术面、行情、业绩超预期、组合条件、推荐类」等需求统一成自然语言查询，由华泰证券后端返回 Markdown 结果，Agent 只负责按契约调用脚本并展示。若你的场景是 按条件筛标的 而非 深度分析单票，可以按上文安装并配置 HT_APIKEY 后试用。
官方 SkillHub 地址：https://www.skillhub.cn/skills/user_d9eea1c5/zhangle-select-stock
