一周一题HOW
制作说明 · HOW IT'S MADE

这些题是怎么做出来的

每周六上线一题,背后是一条固定的流水线:周五晚上一个定时任务从选题池取题,派四路研究员各自出底稿,构建成单页,另派一个核查员逐条对年代、数字、引文,再把预览和争议点发给我。我看过回一句「发」,才合并上线。到目前为止已经跑了 9 周、9 题。

Every page on this site comes out of a weekly, agent-assisted pipeline: pick a topic, fan out research to four workers with a shared brief, build a self-contained page, verify every number against its source, preview, then publish only after a human says go. This page explains the pipeline, the rules the workers follow, and where the humans are.

每周流水线

周五取题 · 周六上线
  1. 选题 定时任务读 queue.md「待做」第一条;当周有指定就用指定的。决定格式:图谱 / 一图流 / 小工具 / 图文。
  2. 写研究简报 主代理一份所有研究员共用的简报:页面长什么样、共用 JSON 结构、每路的搜索预算、全页共用常数、哪些站点打不开别反复试。
  3. 四路研究 子代理 ×4按地域或主题分路,各自联网检索、把事实写进 src/research/*.json。每个数字、年份、人名都带来源和置信度;口径不一的写进 dispute,不下结论。
  4. 构建 主代理按 src/DESIGN.md 的风格简报(主轴量、唯一强调色、字体固定)写 build_theme.py,从研究 JSON 生成自包含的 index.html;生成 1200×630 封面;跑 build.py 确认站点构建通过。
  5. 核查 子代理 ×1一个没参与写作的代理逐条核对年代、数字、引文;桌面 / 手机 / 深色各截图检查布局;修正后更新 meta.json 的 sources。
  6. 预览 定时任务推到 draft/<slug> 分支,Cloudflare Pages 自动给预览地址;把预览链接、一句话摘要、核查中发现的争议点发给我,然后等待。
  7. 发布 我看过回一句「发」才合并到 main。有修改意见就改完再发预览。选题池里的条目移到「已完成」。

研究员的铁律

摘自第 6 题的共用简报

哪些是 AI 做的,哪些是人决定的

Claude 做

  • 检索、读原典、整理事实到 JSON
  • 按简报写正文、画图、写交互
  • 生成封面、跑构建、截图检查布局
  • 独立核查,列出争议点和没核到的项

我决定

  • 选什么题、用什么格式、主轴量是什么
  • 研究简报里的铁律和共用常数
  • 风格简报:唯一强调色、字体、像年历不像仪表盘
  • 看预览、读争议点,说「发」或「改」

每一题的出处都列在页面卷末和 meta.json 的 sources 里;研究底稿、工作日志和风格简报随每一题存档在站点仓库的 themes/<date>-<slug>/src/ 下(仓库不公开)。错漏之处欢迎指正。

一题的文件

仓库约定
themes/<YYYY-MM-DD>-<slug>/
  index.html        自包含单页(内联 CSS/JS,lang=zh-CN,含 OG)
  meta.json         {no, slug, title, date, summary, tags[], format, reading_time, sources[]}
  cover.png         1200×630 封面 / 分享图
  src/
    research/       BRIEF.md 共用简报 · A/B/C/D.json 四路底稿
    DESIGN.md       风格简报:主轴量、配色、字体、情绪
    WORKLOG.md      工作日志:谁在何时做了什么、怎么重建
    build_theme.py  从研究 JSON 生成 index.html
    template.html · app.js · figs.py · demos.js …