Hermes-Skills/lottery-hk/references/agent-workflow-pitfalls.md

# Agent Workflow Pitfalls (2026-07-30 实战累积, 2026-08-02 修正 Qi-2 与 no_agent 规则)

## 用户硬偏好 (违反必踩坑)

### 1. **不要在回复结尾加 "A/B/C 简单回答" 选项**
用户原话: "这是什么技能输出的?" (答: 没有任何 skill 输出, 是 agent 自己加的回复模板)。
- **agent 默认行为**: 结尾列"A. 是 / B. 否 / C. 别的" 选项
- **正确做法**: 直接回答用户问题, 不加模板。如果用户下一步不明, 等用户说。
- **应用到所有回复**, 不仅是 lottery。

### 2. **用户问"从哪取"只答来源一行, 不展开分析**
用户原话: "我要知道你从哪里取的时间啊?"
- **错**: "我对比了 X / Y / Z 三个数据源 + 验证了 N 个字段后才确认 082 期是周四开彩..."
- **对**: "082 期时间从 v_xg.json `Week=周四 Day=30` 取的。"
- 一行, 一句, 来源 + 数据, 完。

### 3. **错了立刻重做, 不分析 / 不等回话**
用户原话: "知道错了, 还要来确认, 你直接跑不行吗"
- **错**: "我错了, 让我再想想 / 检查一下 / 等你回话..."
- **对**: 立刻跑正确的事。
- **应用**: agent 报错 / 跑偏 / 答错 → 立刻重做, 不解释原因。

### 4. **跑 X 框架不要自己造公式**
用户原话: "记得我说过不要跑频率, 没有意义, 我要说什么你才能记住" / "我要 4 框架"
- **"4 框架"** = reference 里的真实推演流程 (v_xg.json + 挂牌 + 红字), **不是** agent 写 河洛/梅花/玄空/奇门 公式
- **"特码分析"** = sol.2344a.cc 挂牌 + 玄机 + 红字, **不混** v_xg.json Qi-2 期数据
- **流程**: 看到关键词 → 跑真脚本 (`lottery_4frame.py` / `lottery_特码.py`), 不要尝试自己推
- **保留路径**: `python3 ~/.hermes/skills/trading/lottery-hk/scripts/lottery_4frame.py`
- **保留路径**: `python3 ~/.hermes/skills/trading/lottery-hk/scripts/lottery_特码.py [期号]`

### 5. **信号/分析输出不平均分, 给重点分配 (2026-07-30 用户实战)**
用户原话: "怎么跟上次的号不一样呢" + "要有重点的分配"
- **错**: "5 个候选号各买 1 元 / 5 元平均分"
- **对**: 按权重比例分 (5/4/3/2/1), 重点放在前 2-3 个, 加 🥇🥈🥉 让用户快速识别
- **默认预算**: 信号类 (特码/跟单/做T) 用 ¥15 = 5/4/3/2/1
- 用户对"平均分"反应是"怎么跟上次不一样" → 直接诊断"权重排序 vs 临时排序" 不要防御性回避
- 适用范围: lottery 特码、币圈跟单、股票做 T 信号等"有预算上限的信号推送"

### 默认时区 = 北京时间 UTC+8
- 任何时间字段 (挂牌/开奖/推送/cron schedule) 默认 UTC+8
- cron schedule 是 UTC → 推送时**显式标注 "北京时间"**
- agent 默认假设 UTC → 用户必纠正

### 挂牌日 = 开彩日 (硬规则)
- sol.2344a.cc 挂牌帖发布时间 = 实际开奖日, **同一天**
- **错** (旧 SKILL.md 描述): "挂牌提前 2-3 天"
- **对** (用户 2026-07-30 实战确认): 挂牌日 = 开彩日, 同天

### v_xg.json 字段语义 (2026-08-02 修正!)
- `Qi` = 下次将开期号
- **`Data.1-7` = Qi-2 期 已开号码 (不是 Qi-1)** — 7 个号码 + 5 行字段
- `Week`/`Day`/`Year`/`Moon` = Qi 期 开彩日 (北京时间) — **不是"当前期"**
- `Nq` = 再下期
- **取 Qi-1 期 (实际刚开) 号码**: 查 sol.2344a.cc/挂牌 或 lottery.db, **v_xg.json 不显示 Qi-1 期**
- **早期版本错误**: 旧 SKILL.md (v1.2.6 及之前) 写"Data.1-7 = Qi-1 期" → 错的, 实际是 Qi-2 期
- **详细**: 见 `references/v_xg-data-qi-2-pitfall.md`

## QQ 推送格式 (跨 skill 用户偏好)

### 用横向 markdown 表格 (4-8 列)
- 每票 1 列, 多票并列可左右滑动比较
- 字段顺序: 名称表 + 项目表 (2 张表上下)
- 列用票代码, 行用指标 (现价/股息率/趋势/MA50/支撑/离均线/ATR/策略)

### 严禁垂直堆叠 (1 票 1 块)
用户原话: "这个多了很多 proxychains 的无用信息" / "不是这种表格, 是这种 (横向)"
- **错**: 每票 N 行 emoji 列表
- **对**: 横向 4-8 列表格

### 已应用脚本 (Hermes-Scripts 仓库)
- `dividend_alert.py` (A股/港股/美股股息)
- `cn_dividend_buy_timing.py` (A股高息买入时机)
- `daily_t_analysis.py` (做 T 分析)
- `scan_cn.py` / `dca_scanner.py` / `analyze_cmb.py` (高息扫描)

## cron agent 模式必用 no_agent + script (2026-08-02 实战)

**用户原话**: "把数据都丢了, 时间都是错的" / "你直接跑不行吗"

**反模式 (2026-08-02 lottery 推送 bug)**:
- 用 `cronjob` agent 模式 + skill `lottery-hk`
- 即使 SKILL.md 改 Qi-2 描述, model 仍按**旧认知** 编 (标题"082 期" + Qi-1 期 081 号码 + 错周二)
- 多次纠正后仍编, 用户说"会编"

**正解**: cron 用 `no_agent: true` + 真脚本
- 模型不参与, 0% 编概率
- 真脚本输出直接推 QQ
- **触发条件**: 任何 cron 任务涉及"数据源不完整 / 字段语义有歧义 / 时间/期号计算" → 必用 no_agent + script
- **保留路径**: `cd ~/.hermes/scripts && python3 <script>.py` 或 `~/.hermes/scripts/<wrapper>.sh`

**复盘**: 当时已经知道 `lottery_4frame.py` 存在 + 改了 cron prompt + 改了 SKILL.md description, **但还是错**。真正的修复必须是 `no_agent: true` + script, 让模型没有推理空间。

参考: `../../devops/cron-job-management/SKILL.md` §3 "Two Cron Job Modes" + §10 "Agent-Mode Cron + Provider Rate Limit" — 把这个规律扩展到新场景: **agent-mode cron + 任何"语义模糊源" (期号/日期/字段含义) = 编风险, 必 no_agent + script**。