creator-research-tracker

name	creator-research-tracker
description	把 X/Twitter 博主、YouTube 博主、newsletter、播客或类似个人信息源的持续更新转成 progressive-investment-research 研究工作区的可审计增量。适用于：跟踪博主更新、生成每日报告、通过 Chrome 登录态或本地 browser bridge 抓 X、用 yt-dlp 抓 YouTube 字幕、把观点拆成 source leads、公司页、行业模块、open questions 和后续研究任务。Serenity 和 RihardJarc 是内置信息源案例，不依赖 PaiWork 专有工具。

Creator Research Tracker

这个 Skill 的目标不是跟单，也不是评价博主本人，而是把高质量个人信息源的观点变成可审计、可验证、可接续的研究输入。

对人：每天先看到“博主今天发了什么、哪些值得看、链接在哪里、下一步查什么”。

对 agent：只把有研究价值的内容写入 progressive-investment-research 工作区；原始材料和低价值内容放进归档，不进入默认恢复面。

不可破坏的边界

• 面向用户和 agent 的说明、日报、dossier 模板必须中文为主；只有枚举、脚本参数、平台字段、源文本摘录等必要位置保留英文。
• 这是原 PaiWork Serenity 跟踪流程的通用本地版，但不替代 serenity-thesis-tracker 原版；Serenity 只是内置信息源之一。
• 内置来源目前只保留 Serenity 和 RihardJarc；其他 creator 必须按新增来源流程显式接入，不预设未完成案例。
• X/Twitter 默认不调用 x-digest；优先使用 Codex Chrome 插件，其次使用本 Skill 内置的 browser-bridge collector、用户导出材料，或未来显式配置的 API adapter。
• 公开镜像站、搜索片段、缓存页只能作为辅助线索；不能把它们当成 live X 验收成功。
• X/Twitter 正式日报和 active route 只能使用 source-language 原文或完整人工导出；X UI 自动翻译、搜索摘要、公开镜像、未点击“显示原文/Show original”或未展开“显示更多/Show more”的文本一律不合格。只抓到这类材料时，必须阻断并标记 blocked，不能生成正式日报，更不能写入研究工作区。
• 博主观点不能直接覆盖 current-synthesis.md、modules、companies 或 models。
• 每日报告放在 archive，供人查看和审计；agent 默认恢复只读 progressive research 的 active surface。
• X 帖子、YouTube transcript、播客、newsletter、复制片段都先按 source lead 处理，验证后才可能进入模型。

默认流程

1. 确认信息源和 dossier

   • 选择 Serenity、RihardJarc 或新增来源时，读 references/source-registry.md。
   • 如果还没有 dossier，用 scripts/scaffold_creator_dossier.py 创建 progressive research 骨架。
   • 如果 dossier 已存在，先读 context.md、current-synthesis.md、model-map.md、source-leads-index.md、open-questions.md、update-log.md，以及相关 modules/、companies/。

2. 收集更新

   • X/Twitter：优先用 Codex Chrome 插件读取用户已登录 Chrome 中的 X 页面 DOM；不可用时再用 scripts/fetch_x_daily.py 连接用户授权的本地 browser bridge。
   • X/Twitter 抓取后必须通过原文质量门禁：抓取器会尝试点击 显示原文/Show original 和 显示更多/Show more；仍含 UI 翻译或未展开标记的条目会被剔除。若没有合格原文，本轮状态是 blocked，不得交付日报。
   • 如果 live X 抓取失败，可以用 --fixture-jsonl、用户导出或人工复制内容生成“非 live 日报”，但汇报必须标明 collection_status/known_gaps，不能说成无断点验收。
   • YouTube：用 scripts/fetch_youtube_transcript.py 调 yt-dlp 抓字幕/转录。缺 yt-dlp 是 setup failure，不是“没有更新”。
   • 手工输入：可以接收粘贴文本、本地文件、截图或导出材料，但必须标清来源状态。

3. 生成每日报告

   • 主日报用 scripts/build_daily_report.py 生成 archive/creator-daily/<source_id>/<YYYY-MM-DD>.md，必须合并该博主当天所有已抓平台。
   • build 会硬拦截 x-ui-auto-translated、summary-only、original text was not expanded、搜索片段、公开镜像和 raw 文本中的 翻译自/显示原文/显示更多 等标记；遇到这些输入时不生成正式日报。
   • scripts/normalize_intake.py 只作为单平台归一化/调试工具；不能让单平台日报覆盖最终主日报。
   • 日报标准对齐 PaiWork 版：执行摘要、来源与抓取状态、今日变化、materiality 评分、content_type、研究对象/claim、低价值内容、最值得人工查看的链接、下一步研究任务。
   • 日报必须保留：链接、发布时间/抓取时间、主题/公司、重要性、建议动作、中文摘要、raw/transcript 引用。
   • 不默认保存长原文；长 transcript 单独保存并在日报里链接。

4. 决定是否写入研究工作区

   • 写入前读 references/intake-contract.md 和 references/research-bridge.md。
   • 本 Skill 写入的目标工作区默认依赖 progressive-investment-research 标准。若当前环境没有该 Skill、没有兼容 dossier 结构，或 agent 无法读到 current-synthesis.md / model-map.md / modules/ / companies/，必须先提示安装/启用 progressive-investment-research 或创建兼容工作区；不得只生成空白 active files。
   • 每次主日报生成后，必须运行 scripts/route_research_updates.py 自动拆解到工作区。
   • route 只是第一步，不是最终交付。route 后必须按 progressive research 标准完成本轮能做的验证和填充：优先查一手来源或强二手来源，把模块页、公司页、关键关系、瓶颈、事实表、验证状态填到可接续；只有剩余无法验证或会改变模型的问题才进入 open-questions.md。
   • 自动产出必须回答：涉及哪些公司、是什么逻辑、属于什么行业、哪些待验证、哪些可以后续研究。
   • 自动 route 后必须更新 active 恢复面：source-leads-index.md、model-map.md、current-synthesis.md。source-leads-index.md 记录 source lead 路由，不代表模型变化。
   • 公司相关自动写 companies/<slug>.md；SIVE 这类对象不再建单独 tracker。
   • 行业/机制自动写 modules/<axis>.md。
   • modules/ 和 companies/ 不允许交付空壳：不要留下空表、仅写“待验证后补齐”、或只有模板字段。若证据不足，至少写明当前 source lead、已查来源、证据状态、可证伪路径、为什么暂时不能升级。
   • 只有真正需要继续研究或验证后才可能改变模型的内容写 open-questions.md；不要把所有日报条目都塞进 open questions。
   • archive-only 和 noise 不写 active files。
   • 影响核心模型时，必须先形成 model-candidate 或 current-model-update，并保留证据边界。
   • 涉及其他 dossier 时，只写 bridge candidate，不静默修改外部 dossier。

5. 收尾汇报按“每日报告优先”

   • 先给每日报告路径和今天发了什么。
   • 再列研究写入、开放问题、bridge candidate、跳过/噪音、访问失败、验证结果。

依赖和自动化

• 本 Skill 的 active 写入依赖 progressive-investment-research 的 dossier 标准。若环境未安装该 Skill，必须先提示安装，或先创建兼容的 progressive research 工作区。
• 用户可以让 Agent 生成每日自动化任务：每天固定时间抓取已注册来源，生成 archive/creator-daily/<source_id>/<YYYY-MM-DD>.md，再运行 scripts/route_research_updates.py 拆到工作区并做可执行验证。
• 自动化任务必须区分“无有效更新”和“抓取失败/登录失败/权限失败/字幕缺失/UI 自动翻译拦截”，不能把失败写成没有更新。

内置信息源

• serenity：X-first 来源。种子定位：@aleabitoreddit / https://x.com/aleabitoreddit。所有观点先按未验证 source lead 处理。
• rihardjarc：X + newsletter 来源。种子定位：@RihardJarc / https://x.com/RihardJarc，补充来源为 UncoverAlpha。适合 AI infrastructure、cloud CapEx、TPU/GPU economics、hyperscaler ASIC 和半导体供应链 source leads。账号拼写是 RihardJarc，不是 RichardJarc。

内置信息源只是默认配置，不是硬编码流程。实际运行时可以更新 locator。

YouTube 是可选平台能力，不是内置来源的默认平台；只有 source registry 明确注册了该 creator 的 YouTube channel/playlist，或用户本轮显式给出 YouTube 材料，才纳入主日报。

常用命令

创建 Serenity dossier：

python scripts/scaffold_creator_dossier.py D:\research\creator-serenity --source-id serenity --display-name Serenity --platform x --locator https://x.com/aleabitoreddit --handle-or-channel aleabitoreddit

生成每日报告：

python scripts/build_daily_report.py --dossier D:\research\creator-serenity --source-id serenity --display-name Serenity --date 2026-06-08 --x-jsonl D:\research\creator-serenity\archive\creator-raw\x\serenity\2026-06-08.jsonl --collection-manifest D:\research\creator-serenity\archive\creator-raw\x\serenity\2026-06-08-manifest.json

自动拆解写入工作区：

python scripts/route_research_updates.py --dossier D:\research\creator-serenity --source-id serenity --display-name Serenity --date 2026-06-08 --daily-report D:\research\creator-serenity\archive\creator-daily\serenity\2026-06-08.md --x-jsonl D:\research\creator-serenity\archive\creator-raw\x\serenity\2026-06-08.jsonl

验证 Skill：

python scripts/validate_contract.py

参考文件

• references/source-registry.md：内置信息源、新来源接入、来源字段。
• references/intake-contract.md：日报字段、重要性/action 枚举、证据对象映射。
• references/research-bridge.md：写入 progressive research 工作区的门禁。
• references/daily-analysis-prompt.md：每日拆解和写入判断用的中文提示词。