stock-sector-monitoring

name	stock-sector-monitoring
description	Monitors China A-share concept sectors and Dragon Tiger List (龙虎榜) via Tushare, then generates structured markdown reports. Use when users ask to track sector momentum, fetch top_list (doc_id=106), remove ST stocks, rank movers, or save monitoring output as .md files.

Stock Sector Monitoring Skill

用于基于 Tushare 的 A 股市场监测，重点支持：

• 概念板块监测（sector）
• 龙虎榜每日明细（lhb，top_list / doc_id=106）
• 将结果输出并保存为 Markdown 文件

When to Use

当用户出现以下意图时使用本 skill：

• “监控概念板块/行业热度/涨幅榜”
• “查询龙虎榜数据”
• “过滤 ST 股票后输出结果”
• “把监控结果保存成 markdown/md 文件”

Prerequisites

在 skill 根目录执行：

cd /Users/yujian/Code/py/aj-skills/skills/stock-sector-monitoring

依赖准备：

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -U pip
python3 -m pip install tushare pandas

Tushare token 约定从 ~/.aj-skills/.env 读取：

# ~/.aj-skills/.env
TUSHARE_TOKEN=your_token

Core Workflow

1) 采集龙虎榜数据（默认推荐）

source .venv/bin/activate
python3 scripts/sector-monitoring.py \
  --once \
  --data-source lhb \
  --trade-date 20260213 \
  --top 20 \
  --format json

说明：

• --data-source lhb 使用龙虎榜接口（top_list）
• --trade-date YYYYMMDD 指定交易日，默认是当天
• 当前脚本已内置过滤 ST / ST / SST / SST 股票

2) 板块异动+新闻联动分析（必须）

每次执行都必须完成该分析，不需要用户额外提问；完成分析后才可生成对应报告。

Step 1: 识别异动板块
从板块监测数据中提取涨幅前 N 的板块。

Step 2: 搜索相关新闻
针对异动板块，搜索近期新闻：

• 行业政策变化
• 价格/供需变化
• 龙头公司动态
• 国际市场影响

Step 3: 形成异动原因结论
整合板块数据 + 新闻，产出可写入报告的异动原因分析结论。

3) 生成 Markdown 报告

在完成第 2 步分析后，将 JSON 输出与异动原因结论整理成 Markdown，并保存到 reports/ 目录。

报告标题要求（必须）：

• 先生成一个吸引人的标题，适合社交媒体分享。
• 标题需体现“异动板块 + 关键驱动/新闻线索”，避免仅使用“日报/监测”这类平铺命名。
• 标题控制在 18-32 字，信息密度高，可读性强。

领涨板块输出要求（必须）：

• 必须输出 今日领涨板块原因分析 章节。
• 至少覆盖涨幅前 1-3 个板块（默认 3 个，可按数据完整性调整）。
• 每个板块必须包含：板块名+涨幅、核心逻辑、驱动因素表、趋势结论。
• 涨幅榜 中的 上榜理由 必须为移动端短句，单条建议不超过 16 个汉字（或 24 个字符），仅保留关键信息。

文件命名规范：

• 龙虎榜日报：reports/lhb-YYYYMMDD.md
• 指定股票：reports/lhb-YYYYMMDD-TS_CODE.md
• 概念板块：reports/sector-YYYYMMDD.md

Markdown 最低结构：

# 【板块异动】算力板块领涨：政策催化+龙头放量（YYYY-MM-DD）

## 今日领涨板块原因分析

### 1. 有色金属（铅锌 +5.76%、小金属 +4.65%、铜 +2.96%）

核心逻辑：需求爆发 + 供给收缩

| 驱动因素 | 具体内容 |
|---|---|
| 国际金属价格普涨 | LME 铜涨超 1.7%，锡涨超 4.6%，海外定价中枢上移 |
| AI 产业需求 | 算力与数据中心建设拉动铜等导电金属需求 |
| 新能源需求 | 锑、钨、稀土、锡等小金属受新能源产业链拉动 |
| 供给管控 | 国内供给管控政策持续，供需缺口支撑价格 |
| 货币环境 | 国际货币环境宽松，风险偏好提升带动商品走强 |

趋势结论：有色金属正从周期品向战略资源属性演进，阶段性主线仍看供需错配与产业升级共振。

## 涨幅榜 Top N
| 排名 | 代码 | 名称 | 涨跌幅 | 龙虎榜净买入额(亿) | 净买额占比(%) | 上榜理由(短句) |
|---|---|---|---:|---:|---:|---|

## 综合评分 Top N
| 排名 | 代码 | 名称 | 综合评分 | 涨跌幅 | 龙虎榜净买入额(亿) |
|---|---|---|---:|---:|---:|

## 预警
- 列出超过阈值的标的（若无则写“无”）

## 免责声明
本文为市场复盘与信息整理，不构成任何投资建议。市场有风险，决策需结合自身风险承受能力并独立判断。

4) 保存要求（必须）

每次响应都应：

• 明确输出文件路径
• 将最终结果落盘为 .md
• 在回复中给出“已保存到：<path>”

5) 发布询问与公众号发布（必须）

报告生成并保存后，必须追加询问用户是否需要发布到公众号。

标准询问：

• “报告已生成，是否需要我直接发布到公众号？”

执行规则：

• 若用户确认“需要”，调用 post-to-wechat skill（baoyu-post-to-wechat）发布。
• 若用户未确认或拒绝，不进行发布操作，仅保留本地报告文件。

Output Rules

• 默认输出 Markdown，不仅在对话中展示。
• 仅输出分析报告正文，不输出数据来源说明、接口信息或过滤规则说明。
• 报告主标题必须为“吸引人的社交媒体风格标题”，不能使用通用占位标题。
• 报告必须包含 今日领涨板块原因分析，且每个领涨板块都要给出“核心逻辑 + 驱动因素表 + 趋势结论”。
• 涨幅榜 的 上榜理由 必须压缩为移动端短句，不得出现过长原文搬运。
• 报告结尾必须追加 免责声明 章节，且位于最后一节。
• 如用户未指定文件名，按命名规范自动生成。
• 如用户指定日期或 TS 代码，文件名必须反映该条件。
• 若当日无数据，仍生成 Markdown，并在正文写明“无可用数据（非交易日/无上榜）”。
• 报告保存完成后，必须询问用户是否发布到公众号；仅在用户明确同意后调用 post-to-wechat skill。

Quality Checklist

• 已完成板块异动+新闻联动分析，并写入报告
• 报告标题已按社交媒体分享场景优化
• 领涨板块输出已按模板包含：板块涨幅、核心逻辑、驱动因素表、趋势结论
• 涨幅榜 上榜理由 已压缩为移动端短句
• 报告末尾已追加免责声明
• 报告正文未包含数据来源说明与过滤规则说明
• 表格列名完整、单位清晰（金额统一“亿元”）
• 报告已保存为 .md
• 回复中包含保存路径
• 已询问用户是否发布到公众号；如用户确认，已调用 post-to-wechat skill 发布

Notes

• 龙虎榜接口权限要求较高（top_list 通常需积分权限）。
• 若接口返回为空，优先提示交易日与权限问题，再输出空报告模板。