wjs-researching-company — 一家公司，一场多空辩论，一本书

输入：股票代码（如 INTC），可选公司名、章数（缺省 6）。 产出（全部在 ~/code/reports/<TICKER>-<YYYY-MM-DD>/）：

文件	内容
00-local.md	我手里已有的信息（记忆库、持仓、旧报告）
01-unusualwhales.md	Unusual Whales：价格、期权/IV、资金流、做空、内部人/机构/国会、财报反应、新闻
02-zerohedge.md	zerohedge.com 的相关文章与转载的卖方观点
03-fundamentals-news.md	财报、指引、事件时间线、估值、卖方评级、催化剂
04-futu.md + futu/*.csv	富途 OpenD 行情：快照（含盘前/盘后）、一年日线、按日资金流向、大中小单分布、所属板块、近几个到期日期权链
debate/	bull-1.md bear-1.md（立论）→ -2（反驳）→ -3（结辩）→ judge.md（裁决）
book-<slug>/	书的工作目录（book.json、chapters/NN.html、reviews/NN.json、cover.jpg）
~/code/reports/predictions.tsv	预测流水（只追加），以后回头打分校准用

最后一步把书直接上架 voicedrop.cn/books/<slug>/——用写书 skill 的 build.mjs，正文就是我们写好的，不交给云端写书 AI 重写（MCP write_book 只收 20k 字的种子、AI 会自由发挥，不用它）。

核心原则

• 事实与观点分层：收集层只记事实（每个数带日期和出处），辩论层才有观点，裁决层才有预测。书里每个数字都能追到 01–04 的某一行。
• 辩论要真对抗：多方、空方是两个独立 agent，互相看不到对方的思路，只看到对方的成稿；裁判是第三个没参与辩论的 agent。
• 预测要可打分：每个时间窗给方向、价格区间、上涨概率和 confidence，并用期权隐含波动区间做对照。说不准就说不准，confidence 低也照写。
• 不是投资建议：书里写明数据截止时间、作者持仓（查 jianshuo-memory/10-investing/），以及「这是推演，不是建议」。

流程

0. 定目标与目录

• 用 mcp__unusualwhales__uw_stock {action_type:"info", ticker} 和 {action_type:"stock_state"} 确认公司、市值、下次财报日、最新价（盘前/盘中/收盘要标清）。
• 建目录 ~/code/reports/<TICKER>-<今天>/。
• 写 00-local.md：在 ~/code/jianshuo-memory（尤其 10-investing/）、~/code/reports/、~/code/wechat-publish/ 里 grep 代码和公司名；有富途 OpenD 时可用 ~/code/futu-tools/query.py 查持仓。没有就写「无持仓、无旧资料」。

1. 收集（三个 agent 并行，一条消息里同时发）

提示词模板在 references/prompts.md 的「收集」一节，各自写自己的文件：

1. Unusual Whales → 01-unusualwhales.md。MCP 工具 mcp__unusualwhales__uw_*，参数鉴别字段是 action_type（不是 action）。
2. Zero Hedge → 02-zerohedge.md。WebSearch + allowed_domains:["zerohedge.com"] 多角度检索，再 WebFetch 读正文；付费墙读不到就记标题、日期、URL、摘要。
3. 基本面与新闻 → 03-fundamentals-news.md。财报一手来源（公司 IR、8-K、电话会）优先，近期事件用 WebSearch 的 extended 模式。

同时主循环自己跑富途（几秒钟，不用派 agent）：

cd ~/code/futu-tools && .venv/bin/python research.py US.<T> --expiries 3 --out <D>/futu > <D>/04-futu.md

需要本机 OpenD 在跑并已登录（nc -z 127.0.0.1 11111）。没开就请建硕打开 /Applications/Futu_OpenD.app 登录，或者跳过这一份并在 00 里注明。脚本只用行情接口，不碰交易。港股、A 股把前缀换成 HK. / SH. / SZ.。注意：财报或大事件后跳空时，期权快照里的「平值」是按上一个收盘价取的，要在 04 里注明。

四份到齐后主循环通读一遍，有明显缺口（比如没拿到财报指引）就补派一个 agent，别带着缺口去辩论。

2. 辩论（三轮，每轮多空并行）

提示词在 references/prompts.md 的「辩论」一节。每个辩手都读 00–04 全部资料。

轮	多方	空方
1 立论	bull-1.md：最强的 5 条看多理由 + 目标价	bear-1.md：最强的 5 条看空理由 + 目标价
2 反驳	读 bear-1.md，逐条反驳 → bull-2.md	读 bull-1.md，逐条反驳 → bear-2.md
3 结辩	读 bear-2.md，承认什么、坚持什么 → bull-3.md	读 bull-2.md → bear-3.md

每轮都要新 spawn 辩手（上一轮的成稿通过文件传，不复用上下文），这样每一轮只靠写下来的论证说话。

3. 裁决（独立裁判）

新 spawn 一个没参与的 agent，读 00–04 和六份辩稿，写 judge.md：逐条判哪方论证更站得住，然后给预测表（1 周 / 1 个月 / 3 个月 / 12 个月）：方向、中枢价、区间、上涨概率、confidence（0–100%）、最关键的三条理由、什么信号出现就说明判断错了。必须和期权隐含区间（价格×IV×√(T/365)）对照，偏离要说理由。

裁决完把预测追加进 ~/code/reports/predictions.tsv（只追加，表头：日期 代码 基准价 窗口 方向 中枢 区间低 区间高 上涨概率 confidence 书slug）。

4. 成书（按写书 skill 的科普书写法，直接写）

先读两份写书 skill（真源在 jianshuo.dev 仓库）：

S=~/code/jianshuo.dev/claude-agent/skills
cat $S/wjs-voicedrop-writing-book/SKILL.md $S/wjs-voicedrop-writing-explainary-book/SKILL.md

照它们来：type: "explainary"、category: "投资"、费曼式文风、<dfn> 和大白话盒子、写手和评审独立、过审一章发一章。和写书 skill 不同的只有两点：章数缺省 6（用户可改），大纲是固定骨架（不另派建筑师），见 references/prompts.md 的「成书」一节：

1. 今天发生了什么（现状、这次事件、数据截止时间）
2. 这家公司怎么走到今天（历史、业务、财务、竞争）
3. 市场在用钱投票（期权、资金流、做空、内部人与机构）
4. 看多的人怎么说（多方论证 + 空方反驳的过程）
5. 看空的人怎么说（空方论证 + 多方反驳的过程）
6. 裁决：涨还是跌、有多大把握、为什么（预测表 + 证伪信号 + 免责声明）

工作目录用 ~/code/reports/<TICKER>-<日期>/book-<slug>/。slug 只能用小写字母、数字和连字符，形如 intc-2026-10。book.json 写 author: "王建硕"，owner 写 users/anon-ae209ac53499d51d513425503bd134b0/（本机凭据 ~/.config/voicedrop/credentials 就是这个账号，也是书架发布账号，GET https://jianshuo.dev/files/api/whoami 可核对）。

B=~/code/jianshuo.dev/claude-agent/skills/wjs-voicedrop-writing-book/build.mjs
node $B index book-<slug>            # 骨架先上线
node $B done book-<slug> 01          # 每章过审即发
node $B intro book-<slug>            # 导读
node $B all book-<slug>              # 收尾，打印公开链接

build.mjs 要用包含表格样式的版本（jianshuo.dev main 2ddabfb 起），先 git -C ~/code/jianshuo.dev pull。科普书写法已允许 <table>，数据表和预测表放心用。

节奏（省时间的关键）：第 1–3 章只依赖 00–04 资料，收集完就和辩论同时开写；第 4、5 章等第 3 轮结辩，第 6 章等裁决。评审不过就换新写手照 must_fix 改，再派新评审复审。评审判了 pass 但仍列了 must_fix 时，小改一下就发，不用再复审。

封面：在 Tokyo VPS 上用 paint 出图（book 流水线同一个工具，带 --group <slug>）。paint 要 PAINT_API_TOKEN，从 /opt/claude-agent/.env 读，别回显；退出码 3 表示还没画完，原样重跑。提示词里有中文和引号，写成小脚本 scp 上去跑最省事：

# 在 VPS 上（root）
TOK=$(grep '^PAINT_API_TOKEN=' /opt/claude-agent/.env | cut -d= -f2-)
mkdir -p /opt/claude-agent/workspace/covers && chown claude-agent /opt/claude-agent/workspace/covers
sudo -u claude-agent env PAINT_API_TOKEN="$TOK" /opt/claude-agent/bin/paint '<提示词>' /opt/claude-agent/workspace/covers/<slug>.jpg --size 1024x1536 --group <slug> --label <书名>
# 回本机
scp root@66.42.45.128:/opt/claude-agent/workspace/covers/<slug>.jpg book-<slug>/cover.jpg
node $B asset book-<slug> cover.jpg cover.jpg

封面要求照写书 skill：大字书名为主、副标题、作者「王建硕」，淡雅抽象背景，画面上只出现这些字，JPG。拉回来用 Read 看一眼，字有错就重画。

导读 intro.html：裁决出来后主循环自己写就行（一个钩子 + 贯穿全书的问题 + 怎么做的 + 结论预告 + 截止时间/无持仓/不是建议），node $B intro book-<slug> 发。

5. 收尾

• 打开 https://voicedrop.cn/books/<slug>/ 抽查目录页和第 6 章。
• 给用户：书的链接、一句话结论（方向 + confidence）、研究目录路径。

Red Flags

• 书里出现 01–04 里找不到的数字 → 删掉或回去补出处。
• 辩手看到了对方的提示词或思路，或裁判参与过辩论 → 不算独立，重来。
• 预测只有方向没有概率和 confidence，或没和期权隐含区间对照 → 裁决不合格。
• 用 write_book 发书 → 会被云端 AI 重写、种子还被截到 20k，不用。
• 价格没标清盘前、盘中还是收盘，没写数据截止时间 → 补上。
• 忘了追加 predictions.tsv → 以后没法校准。