A股行业投研 Skill

对某个申万行业/东财板块做一次完整投研交付：Top N 涨幅标的 → 公告窗口检索 → 市场情绪判断 → Agent Team 对抗验证 → 综合报告。

铁律（每次执行都必须遵守，违反代价最高）

1. 宁可标注不确定，不可给错误答案（用户原话，最高纪律）。没有十足把握的事实写「不确定/未核实」，不编、不猜、不省略来源。推断与观察必须分开表述。
2. 基于证据、基于数据。每个结论 trace 到一手数据源（API 返回 / CSV 落盘 / 官方公告）；汇报数值时从工具输出原文照抄，禁凭印象转写。
3. 证据分级 L1–L3：L1 一手行情（交易所/行情接口实时值）；L2 带时间戳的媒体/公告报道；L3 未核实标题或传闻。判断情绪时只允许 L1/L2 承重，L3 只能作为「待核实线索」列出。
4. 0 条双向读：月窗口公告 0 条 ≠ 真无公告。必须扩宽窗（90 天）+ 第二数据源核对，证明「真无」或发现参数错误，才能下结论。
5. 双源交叉：公告检索必须巨潮 + 东财两源对照；单一数据源发现的「重要公告」也要在另一源确认存在，不一致必须如实标注。
6. 盘中快照标注漂移：盘中取的行情数值是瞬时快照会漂移，任何引用必须带快照时间戳，报告里注明「盘中快照」。
7. 数值照抄落盘 CSV：中间数值必须落盘（脚本输出 CSV / agent 落盘文件），报告引用时照抄 CSV 值，不凭对话记忆。
8. Agent Team 编排纪律：见 references/agent-orchestration.md——子代理显式 model:'sonnet'；SendMessage 交付协议；每条 finding 带可证伪锚点；验证用 fresh-context 对抗性 agent；禁 spawn 重复 agent。

工作流（五阶段）

Phase 0  数据能力侦察 → 必要时 pivot 公开源
Phase 1  并行三 agent：Top N 名单 / 涨跌幅分桶分布 / 情绪证据清单
Phase 2  公告检索：Top N 全标的 × 周窗口 + 月窗口，双源交叉
Phase 3  对抗验证：fresh-context agent 复核假设（用户原话：「看哪些假设是错的」）
Phase 4  综合报告：名单 + 公告 + 情绪分级 + 显式不确定标注

Phase 0 — 数据能力侦察（Gangtise pivot 决策）

若用户点名 Gangtise（或其官方 skill），先侦察可用性再决定数据源：

1. 对照实验判「额度」：同一凭据某些端点可用（如 quote.py、stockpool.py、get_industries.py）而内容搜索端点全报 POINT_NOT_ENOUGH → 这是积分不足的整体性解释，同一凭据一通一挂已否定「网络/配置问题」；若不同端点表现不一致，别急着下「额度耗尽」结论，做对照实验（换端点/换参数/最小请求）。
2. pivot 决策表：内容搜索不可用 → Top N 改东财成分股+新浪快照；公告改 cninfo+东财；情绪改公开行情+媒体。侦察结论与 pivot 决策必须告知用户，不静默切换数据源。
3. 完整侦察矩阵（各端点实测形态、积分报错、对照实验）→ references/gangtise-scout.md

Phase 1 — 并行三 agent

派 3 个并行 agent（显式 sonnet），每个 prompt 附可证伪锚点要求：

行情与板块接口细节 → references/market-data.md；情绪证据方法与信源 → references/sentiment-evidence.md。

Phase 2 — 公告检索

对 Top N 全标的查公告，周窗口（近 7 天）与月窗口（近 31 天）互斥分桶：

# 脚本路径按本 skill 安装目录（SKILL.md 同级目录下的 scripts/）执行，示例用相对路径仅指 skill 包内
cd <本 skill 安装目录>
env -u http_proxy -u https_proxy -u all_proxy -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY \
  python3 scripts/ann_query.py --codes 002219,600613,920946 \
  --end 2026-08-13 --out-dir /path/out \
  --universe-csv /path/top10_xxx.csv

脚本内置：巨潮 orgId 一律 topSearch 解析（禁按市场自拼，深市双形态/沪市前导零/科创板 gfbj 均实测拼错即假阴）、B 股（900/200 开头）自动转对应 A 股代码检索、双源交叉与类型回填、两源翻页、月窗 0 条自动扩宽窗判据（宽窗最新日期 vs 月窗起点）、URL 抽查。orgId 陷阱与接口形态 → references/cninfo-announcements.md。

分桶规则：公告日期落在周窗口内标 1周，否则（仍在月窗口内）标 1月，互斥不重复。输出表头：股票代码,股票名称,公告标题,公告日期,公告类型(如有),公告URL,时间窗口(1周|1月)。

必做验证：① 双源交叉（巨潮 vs 东财）计数一致；② 0 条标的扩宽窗确认「真无」；③ 两源覆盖不完全一致（部分投关类公告仅东财有、部分巨潮也收录），东财独有条目补并集并按 URL 域名标注来源。

Phase 3 — 对抗验证（用户原话：「看哪些假设是错的」）

派 2 个 fresh-context 对抗性 agent（不 fork，不共享本会话上下文），各自带验证轴：

• 验证轴 1 · 方法论与数值：Top N 名单重算（独立重跑数据链）、分桶统计重算（六桶 count 加和 = total）、快照时间戳核对
• 验证轴 2 · 公告完整性与情绪证据强度：抽查公告月窗口是否漏检、情绪结论逐条检查是否 L1/L2 承重、有无未标注的推断

每个 agent 的 finding 必须带可证伪锚点（具体数值/URL/命令输出），prompt 中明令「编造不如标不确定」。验证结果在综合报告中单独成节：哪些假设被推翻、哪些被确认、哪些无法验证。编排细节 → references/agent-orchestration.md。

Phase 4 — 综合报告

交付结构：

1. 数据源与 pivot 披露：用了哪些源、哪些不可用、为何 pivot
2. Top N 名单：表格（排名/代码/名称/涨幅/价格/成交额）+ 快照时间戳
3. 公告清单：周/月分桶，按标的聚合，标注来源与交叉验证结果
4. 情绪判断：L1–L3 分层呈现，结论明确标注证据等级；证据不足的维度写「不确定：无 L1/L2 证据」
5. 验证结果：对抗验证发现、假设推翻清单
6. 不确定项清单：所有未达「十足把握」的条目显式列出

报告数值一律照抄落盘 CSV，禁止凭记忆转写。

环境约束

• 国内站点（东财/新浪/巨潮）curl/脚本必须去代理：env -u http_proxy -u https_proxy -u all_proxy -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY
• Python 用 uv run --no-project 或系统 python3（脚本 stdlib only）
• 新浪快照返回 GBK 编码，需 Referer https://finance.sina.com.cn；东财公告接口可不带 Referer（实测）；北交所公告不单独走 bse.cn（官网接口三重失效，走巨潮 gfbj 通道）
• 若 push2 域名解析进 198.18.0.0/15（代理 TUN fake-IP），去代理无效，须修代理分流或用 curl --resolve 直连真实 IP（见 references/market-data.md）