A 股实时分析与操作建议（Stock Realtime Brief）
"规则比感觉重要——把可以提前算清楚的事，写在能照着执行的清单里。"
1. 三种使用模式
1.1 模式选择决策树
用户输入 →
├─ 提到"持仓 / 我的票 / 盘前简报"
│ → 模式 P：持仓模式（读 portfolio + 7 步法 + 公告检测 + 融资体检）
│
├─ 只提到 1 只股票（"看下 X / 分析 X"）
│ → 模式 S：单股深度模式（技术面 + 操作位 + 三档止损）
│
├─ 提到 2 只及以上（"X 和 Y 谁好 / 这几只票"）
│ → 模式 M：多股对比模式（横向对比 + 综合评分排序）
│
└─ 不确定时 → 优先问一句确认，不要默认
1.2 三种模式的核心差异
| 维度 | 模式 P（持仓） | 模式 S（单股） | 模式 M（多股） |
|---|---|---|---|
| 数据源 | portfolio + 实时 + K线 + 公告 | 实时 + K线 + 个股资金流 | 实时 + K线（精简） |
| 输出篇幅 | 长（含融资体检 + 公告告警） | 中（含基本面+技术面） | 短（对比表为主） |
| 止损规则 | 完整三档（含重仓收紧 + 利润保护位） | 标准三档 | 不强制止损 |
| 融资体检 | ✅ 必做 | ❌ | ❌ |
| 公告检测 | ✅ HIGH/MED 自动告警 | ❌ | ❌ |
| 特色 | 全面、防漏 | 深、详 | 横向、快 |
1.3 何时使用 / 何时不用
| 场景 | 触发 |
|---|---|
| 持仓盘前/盘中简报 | ✅ P |
| "看下 600519 / 帮我分析 X" | ✅ S |
| "X 和 Y 哪个好 / 这几只票排序" | ✅ M |
| "今天买什么 / 推荐股票" | ❌（这不是本 skill 职责，应转给"选股 skill"） |
| "X 公司基本面怎么样" | ⚠️ 单股模式可附带基本面，但不是核心 |
| 港美股 / 期货 / ETF | ❌ |
2. 通用 7 步法（三种模式共用骨架）
Step 1 解析用户输入 → 识别模式 P/S/M + 提取股票代码
Step 2 拉实时行情 → 优先腾讯接口（最稳）
Step 3 拉历史 K 线 → AKShare 主源 + 腾讯日 K 备源 + 重试
Step 4 计算关键位 → MA5/10/20/30 + 近 N 日高低 + 量能 + 40日涨幅
Step 5 判断态势 → 多头排列 / 空头排列 / 震荡 / 加速涨跌
Step 6 生成操作位 → 止损位（模式 P/S）或 排序推荐（模式 M）
Step 7 模式专属动作 → P:融资体检 + 公告 / S:深度分析 / M:横向对比
3. 数据源策略（按可靠性排序）
| 优先级 | 数据源 | 用途 | 备注 |
|---|---|---|---|
| 1️⃣ | 腾讯财经 | 实时行情 | 最稳。AKShare 主源超时也能拿到数据 |
| 2️⃣ | 新浪财经批量 | 实时（多只） | 一次拉多只，省时间 |
| 3️⃣ | AKShare 主源 | 历史 K 线 | 历史接口稳定，实时接口需 timeout |
| 4️⃣ | 腾讯日 K | 历史备源 | AKShare 失败时降级使用 |
踩过的坑：AKShare 主源 82.push2.eastmoney.com 在交易日早盘经常超时（实测 50+ 分钟无响应）。默认走腾讯，不要先尝试 AKShare 实时接口。
4. 三档硬止损规则
预警线：当日跌 5% 或跌破 MA5（一般股）/ MA10（重仓股）→ 减 1/3
风控线：跌破 MA10（一般股）/ MA20（重仓股）→ 再减 1/3
清仓线：跌破成本 -25%，或融资担保比例 < 150% → 全部清掉 + 还融资
4.1 仓位调整因子
- 重仓股（占比 ≥ 25%）：所有止损位上提 5%（容错收紧）
- 融资买入股：所有止损位上提 3%，且必须写成条件单
- 高位涨幅股（40日内涨 > 50%）：用 MA10 而非 MA20 作为风控线
- 盈利股 > 30%：额外提供"利润保护位"（现价 - 25% 利润）
- 亏损股：用 max(MA20, 成本-15%) 作为风控线
4.2 必须设条件单
不能让用户"盘中盯价"——白天忙、情绪波动、错过最佳点。 所有硬止损位都要让用户在券商 APP 里设条件单。
5. 融资风险体检（模式 P 必做）
5.1 担保比例公式
担保比例 = (持仓总市值 + 融资买入证券市值) / 融资余额
5.2 五档预警
| 担保比例 | 等级 | 动作 |
|---|---|---|
| < 150% | 🚨🚨🚨 | 接近强平区！立即降仓 |
| 150-160% | 🚨 | 强警告：尽快降杠杆 |
| 160-170% | ⚠️ | 警戒区：建议主动降仓 |
| 170-200% | 🟡 | 可控区：仍需关注 |
| > 200% | ✅ | 安全区 |
5.3 还款优先级（先还谁）
- 已经亏损 + 技术位最弱的票（割肉脱身）
- 高位震荡顶部特征明显的票（保利润）
- 重仓且涨幅过大的票（落袋部分）
- 不要先还：刚突破、技术位强势的票
6. 重要公告检测（模式 P 自动）
6.1 关键词识别
| 等级 | 触发关键词 |
|---|---|
| 🔴 HIGH | 减持股份、减持计划、立案、被调查、证监会、警示、业绩预减、诉讼 |
| 🟡 MED | 解禁、限售股、收购、重组、股东大会、定增、业绩预告、终止、处罚 |
6.2 时间过滤
仅保留 近 N 天（默认 14 天）的公告，避免历史利空污染。
7. 输出格式
详见 docs/methodology.md 或 README.md 中的示例。
8. 反模式（一定不要做）
| ❌ 错误 | ✅ 正确 |
|---|---|
| "建议谨慎操作" | "跌破 500 减 1/2，跌破 482 清融资部分" |
| "情绪面不佳" | "成交 4.79 亿，量比 0.62（早盘缩量）" |
| 把所有股票按输入顺序列一遍 | 按"重要性 / 紧迫度"排序 |
| 模式 P 不算融资担保比例 | 必须算，且单独成段 |
| 用 AKShare 主源超时还硬等 | 立即切腾讯接口（≤15s） |
| 给"目标价"但不给"止损价" | 永远是"止损 + 仓位管理"组合 |
| 让用户盘中盯价 | 让用户昨晚或开盘前设好条件单 |
| 模式 M 直接说"买 A" | 用"⭐ 优势更明显"+ 理由 |
| 模式 P 不查公告 | 必须查，公告利空可推翻技术面判断 |
9. 调用方式
# 模式 P：持仓
python -m stock_realtime_brief --mode portfolio --portfolio path/portfolio.json
# 模式 S：单股
python -m stock_realtime_brief --mode single --code 300757
# 模式 M：多股对比
python -m stock_realtime_brief --mode multi --codes 300757,688498,688234,600519
# 自动模式：根据输入数量自判
python -m stock_realtime_brief --auto --codes 300757,688498
Agent 调用流程
- 解析用户消息 → 判定模式 P/S/M
- 提取股票代码（中文名 / 6位代码 / 拼音）
- 调用
stock_realtime_brief.cli.main()或导入对应函数 - 套用本 skill 的 7 步法 + 模式专属规则
- 按模板输出 Markdown
10. 关联 skills（待建/可选）
weekly-position-review— 周末复盘 + 下周剧本evening-trading-log— 收盘后交易日志整理realtime-position-monitor— 盘中实时风险监测stock-screener— 选股 skill
11. 免责声明
本 skill 仅用于辅助分析，不构成任何投资建议。 详见 DISCLAIMER.md。