stock-analyzer-skill 1.1.0

package/skills/help/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: help
+description: 显示所有可用的股票分析 skills 和使用说明。当用户输入 /help、/stocks、/skills 或询问"有哪些功能"时触发。
+---
+
+# Stock Analyzer Skills 帮助
+
+显示所有可用的 A 股分析 skills 和使用说明。
+
+## Usage
+
+```text
+/help
+/stocks
+/skills
+```
+
+## 可用的 Skills
+
+### 1. 单股分析 - `/stock`
+
+快速分析个股，支持三种模式：
+
+```text
+/stock <股票名称或代码>              # 快速分析（默认）
+/stock <股票名称或代码> quick        # 3 分钟快评
+/stock <股票名称或代码> full         # 五层完整分析
+/stock <股票名称或代码> debate       # 8 人专家圆桌辩论
+/stock <股票名称或代码> debate 长线  # 仅长线 4 人专家
+/stock <股票名称或代码> debate 短线  # 仅短线 4 人专家
+```
+
+**示例：**
+
+- `/stock 贵州茅台`
+- `/stock 600519 full`
+- `/stock sh600989 debate`
+
+### 2. 大盘复盘 - `/market`
+
+每日大盘复盘，指数+板块+风格+资金+预判：
+
+```text
+/market              # 完整复盘（默认）
+/market quick        # 3 分钟快评
+/market intraday     # 分时复盘
+```
+
+### 3. 板块分析 - `/sector`
+
+行业/主题板块全景分析：
+
+```text
+/sector <板块名称>              # 板块全景
+/sector <板块名称> compare      # 核心标的对比
+/sector <板块名称> stock        # 板块内个股筛选
+```
+
+**示例：**
+
+- `/sector 半导体`
+- `/sector 新能源 compare`
+
+### 4. 选股策略 - `/screener`
+
+多因子策略筛选候选股：
+
+```text
+/screener                        # 均衡精选（默认）
+/screener --strategy balanced    # 均衡精选
+/screener --strategy quality_value  # 质量价值
+/screener --strategy growth_momentum  # 成长动量
+/screener --strategy defensive   # 防守低波
+/screener --strategy turning_point  # 拐点修复
+/screener --sector 资源          # 指定板块筛选
+```
+
+### 5. 技术分析 - `/technical`
+
+纯技术分析，不做基本面：
+
+```text
+/technical <股票代码>            # 完整技术分析
+/technical <股票代码> quick      # 快速扫描
+/technical <股票代码> full       # 完整报告+缠论+战法
+```
+
+**示例：**
+
+- `/technical sh600989`
+- `/technical 600519 quick`
+
+### 6. 持仓检查 - `/portfolio`
+
+持仓组合健康检查：
+
+```text
+/portfolio              # 健康检查（默认）
+/portfolio health       # 健康检查
+/portfolio rebalance    # 调仓建议
+/portfolio compare      # 持仓对比
+```
+
+### 7. 财务分析 - `/financial-analyst`
+
+财务建模和预测：
+
+```text
+/financial-analyst <任务描述>
+```
+
+**示例：**
+
+- `/financial-analyst 分析贵州茅台的财务健康状况`
+- `/financial-analyst 预测宁德时代未来 3 年营收`
+
+### 8. 投资研究 - `/investment-researcher`
+
+市场研究和尽职调查：
+
+```text
+/investment-researcher <任务描述>
+```
+
+**示例：**
+
+- `/investment-researcher 研究新能源汽车行业投资机会`
+- `/investment-researcher 对比亚迪进行尽职调查`
+
+### 9. 初始化股票池 - `/init`
+
+首次安装或刷新各板块前 20 只活跃股票：
+
+```text
+/init              # 检测并初始化（已有数据则跳过）
+/init force        # 强制重新初始化
+/init top 30       # 每板块取 Top 30
+```
+
+**说明：** 首次安装时会自动运行。如需更新股票池数据，可手动执行 `/init force`。
+
+## 工作流建议
+
+### 快速选股流程
+
+1. `/market quick` - 了解市场状态
+2. `/screener` - 筛选候选股
+3. `/stock <候选股> quick` - 快速分析
+4. `/technical <候选股>` - 确认买点
+
+### 完整分析流程
+
+1. `/market` - 大盘复盘
+2. `<强势板块>` - 板块分析
+3. `/screener --sector <板块>` - 板块内选股
+4. `/stock <候选股> full` - 五层分析
+5. `/technical <候选股>` - 技术确认
+6. `/portfolio` - 持仓调整
+
+### 持仓检查流程
+
+1. `/portfolio health` - 检查持仓健康
+2. `/market` - 确认市场风格
+3. `/technical <弱势持仓>` - 检查是否破位
+4. `/screener` - 找替代候选
+5. `/portfolio rebalance` - 调仓建议
+
+## 数据来源
+
+- **实时行情**：腾讯财经 `qt.gtimg.cn`
+- **财务数据**：东方财富 `emweb.securities.eastmoney.com`
+- **K 线数据**：新浪财经 `money.finance.sina.com.cn`
+- **公告/研报**：东方财富 `np-anotice-stock.eastmoney.com`
+
+所有数据 API 在国内直连，无须代理。
+
+## 注意事项
+
+1. 所有分析仅供参考，不构成投资建议
+2. 涉及实时行情时，脚本会自动获取最新数据
+3. 如果脚本不可用，会参考 methodology.md 中的方法论
+4. 数据失败时会说明失败的数据源和影响
+
+## 获取更多帮助
+
+- 查看 `workflow.md` 了解 9 个 skill 的协作流程
+- 查看 `methodology.md` 了解完整投资方法论
+- 查看 `README.md` 了解项目结构和安装说明

package/skills/init/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: init
+description: 初始化或刷新股票池，为每个板块拉取前 20 只股票。当用户输入 /init、/setup、"初始化股票池"、"刷新股票池"时触发。
+---
+
+# 初始化股票池
+
+为 A 股各板块初始化前 20 只活跃股票，供选股、板块分析等 skill 使用。
+
+## Usage
+
+```text
+/init              # 检测并初始化（已有数据则跳过）
+/init force        # 强制重新初始化
+/init top 30       # 每板块取 Top 30
+```
+
+## Instructions
+
+当用户触发此 skill 时，执行以下步骤：
+
+1. **运行初始化脚本**：
+
+   ```bash
+   python3 scripts/init_pool.py
+   ```
+
+2. **如果用户指定 `force`**，加 `--force` 参数：
+
+   ```bash
+   python3 scripts/init_pool.py --force
+   ```
+
+3. **如果用户指定 `top N`**，加 `--top N` 参数：
+
+   ```bash
+   python3 scripts/init_pool.py --top 30
+   ```
+
+4. **输出结果**：展示初始化摘要，包括每板块股票数量和总计。
+
+## 前置条件
+
+- 需要设置 `EASTMONEY_API_TOKEN` 环境变量（东财 push2 API 的 ut 参数）
+- 如未设置，脚本会提示获取方式
+
+## 输出格式
+
+初始化成功后，展示类似：
+
+```
+✅ 初始化完成: 14 个板块，共 280 只股票
+
+各板块分布:
+  金融: 20 只
+  消费: 20 只
+  医药: 20 只
+  ...
+```
+
+## Notes
+
+- 已有数据时默认跳过，避免重复拉取
+- 使用 `force` 参数可强制刷新
+- 数据来源: 东方财富 push2 API
+- 过滤规则: 排除 ST 股、低成交额、低市值标的

package/skills/investment-researcher/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: investment-researcher
+description: 投资研究 agent，专注于市场研究、尽职调查、投资组合分析和资产估值。完全自包含——使用 stock-analyzer-skill 包的 scripts/ 工具。
+---
+
+# Investment Researcher
+
+投资研究 agent，专注于市场研究、尽职调查、投资组合分析和资产估值。
+
+## Usage
+
+```text
+/investment-researcher <任务描述>
+```
+
+## 前置依赖
+
+- 本 skill 是 [stock-analyzer-skill](https://github.com/) 的一部分
+- 工具脚本位于包根目录 `scripts/`；当前 skill 目录到包根目录为 `../../..`
+- 全部基于 curl + Python stdlib，无需额外 Python 库
+
+## Instructions
+
+使用简洁中文。先给投资建议（buy/hold/sell/observe）和置信度，再给关键证据、风险提示和跟踪条件。涉及最新行情、公告、研报或政策时必须取数或说明数据不可得。
+
+## Workflow Coordination
+
+完整链路见包根目录 `workflow.md`。本 skill 是深度研究总控：
+
+- 调用 `market` 判断市场风格和风险偏好。
+- 调用 `sector` 判断行业景气、竞争格局和轮动位置。
+- 调用 `financial-analyst` 做财务质量、预测和估值假设。
+- 调用 `stock` 汇总五层投资结论。
+- 调用 `technical` 给交易窗口、支撑阻力和失效条件。
+- 调用 `portfolio` 评估是否适合现有组合。
+
+输出必须标注每个证据来自哪个模块，并合并为 `investment_view`、`risk_map`、`tracking_plan`。
+
+### Step 1: 理解研究目标
+
+- 明确研究对象（个股、行业、市场）
+- 确定分析维度（技术面、基本面、新闻面）
+- 确认数据需求
+
+### Step 2: 收集数据
+
+#### 2.1 首选：包内脚本
+
+```bash
+
+# 实时行情（个股/批量）
+python3 scripts/quote.py sh600989,sz000807,sh518880
+
+# 财务数据
+python3 scripts/finance.py SH600989
+
+# K线（5min/15min/30min/日 K）
+python3 scripts/kline.py sh600989           # 日 K，30 根
+python3 scripts/kline.py sh600989 5 48      # 5 分钟 K，48 根
+python3 scripts/kline.py sh600989 240 10    # 日 K，10 根
+
+# 研报
+python3 scripts/announcements.py 600989 reports
+
+# 公司公告
+python3 scripts/announcements.py 600989
+```
+
+所有脚本支持 `-j` 输出 JSON 便于二次处理。
+
+#### 2.2 兜底：直接 curl
+
+当脚本不可用或需要绕过限制时：
+
+```bash
+# 实时行情（腾讯接口，GBK编码需转码）
+curl -s "https://qt.gtimg.cn/q=sh600989" | iconv -f GBK -t UTF-8
+# 字段映射以 scripts/common.py 中 TENCENT_FIELDS 为准
+
+# 批量行情
+curl -s "https://qt.gtimg.cn/q=sh600989,sh601118,sz000001" | iconv -f GBK -t UTF-8
+
+# 国际油价
+curl -s "https://qt.gtimg.cn/q=hf_CL,hf_OIL" | iconv -f GBK -t UTF-8
+# hf_CL=WTI原油 hf_OIL=布伦特原油
+
+# 财务摘要（东方财富接口）
+curl -s "https://emweb.securities.eastmoney.com/PC_HSF10/NewFinanceAnalysis/ZYZBAjaxNew?type=0&code=SH600989"
+# type=0:主要指标 type=3:利润表 type=4:资产负债表
+
+# 券商研报
+curl -s "https://reportapi.eastmoney.com/report/list?pageSize=5&beginTime=2026-01-01&endTime=2026-12-31&pageNo=1&code=600989"
+
+# 公司公告
+curl -s "https://np-anotice-stock.eastmoney.com/api/security/ann?page_size=5&page_index=1&ann_type=A&stock_list=600989&f_node=0"
+
+# 历史K线（新浪接口）
+curl -s "https://money.finance.sina.com.cn/quotes_service/api/json_v2.php/CN_MarketData.getKLineData?symbol=sh600989&scale=240&ma=no&datalen=30"
+```
+
+#### 2.3 WebSearch/WebFetch 使用策略
+
+- WebSearch 在国内环境下**不可靠**，返回的是模板文本而非真实搜索结果
+- WebFetch 对国内财经域名（eastmoney、sina、10jqka）**普遍被拦截**
+- **不要反复重试超过 2 次**，失败后立即切换到 2.1 或 2.2 方案
+- WebSearch 适用于获取英文信息和国际数据源
+
+#### 2.4 数据收集清单
+
+- [ ] 实时行情：股价、PE、PB、市值、换手率
+- [ ] 财务数据：营收、净利润、毛利率、ROE、现金流
+- [ ] 走势数据：近期K线（30日）、成交量变化
+- [ ] 券商研报：最新评级、目标价、核心观点
+- [ ] 公司公告：最新公告、重大事项
+- [ ] 关联数据：所属行业指数、大宗商品价格、汇率
+
+### Step 3: 分析
+
+- 技术面分析：趋势、支撑/阻力、成交量
+- 基本面分析：ROE、增速、毛利率、负债率、现金流（5 层框架，详见 `methodology.md` §2）
+- 估值评估：PE、PEG、PE/ROE
+- 板块与风格：所属板块轮动位置
+- 风险评估：情景分析、凯利公式仓位
+- 综合判断
+
+只在需要完整阈值、专家讨论或数据源细节时读取 `methodology.md`，不要默认整篇加载。
+
+### Step 4: 输出
+
+- 分析报告
+- 投资建议（buy/hold/sell）
+- 风险提示
+- 关键观察
+
+**专家讨论（可选）**：8 人圆桌（巴菲特/林奇/索罗斯/段永平 + 徐翔/赵老哥/炒股养家/作手新一），详见 `methodology.md` §3。
+
+## Allowed Auto-Actions (No Confirmation Needed)
+
+- 运行 scripts/ 下的查询脚本
+- 读取本地 data/ 下的参考数据
+- 读取 `methodology.md`
+
+## Actions Requiring Confirmation
+
+1. 执行 `git commit`、`git push`
+2. 修改 scripts/ 或 data/ 文件
+
+## Guardrails
+
+- 不要把短线交易信号包装成长期投资结论，必须区分时间维度。
+- 研报、公告、政策信息必须带日期；过期信息不得当作最新催化。
+- 对高波动主题给出仓位上限、止损触发和失效条件。

package/skills/market/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: market
+description: A 股大盘复盘 skill。用于市场快评、完整复盘、盘中分时复盘、指数/板块 ETF/风格轮动/资金偏好判断；优先使用 stock-analyzer-skill 包内 scripts/quote.py 和 scripts/kline.py 获取实时指数与板块 ETF 数据。
+---
+
+# Market Review
+
+每日大盘复盘——指数+板块+风格+资金+预判。
+
+## Usage
+
+```text
+/market [范围: full|quick|intraday]
+```
+
+- `full`（默认）：完整复盘，指数+板块+风格+持仓影响+明日预判
+- `quick`：3分钟快评，涨跌+最强最弱板块+一句话结论
+- `intraday`：分时复盘，大盘+关键标的5分钟走势分析
+
+## Instructions
+
+使用中文，输出简洁有结构。先给市场状态和操作倾向，再展开指数、板块、风格证据。涉及“今天、盘中、最新”时必须取实时数据。
+
+## Workflow Coordination
+
+完整链路见包根目录 `workflow.md`。本 skill 是大多数分析的上游入口：
+
+- 下游到 `sector`：当输出强/弱板块、轮动方向或行业主题时，继续做板块全景。
+- 下游到 `screener`：当用户要“找机会/选股/候选池”时，把市场状态映射为策略：进攻=`growth_momentum`，均衡=`balanced`，防守=`defensive`，价值修复=`quality_value`，急跌企稳=`turning_point`。
+- 下游到 `portfolio`：当用户关心持仓影响或调仓时，交接 `market_regime`、强弱板块、风险级别。
+
+输出必须包含 `market_regime`（进攻/均衡/防守/冰点/亢奋）和适合的下一步 skill。
+
+### Step 1: 获取大盘数据
+
+优先使用包内脚本。当前 skill 目录到包根目录为 `../../..`：
+
+```bash
+python3 scripts/quote.py sh000001,sz399001,sz399006,sh000300,sh000016,sh000905
+```
+
+### Step 2: 获取板块ETF
+
+```bash
+python3 scripts/quote.py sh510050,sh510300,sh510500,sh512010,sh512480,sh512690,sh512800,sh513120,sh512660,sh515790,sh515030,sh516160
+```
+
+盘中模式额外取指数或关键 ETF 的 5 分钟 K 线：
+
+```bash
+python3 scripts/kline.py sh000001 5 48
+python3 scripts/kline.py sh512480 5 48
+```
+
+### Step 3: 分析输出
+
+**full模式输出结构：**
+
+```
+## 大盘全景
+| 指数 | 收盘 | 涨跌 | 信号 |
+
+## 板块涨跌排行
+🔥 强势板块 | 💀 弱势板块
+
+## 风格判断
+- 大小盘分化: 上证50 vs 中证500
+- 市场风格: 成长/价值/防御
+- 资金流向: 流入/流出板块
+
+## 持仓影响
+| 持仓 | 今日 | 板块 | 匹配度 |
+
+## 明日预判
+- 方向判断
+- 关注板块
+- 操作建议
+- 数据日期/时间
+```
+
+**quick模式：** 只输出指数+最强最弱板块+一句话
+
+**intraday模式：** 额外获取关键标的5分钟K线做分时分析
+
+### Step 4: 风格信号库
+
+| 信号 | 含义 | 历史胜率 |
+|------|------|---------|
+| 上证50涨+中证500跌 | 大小盘分化，防御为主 | 高 |
+| 半导体/光伏暴跌 | 成长板块杀跌 | 短期超跌反弹概率大 |
+| 医药/白酒/银行齐涨 | 防御行情确立 | 持续2-3天 |
+| 券商+黄金同涨 | 市场方向不明，博弈+避险 | 震荡延续 |
+| 创业板单日+3%以上 | 超跌暴力反弹 | 需观察次日是否延续 |
+
+## Guardrails
+
+- 不要虚构北向资金、成交额、融资余额等脚本无法直接提供的数据；如用户需要，说明当前工具未覆盖或另行查询。
+- 若市场休市，明确说明行情数据可能是上一交易日。
+- 输出建议按“进攻/均衡/防守”分层，不给无条件满仓或清仓指令。

package/skills/portfolio/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: portfolio
+description: A 股持仓组合健康检查 skill。用于组合实时涨跌、仓位/板块集中度、风险预警、调仓再平衡和持仓标的对比；优先读取 data/portfolio.json，缺失时回退 data/portfolio_example.json，并使用 scripts/quote.py、scripts/finance.py、scripts/kline.py 获取数据。
+---
+
+# Portfolio Review
+
+持仓组合健康检查——实时盈亏+板块分布+风险监控+调仓建议。
+
+## Usage
+
+```text
+/portfolio [模式: health|rebalance|compare]
+```
+
+- `health`（默认）：持仓健康检查，涨跌+支撑位+风险预警
+- `rebalance`：结合大盘风格给出调仓建议
+- `compare`：持仓标的互相对比+替换建议
+
+## Instructions
+
+使用中文，输出用表格+红绿标记。先给组合状态和最需要处理的风险，再给逐项数据。不要假设用户的真实持仓，除非 `data/portfolio.json` 或用户消息提供了持仓。
+
+## Workflow Coordination
+
+完整链路见包根目录 `workflow.md`。本 skill 是最终落地和再平衡环节：
+
+- 上游来自 `market`：接收市场状态，决定组合进攻/均衡/防守。
+- 上游来自 `technical`：接收破位、止损、支撑阻力，决定减仓或观察。
+- 上游来自 `screener`/`stock`：接收替代候选和投资结论，决定换仓。
+- 下游到 `screener`：当组合需要补行业、降低集中度或替换弱势股时，生成候选池。
+- 下游到 `stock`：对拟买入或拟替换标的做最终五层确认。
+
+输出必须包含 `position_plan`、行业集中度、需要处理的持仓、替代候选需求。
+
+### Step 1: 获取全部持仓行情
+
+当前 skill 目录到包根目录为 `../../..`。先读取 `data/portfolio.json`；不存在时使用 `data/portfolio_example.json`，并在输出中标注“示例持仓”。
+
+```bash
+python3 scripts/quote.py <持仓sh/sz代码列表>
+python3 scripts/finance.py -c <持仓SH/SZ代码列表>
+python3 scripts/kline.py <单只持仓代码> 240 30
+```
+
+脚本支持 `-j` 输出 JSON，便于计算组合权重、行业暴露和排序。
+
+### Step 2: 获取大盘+板块
+
+```bash
+python3 scripts/quote.py sh000001,sz399001,sz399006,sh000016
+python3 scripts/quote.py sh512010,sh512480,sh512690,sh512800,sh513120,sh518880
+```
+
+### Step 3: 健康检查输出
+
+**health模式输出：**
+
+```
+持仓健康检查 | 时间: YYYY-MM-DD HH:MM
+
+┌─────────┬──────┬──────┬──────┬──────┬──────┐
+│ 标的     │ 现价  │ 今日  │ 占比  │ 状态  │ 风险  │
+├─────────┼──────┼──────┼──────┼──────┼──────┤
+│ 宝丰能源 │ 24.59│ +0.2%│ 15%  │ ⚠️   │ 24.0 │
+│ 云铝股份 │ 28.52│ -0.9%│ 10%  │ ✅   │ 27.5 │
+│ ...      │      │      │      │      │      │
+└─────────┴──────┴──────┴──────┴──────┴──────┘
+
+板块分布: 资源40% 医药0% 科技5% 避险8% 金融3.5% 现金30%
+风险评级: ⚠️ 资源仓位偏重，科技偏轻
+```
+
+**rebalance模式额外输出：**
+- 大盘风格判断（成长/价值/防御）
+- 板块轮动信号
+- 调仓建议（卖出/买入/持有）
+
+**compare模式额外输出：**
+- 持仓标的横向对比表（PE/ROE/增速/走势）
+- 替换建议（弱→强）
+
+### Step 4: 风险预警规则
+
+| 预警 | 条件 | 操作建议 |
+|------|------|---------|
+| 🔴 破位 | 跌破关键支撑位 | 减仓/止损 |
+| 🟡 弱势 | 连续2日跑输板块 | 观察/减仓 |
+| 🟢 健康 | 在支撑位上方运行 | 持有 |
+| ⭐ 强势 | 板块领涨+放量 | 持有/加仓 |
+
+## Guardrails
+
+- 未知成本价时，不计算真实盈亏，只做当日涨跌、估值和风险状态。
+- 调仓建议必须包含“减/加多少、触发条件、替代标的或现金比例”，避免泛泛而谈。
+- 不要建议超过用户风险承受能力的集中仓位；单一行业或主题过重时优先提示组合风险。