条件选股 Skill

通过输入自然语言筛选条件，选出符合条件的金融标的列表。

首次使用 - 获取 API Key

所有子技能都需要 HT_APIKEY 环境变量才能使用。 如果用户首次使用未配置或者缺失该变量，必须展示本引导流程：

步骤 1：获取 API Key

打开华泰证券 AI涨乐 skill平台注册页面：
https://ai.zhangle.com/nzl/skill-manage/skills.html

注册/登录后，在平台的 【API KEY管理】 中即可创建并复制你的 API Key。

步骤 2：配置环境变量或配置文件

获取到 API Key 后，二选一即可：

方式 A：环境变量

# Linux / macOS
export HT_APIKEY=你的API_KEY

# Windows PowerShell
$env:HT_APIKEY = "你的API_KEY"

# Windows CMD
set 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

脚本读取优先级：os.environ["HT_APIKEY"] → ~/.htsc-skills/config → 空。

触发条件

当用户的意图满足以下任一条件时，调用本 Skill：

• 行业/板块筛选：涉及行业（如"白酒行业"、"半导体"）或概念板块（如"AI概念"、"新能源"）的筛选。
• 财务指标筛选：涉及基本面指标（如"市盈率小于20"、"净利润增长率大于30%"、"ROE>15%"）。
• 技术指标筛选：涉及技术形态或指标（如"均线金叉"、"MACD底背离"、"连板股票"）。
• 行情数据筛选：涉及市场行情（如"涨幅超过5%"、"主力净流入超过1亿"、"换手率大于10%"）。
• 业绩超预期筛选：涉及业绩是否超预期（如"业绩超预期的股票"、"一季报财报超预期的标的"）。
• 组合条件筛选：以上条件的任意组合。
• 主观推荐类："推荐几只股票"、"有什么好的ETF"等。

不适用场景

以下请求不应调用本 Skill：

• 个股分析类 (比如：贵州茅台怎么样？) → 应使用 financial-analysis 等 Skill

执行流程

> ⚠️ 关键约束（必须严格遵守）：
> 1. 语义理解/改写阶段如果用户描述存在歧义，按照附录：查询改写规则进行合理推断和补全，直接执行，不得以任何理由暂停去询问用户。

通用约定

• 字段命名：小驼峰（stockCode、stockName）
• 响应结构：{ ok, data: { result }, error }

响应结构

成功：

{ "ok": true, "data": { "result": "..." }, "error": null }

失败：

{
  "ok": false, "data": null,
  "error": {
    "code": 5000,
    "message": "面向用户的中文说明",
    "category": "network",
    "retriable": true,
    "hint": "下一步该怎么做"
  }
}

按 error.category 处理：

工具

selectStock

条件选股：根据自然语言筛选条件查询符合条件的金融标的。

参数：
- query：筛选条件查询语句（必填）

返回：data.result（markdown 格式的选股结果）

执行：python3 select_stock.py selectStock --query <query>

调用策略：
1. 第一次用原始问句调用
2. 若无结果，改写查询后重试（参照查询改写规则）
3. 第二次仍无结果则停止，告知用户"未检索到符合条件的标的"
4. 返回结果中标的不超过 10 个

严禁修改返回的 Markdown 格式。

执行流程

> 关键约束：禁止向用户反问。 收到请求后必须立即直接调用脚本。

Step 1：第一次调用（使用原始问句）

将用户的原始问句直接作为 --query 参数传入，不做任何改写：

python3 select_stock.py selectStock --query "<用户原始问句>"

Step 2：若第一次无结果，改写后重试

若 Step 1 返回无结果，对用户意图进行深度语义理解，将原始问句改写为清晰、无歧义的查询语句，再次调用：

python3 select_stock.py selectStock --query "<改写后的查询语句>"

若第二次仍无结果，停止重试，直接告知用户"未检索到符合条件的标的"。

Step 3：展示结果

脚本会返回 Markdown 格式的结果，严禁修改 Markdown 格式。

> 展示限制：返回给用户的标的结果数量不能超过 10 个。

附录：查询改写规则

1. 逻辑关系消歧（OR vs AND）

• 同一维度的多个值（如多个行业）通常为 OR；跨维度的多个条件（如行业 + 市盈率 + 涨幅）通常为 AND。改写时必须用"或"/"且"明确标注逻辑关系。

2. 时间条件丢失或泛化

• 完整保留用户提到的所有时间限定。对"上周五"、"本周一"等相对时间，根据当前日期推算出具体日期后写入查询。

3. 隐含排序与排名条件

• 从上下文推断排序字段，在改写中明确写出排序字段名称、排序方向及取前N条的数量限制。

4. 复合条件拆解不完整

• 将复合语句拆解为独立的筛选子条件，每个子条件覆盖一个维度，用"且"/"或"连接，确保无遗漏。

5. 指代消解（代词与回指）

• 回溯上下文，将代词替换为明确指代的实体或条件集合，确保改写后的查询自包含。

6. 否定与排除条件

• 在改写中显式标注排除条件，使用"排除"、"不包含"等明确否定词。

7. 数值单位与区间歧义

• 根据金融常识和上下文补全数值单位（如市值通常为"亿元"，股价为"元"），对区间表述默认采用闭区间。

8. 连续性与累计性条件

• 明确"连续"的时间单位为交易日，补全截止日期，并区分"连续每天都满足"与"累计/合计满足"的语义差异。

配置

环境变量：