improve stockbuddy skill guidance and IM-friendly templates

SKILL.md

@@ -17,7 +17,7 @@ A 股、港股、美股的技术面与基础估值综合分析工具，输出量
 
 ## 环境准备
 
-首次使用时运行安装脚本，确认 Python 依赖就绪：
+仅在依赖缺失，或脚本运行时报缺包错误时，再执行安装脚本：
 
 ```bash
 bash {{SKILL_DIR}}/scripts/install_deps.sh
@@ -49,10 +49,9 @@ bash {{SKILL_DIR}}/scripts/install_deps.sh
 
 3. **解读并呈现结果**
    - 脚本输出 JSON 格式分析数据
-   - **首次响应默认使用模板化报告**：按 `references/output_templates.md` 中"单只股票分析报告"模板直接输出，不额外展开成长篇自由分析
-   - **只有在用户追问细节时**（如"展开讲讲"、"为什么是这个评级"、"短线怎么看"、"止盈止损怎么设"、"详细分析"），再切换为更自然的开放式解读，围绕用户追问点展开说明
+   - **首次单股分析必须按模板输出**：若无额外要求，严格按 `references/output_templates.md` 中"单只股票分析报告"模板直接输出，不改写成随意风格，不额外展开成长篇自由分析
+   - **仅当用户明确追问细节时**（如"展开讲讲"、"为什么是这个评级"、"短线怎么看"、"止盈止损怎么设"、"详细分析"），才切换为更自然的开放式解读，围绕用户追问点展开说明
    - 最终结果直接输出为标准 Markdown 正文，不要包在代码块里；默认可以保留规范 Markdown 表格，并确保标题层级、分隔线与表格语法标准化
-   - **结尾必须附上风险免责提示**
 
 ### 场景二：持仓批量分析
 
@@ -77,7 +76,6 @@ bash {{SKILL_DIR}}/scripts/install_deps.sh
    - 按 `references/output_templates.md` 中"持仓批量分析报告"模板呈现
    - 直接输出为标准 Markdown 正文，不要包在代码块里；可使用规范 Markdown 表格与列表混合呈现，保证不同平台可读性
    - 包含每只股票的操作建议和整体盈亏汇总
-   - **结尾必须附上风险免责提示**
 
 ### 场景三：持仓管理
 
@@ -115,12 +113,12 @@ bash {{SKILL_DIR}}/scripts/install_deps.sh
 | -4 ~ -2 | 🔴 卖出 |
 | ≤ -5 | 🔴🔴 强烈卖出 |
 
-详细的技术指标解读与评分标准参见 `references/technical_indicators.md`。
+仅当用户要求解释评分逻辑、技术指标含义，或你需要校准开放式解读时，再读取 `references/technical_indicators.md`。
 
 ## 重要注意事项
 
 - 所有分析仅供参考，**不构成投资建议**
-- 数据来源为 **腾讯财经**，实时准确
+- 数据来源以 **腾讯财经** 为主，可能存在延迟、缺口或字段局限
 - 港股没有涨跌停限制，波动风险更大
 - 每次分析结果末尾**必须**附上风险免责提示
 - 技术分析在市场极端情况下可能失效

references/output_templates.md

@@ -3,21 +3,22 @@
 ## 单只股票分析报告
 
 > 按以下 Markdown 结构直接输出最终报告，不要再包一层代码块。
+> 优先适配 Telegram 等 IM：少用表格，多用短段落和项目符号，避免横向过宽的排版。
 
 ## 📊 {公司名称} ({股票代码}) 分析报告
 
-**市场**: {市场} | **交易所**: {交易所} | **币种**: {币种}
-**当前价格**: {币种符号}{价格} ({涨跌幅}%)
-**分析时间**: {时间}
-**数据周期**: {周期}
+- **市场 / 交易所 / 币种**：{市场} / {交易所} / {币种}
+- **当前价格**：{币种符号}{价格} ({涨跌幅}%)
+- **分析时间**：{时间}
+- **数据周期**：{周期}
 
 ---
 
-### {建议图标} 操作建议: {操作建议}
-**动作类型**: {动作类型}
-**综合评分**: {评分}
-**置信度**: {置信度等级} ({置信度分数})
-**市场场景**: {市场场景}
+### {建议图标} 操作建议：{操作建议}
+- **动作类型**：{动作类型}
+- **综合评分**：{评分}
+- **置信度**：{置信度等级} ({置信度分数})
+- **市场场景**：{市场场景}
 
 #### 核心信号
 - {核心信号1}
@@ -30,51 +31,42 @@
 ---
 
 ### 📈 多层评分
-
-| 评分层 | 分数 | 解读 |
-|---|---:|---|
-| 趋势层 | {趋势层} | {趋势层解读} |
-| 动量层 | {动量层} | {动量层解读} |
-| 风险层 | {风险层} | {风险层解读} |
-| 估值层 | {估值层} | {估值层解读} |
-| 相对强弱 | {相对强弱} | {相对强弱解读} |
-| 量价结构 | {量价结构} | {量价结构解读} |
+- **趋势层**：{趋势层} —— {趋势层解读}
+- **动量层**：{动量层} —— {动量层解读}
+- **风险层**：{风险层} —— {风险层解读}
+- **估值层**：{估值层} —— {估值层解读}
+- **相对强弱**：{相对强弱} —— {相对强弱解读}
+- **量价结构**：{量价结构} —— {量价结构解读}
 
 ### 📉 技术面细节
-
-| 指标 | 数值 | 信号 |
-|---|---|---|
-| 均线趋势 | {均线排列} | {均线信号} |
-| MACD | DIF:{DIF} DEA:{DEA} MACD:{MACD} | {MACD信号} |
-| RSI | RSI6:{RSI6} RSI12:{RSI12} RSI24:{RSI24} | {RSI信号} |
-| KDJ | K:{K} D:{D} J:{J} | {KDJ信号} |
-| 布林带 | 上:{上轨} 中:{中轨} 下:{下轨} | {布林带信号} |
-| 成交量 | 量比:{量比} | {成交量信号} |
+- **均线趋势**：{均线排列}
+  - 信号：{均线信号}
+- **MACD**：DIF:{DIF} / DEA:{DEA} / MACD:{MACD}
+  - 信号：{MACD信号}
+- **RSI**：RSI6:{RSI6} / RSI12:{RSI12} / RSI24:{RSI24}
+  - 信号：{RSI信号}
+- **KDJ**：K:{K} / D:{D} / J:{J}
+  - 信号：{KDJ信号}
+- **布林带**：上:{上轨} / 中:{中轨} / 下:{下轨}
+  - 信号：{布林带信号}
+- **成交量**：量比 {量比}
+  - 信号：{成交量信号}
 
 ### 📋 基本面概况
-
-| 指标 | 数值 |
-|---|---|
-| 市盈率(PE) | {PE} |
-| 市净率(PB) | {PB} |
-| 市值 | {市值} |
-| 52周高点 | {52周高点} |
-| 52周低点 | {52周低点} |
-| 52周位置 | {52周位置} |
-| 基本面判断 | {基本面判断} |
+- **市盈率 (PE)**：{PE}
+- **市净率 (PB)**：{PB}
+- **市值**：{市值}
+- **52周高点**：{52周高点}
+- **52周低点**：{52周低点}
+- **52周位置**：{52周位置}
+- **基本面判断**：{基本面判断}
 
 ### 🧪 历史验证
-
-| 指标 | 数值 |
-|---|---|
-| 相似样本数 | {样本数} |
-| 5日平均收益 | {5日平均收益}% |
-| 5日胜率 | {5日胜率}% |
-| 10日平均收益 | {10日平均收益}% |
-| 10日胜率 | {10日胜率}% |
-| 20日平均收益 | {20日平均收益}% |
-| 20日胜率 | {20日胜率}% |
-| 回撤代理 | {回撤代理}% |
+- **相似样本数**：{样本数}
+- **5日平均收益 / 胜率**：{5日平均收益}% / {5日胜率}%
+- **10日平均收益 / 胜率**：{10日平均收益}% / {10日胜率}%
+- **20日平均收益 / 胜率**：{20日平均收益}% / {20日胜率}%
+- **回撤代理**：{回撤代理}%
 
 ### 💡 分析总结
 {2-4句话的自然语言总结，至少包含：当前市场场景、操作建议、置信度、主要支撑/风险点。若历史验证样本不足，要明确提醒。}
@@ -84,19 +76,17 @@
 ## 持仓批量分析报告
 
 > 按以下 Markdown 结构直接输出最终报告，不要再包一层代码块。
+> 优先适配 Telegram 等 IM：避免大表格，按卡片式分段输出。
 
 ## 📊 持仓分析报告
 
-**分析时间**: {时间}
-**持仓数量**: {数量}只
+- **分析时间**：{时间}
+- **持仓数量**：{数量}只
 
 ### 💰 总览
-
-| 指标 | 数值 |
-|---|---|
-| 总成本 | {总成本} |
-| 总市值 | {总市值} |
-| 总盈亏 | {盈亏} ({盈亏比例}%) |
+- **总成本**：{总成本}
+- **总市值**：{总市值}
+- **总盈亏**：{盈亏} ({盈亏比例}%)
 
 ---
 
@@ -105,12 +95,12 @@
 {对每只股票输出简要分析卡片，格式如下：}
 
 #### {序号}. {公司名称} ({股票代码}) — {操作建议图标} {操作建议}
-- **市场/币种**: {市场} / {币种}
-- **动作类型**: {动作类型} | **场景**: {市场场景}
-- **当前价**: {当前价} | **买入价**: {买入价}
-- **持仓数量**: {数量}股 | **盈亏**: {盈亏} ({盈亏比例}%)
-- **综合评分**: {评分} | **置信度**: {置信度等级} ({置信度分数})
-- **核心信号**: {1-3条最重要的信号}
+- **市场 / 币种**：{市场} / {币种}
+- **动作类型 / 场景**：{动作类型} / {市场场景}
+- **当前价 / 买入价**：{当前价} / {买入价}
+- **持仓数量 / 盈亏**：{数量}股 / {盈亏} ({盈亏比例}%)
+- **综合评分 / 置信度**：{评分} / {置信度等级} ({置信度分数})
+- **核心信号**：{1-3条最重要的信号}
 
 ---
 
@@ -127,7 +117,8 @@
 
 - 所有 `{占位符}` 根据脚本返回的 JSON 数据填充。
 - 最终输出必须是标准 Markdown 正文，不要放进 ``` 代码块。
-- 可以保留 Markdown 表格；默认优先使用规范表格语法，保证在常见渲染器中稳定显示。
+- 优先使用短段落、项目符号、卡片式结构；除非用户明确要求，否则尽量不要使用宽表格。
+- Telegram 等 IM 场景下，优先保证手机端可读性，避免一行承载过多字段。
 - 操作建议图标映射：🟢🟢 强烈买入 / 🟢 买入 / 🟡 持有 / 🔴 卖出 / 🔴🔴 强烈卖出。
 - 单股报告优先展示：`recommendation.action`、`recommendation.action_type`、`recommendation.confidence`、`recommendation.regime`、`recommendation.layer_scores`、`signal_validation`。
 - 价格和盈亏前缀不要写死为 HK$，应按币种动态展示（HKD/CNY/USD）。