Content Calibrator — 内容校准预测循环

三条不可妥协原则：

1. 盲预测：预测必须在看到实际数据之前写完，写完即 immutable
2. 升级 = 全量重打：rubric 升级时校准池所有样本必须重打分
3. rubric 是工作台不是博物馆：被推翻/吸收的观察删掉，git history 是档案

核心设计：per-work 归集 + 统一 rubric

一个作品 = 一个打分 + 一个预测 + 一个复盘。 作品的内在内容质量与发布平台无关，故打分/预测/复盘按作品归集，rubric 全平台统一，放行阈值也全局统一（质量门是作品本身的事，不分平台）。平台差异（baseline 量级、受众、对标账号）仅作为预测的输入数据按平台保留。

<work> 即作品目录：文章为 output_articles/<article-english-title>/，视频为 output_videos/<topic-en-slug>/。

核心闭环

📊 打分+盲预测 → 🚀 发布 → 📝 记录(1B) → 📈 T+3d 复盘(per-work) → 🧬 进化 rubric

打分与盲预测在同一次 blind sub-agent 调用内完成（合并理由：subagent 已读稿件、已出分值，顺手出预测；且合并后 Predict 不再是可被跳过的独立软步骤，闭环天然不断）。

与 published-track 的集成

发布流程为 打分+预测(1A) → 发布 → 记录(1B)。打分+预测（1A）由本技能负责，发布记录（1B）由 published-track 负责。

流程 1A·打分+盲预测（发布前自检）

发布前对稿件做盲打分 + 盲预测 + 阈值门，避免主 agent 自创自评。

1. 主 agent sessions_spawn 一个 blind sub-agent，只喂 script_path（稿件/视频定稿）+ calibration/rubric_notes.md。sub-agent 硬禁读 .cheat-state.json/各 work 的 calibration//rubric-memo.md/audience.md/benchmark.md/对话历史，输出严格 JSON：
   • 7 维分（ER/HP/SR/QL/NA/AB/PV，各 0-5）+ per-dim confidence
   • 盲预测草稿：cold-start 期（前 5 个作品）= 一句话 bet；过 cold-start = 每目标平台的 bucket + 概率分布 + 中枢 + 反事实场景 + 关键校准假设
2. 主 agent 拿分调 score-only.sh 校验 + 算 composite + 判阈值门：

   ./skills/content-calibrator/scripts/score-only.sh \
     --content-path "output_articles/xxx/article.md" \
     --cal-er 3 --cal-hp 4 --cal-sr 3 --cal-ql 4 --cal-na 3 --cal-ab 4 --cal-pv 2

   返回 JSON 含 passed 与 failing_dims。阈值取自根级 calibration/.cheat-state.json 的 score_threshold（全局，默认 0=不拦截），每维需 > 阈值才算通过。--platform 可选，仅用于校验该平台是否启用 calibration。
3. 主 agent 调 commit-prediction.sh 把 score + 预测落盘到 <work>/calibration/：

   ./skills/content-calibrator/scripts/commit-prediction.sh \
     --work-dir "output_articles/xxx" --platform wx_mp \
     --cal-er 3 --cal-hp 4 --cal-sr 3 --cal-ql 4 --cal-na 3 --cal-ab 4 --cal-pv 2 \
     --prediction-file /tmp/prediction-draft.md

   写 score.json + prediction.md。同 work 重复打分直接覆盖（用户有意见/未过阈值 → 改稿重打，新结果覆盖旧的）。
4. 阈值门：passed=false → 主 agent 据 failing_dims 改稿 → 重新 spawn blind sub-agent 打分+预测 → 再判门。最多 2 轮，仍不达标 → 暂停发布、上报用户裁定。
5. passed=true → 放行，进入发布技能。
6. 平台未启用 calibration（calibration/<platform>/.platform-state.json 不存在或 enabled=false）→ 跳过 1A，直接发布。

视频内容：打分+预测对象是脚本定稿（storyboard/口播稿），不是成片。视频技能流程 = 打分+预测(定稿) → 制作 → 发布 → 记录。成片后不再打分。

多平台发布：作品一次打分+预测，预测文件内含每个目标平台的 bucket/中枢（各平台 baseline 不同）。打分维度分只有一组。发布到 N 个平台 → record.sh 调 N 次，每次同一 --source-folder（指向 <work>），record.sh 自动从同一份 score.json 读分。

流程 1B·发布记录（由 published-track 承接）

打分通过并发布成功后，由 published-track/scripts/record.sh 落库。record.sh 直接从 <work>/calibration/score.json 读分（不再传 --cal-* 入参）：默认要求 score.json + prediction.md 齐全否则报错（拦截漏跑 1A）；--no-cal 显式跳过（补发/不打分）。详见 published-track/SKILL.md。

平台打分开关 + 全局阈值

content-calibrator/scripts/cal-toggle.sh：

• 平台开关：--platform <p> --enable/--disable/--status（per-platform）
• 全局阈值：--threshold（查看）/ --set-threshold N（设置，每维 0-5，需 >N 才放行；0=不拦截）/ --list（总览）

数据采集由 published-track 统一管理

content-calibrator 不直接抓取平台数据, 详见 published-track。

路由表（触发词 → 操作）

Predict 不再是独立路由项——它已合并进"打分"。如需单独重跑预测，用"打分这篇"即可（会覆盖 prediction.md）。

平台启用控制

是否启用某个平台的 calibration，必须由用户决定。 Agent 不得自动启用。

• 启用：./skills/content-calibrator/scripts/cal-toggle.sh --platform <platform> --enable
• 停用：./skills/content-calibrator/scripts/cal-toggle.sh --platform <platform> --disable
• 查看状态：./skills/content-calibrator/scripts/cal-toggle.sh --list

Agent 在复盘或发布时，发现对应平台未启用 calibration，不得自动启用，应告知用户"该平台未启用 content-calibrator，如需启用请确认"。

--platform 为必填参数（Init 除外）。支持的平台 ID：

文件结构

<workspace>/
├── calibration/                     # 校准系统根目录
│   ├── rubric_notes.md              # 统一评分公式（blind sub-agent 可读）
│   ├── rubric-memo.md               # 统一观察记录（blind 不可读）
│   ├── .cheat-state.json            # 统一 rubric 循环状态（mode/samples/bump/score_threshold）
│   ├── wx_mp/                       # 平台专属*数据*（无 rubric、无 predictions、无 threshold）
│   │   ├── .platform-state.json     # baseline / enabled / content_form
│   │   ├── audience.md              # 受众画像
│   │   └── benchmark.md             # 对标账号
│   └── xhs/ ...
├── output_articles/<work>/
│   └── calibration/
│       ├── score.json               # 7 维 + composite + rubric_version + 时间戳（重打覆盖）
│       ├── prediction.md            # 盲预测（发布前重打覆盖；发布后 immutable）
│       └── retro.md                 # T+3d 写一次，多平台分析内含（immutable）
└── output_videos/<work>/
    └── calibration/                 # 同上

Init — 初始化

为指定平台创建 calibration/<platform>/ 目录和平台数据文件。首次初始化时同时创建根级统一 rubric（若不存在）。

两种触发方式：

• 用户主动：用户说"初始化校准"或"我要做 XX 平台" → 交互式问答
• Agent 不得自主初始化：必须用户明确要求

用户主动触发流程

1. 询问或从 --platform 参数获取平台 ID
2. 若 calibration/rubric_notes.md 不存在 → 创建根级统一 rubric（v0）+ .cheat-state.json（cold-start）+ rubric-memo.md
3. 创建 calibration/<platform>/ + .platform-state.json + audience.md + benchmark.md
4. 询问用户：内容形态、典型篇幅、发布频率、对标账号（可选）、该平台 baseline
5. 如有对标账号 → 触发 LearnFrom

./skills/content-calibrator/scripts/init.sh --platform <platform_id>

幂等——已存在则跳过。

Score+Predict — 打分+盲预测（合并）

给单篇稿子打 rubric 分 + 出盲预测，在发布前作为自检门（流程见上方"流程 1A"）。脚本不做 LLM 打分/预测；打分+预测由主 agent sessions_spawn 的 blind sub-agent 一次完成，脚本只做算术、门禁、落盘。

blind sub-agent 隔离规则（主对话已看过用户对话/实绩/复盘历史，inline 打分会污染，故必须 delegate）：

• 白名单只读：稿件（script.md/article.md/post.md）+ calibration/rubric_notes.md
• rubric 路径：统一 rubric 只在根级 calibration/rubric_notes.md。calibration/<platform>/ 下没有独立 rubric，只有 audience.md/benchmark.md/.platform-state.json（平台目录里的 rubric_notes.md 是指向根级的软链，读它等于读根级）。主 agent spawn 时应把根级 rubric 路径或内容显式喂给 subagent，不要让 subagent 自己去平台目录找。
• 硬禁读：rubric-memo.md、.cheat-state.json、各 <work>/calibration/、audience.md、benchmark.md、对话历史
• 输出：严格 JSON = 7 维分（各 0-5）+ per-dim confidence + 盲预测草稿
• 校准池重打分强制 blind sub-agent，不接受 fallback

盲预测的"盲"与落盘分工

• blind subagent 产盲预测本体（bucket/probability/counterfactual/assumptions，或 cold-start 一句话 bet）——它没看 actuals/history/audience，预测是真正的"事前赌"
• 主 agent/脚本在落盘时追加锚点注释（找历史相近 composite 的实绩作参考）——这是派生注释，不污染盲预测本体
• 落盘后 prediction.md 的预测段 immutable（发布后不得覆盖；发布前重打可覆盖）

Cold-start 简化

前 5 个作品不要求完整 bucket 数字，只给 7 维分 + 一句话 bet。第 5 个作品复盘后解锁完整预测。计数在 calibration/.cheat-state.json 的 calibration_samples（全局）。

当前默认 rubric（v0）

7 个维度，每维 0-5 整数分：

composite = (ER×1.5 + HP×1.5 + SR×1.5 + QL + NA + AB + PV) / 8.5 × 2.0

Retro — 复盘（per-work）

T+N 天后从 published-track DB 读实际数据 → 对比预测 → 提炼观察。一个作品一个复盘文件 <work>/calibration/retro.md，内含该作品在各平台的实绩对比与假设验证。

两个入口

入口 1：凌晨 HEARTBEAT 自动复盘

心跳巡检时：

• 从 published-track DB 查所有 cal_enabled=1 且过 T+3d 窗口的记录
• 按 source_folder（work）聚合 → 找出 <work>/calibration/retro.md 不存在的 work
• 如积累 ≥5 个新数据点（有实际互动数据但尚未复盘的 work）→ 自动执行复盘流程

入口 2：用户导入对标

用户主动提供对标账号/爆款内容数据，触发 LearnFrom。这是校准 rubric 本身的入口——通过分析对标内容，提炼高流量内容的 pattern，调整 rubric 维度和权重。

复盘的本质：复盘是"拿实际数据验证预测，提炼观察，可能触发 rubric 升级"。导入对标是"从外部信号校准 rubric 的初始假设"。两者互补：复盘是内源校准，对标是外源校准。

数据来源（全部从 published-track DB）

复盘时只从 published-track DB 读取数据，不另行抓取：

# 读取某 work 在各平台的记录（按 source_folder 聚合）
./skills/published-track/scripts/query.sh --platform wx_mp --limit 10

# 或直接 SQL
sqlite3 db/published_track.db "SELECT * FROM pub_wx_mp WHERE source_folder='output_articles/xxx'"

复盘流程

1. 校验时间窗口（默认 T+3d）
2. 读 <work>/calibration/prediction.md（盲预测）
3. 从 published-track DB 读该 work 在各平台的互动数据
4. 写 <work>/calibration/retro.md：写实绩段（多平台）+ top 评论关键词聚类（如有）+ 验证/推翻预测各假设
5. 提炼新观察 → 写入统一 calibration/rubric-memo.md
6. 更新 calibration/.cheat-state.json 的 calibration_samples
7. 检测是否触发 bump（≥3 次同向偏差）

阈值推荐（复盘副产物）

复盘积累数据后，Agent 可评估全局 score_threshold 是否合理：观察各维度分与实际互动的相关性，若某维度低分内容普遍表现差，可建议提高阈值。Agent 不得自动改阈值，需向用户给出建议值与依据，经用户确认后执行：

./skills/content-calibrator/scripts/cal-toggle.sh --set-threshold <N>

起步期阈值默认 0（不拦截），待累积足够复盘样本后再收紧。

Bump — Rubric 升级（统一）

系统性偏差信号 → 校准池全量重打 → 排序一致性校验 → 落地新公式。影响全局 rubric（统一 rubric，一次升级对所有平台生效）。

流程

1. 前置门槛检查（校准池样本数 + 观察强度）
2. 写出新公式完整方程
3. 校准池全量重打分（blind sub-agent 隔离）
4. 计算排序一致性（新公式排序 vs 实际排序，阈值 4/5）
5. 落地 + cleanup pass（删被推翻/吸收的观察）
6. 更新所有校准样本的 Re-scored 标记
7. 更新 calibration/rubric_notes.md 版本速查 + calibration/.cheat-state.json 的 rubric_version/last_bump_at

维度与权重变更规则

维度和权重可以被修改，但必须满足以下条件之一：

1. 用户主动要求 — "加个 XX 维度" / "把 SR 权重调到 2.0"
2. Agent 提议 + 用户确认 — Agent 在 Bump 流程中检测到系统性偏差后提议变更，必须等待用户明确同意才生效

变更流程：

• 变更维度（增/删/替换）→ 走 Bump 全量重打 + 排序一致性校验
• 变更权重 → 走 Bump 流程
• 变更被拒绝 → rubric 不动，观察记入 rubric-memo.md

LearnFrom — 导入对标

从对标账号/爆款内容中提取 pattern，作为 rubric 初始校准信号。对标数据按平台存 calibration/<platform>/benchmark.md，提炼的 rubric 信号进统一 rubric-memo.md。

数据来源

1. viral-chaser 追爆报告：已下载的爆款视频分析 → 提取结构 pattern
2. 用户提供的数据：手动粘贴对标账号数据
3. published-track DB 中的历史数据：该平台已发布内容的互动数据

流程

1. 确认对标来源（viral-chaser 报告 / 用户提供数据 / 历史数据）
2. 分析 pattern：哪些维度在高流量内容中一致偏高/偏低
3. 派生 rubric 信号（调整权重/维度）
4. 写入 calibration/<platform>/benchmark.md + 更新统一 rubric-memo.md

Status — 校准状态看板

显示校准循环状态：

📊 Content Calibrator 状态

【全局 rubric】
Rubric: v0（统一）
模式: cold-start
校准池: 0 个作品
待复盘: 0 个作品

【全局阈值】每维需 >0 才放行（cal-toggle.sh --set-threshold N 修改）

【平台】
wx_mp  ✅ 已启用  baseline: 未定
xhs    ✅ 已启用  baseline: 未定

【最近复盘】
（暂无）

脚本

打分结果校验（不写入数据库）

Agent 按 rubric 打完 7 维分后，用 score-only.sh 校验分数合法性、计算 composite 并输出结构化 JSON，不写入 DB。此脚本不做 LLM 打分，仅校验并格式化。

./skills/content-calibrator/scripts/score-only.sh \
  --platform wx_mp \
  --content-path "output_articles/xxx/article.md" \
  --cal-er 3 --cal-hp 4 --cal-sr 4 --cal-ql 3 --cal-na 2 --cal-ab 4 --cal-pv 3

落盘打分+预测到 work 目录

blind subagent 出分 + 预测草稿后，主 agent 调 commit-prediction.sh 落盘。同 work 重复调用直接覆盖 score.json + prediction.md。

./skills/content-calibrator/scripts/commit-prediction.sh \
  --work-dir "output_articles/xxx" --platform wx_mp \
  --cal-er 3 --cal-hp 4 --cal-sr 4 --cal-ql 3 --cal-na 2 --cal-ab 4 --cal-pv 3 \
  --prediction-file /tmp/prediction-draft.md

平台打分开关管理

./skills/content-calibrator/scripts/cal-toggle.sh --list
./skills/content-calibrator/scripts/cal-toggle.sh --platform wx_mp --enable
./skills/content-calibrator/scripts/cal-toggle.sh --platform wx_mp --disable

初始化平台

./skills/content-calibrator/scripts/init.sh --platform <platform_id>

幂等——已存在则跳过。首次调用同时创建根级统一 rubric。

查询 published-track 数据

./skills/content-calibrator/scripts/query-metrics.sh --platform <platform> --source-folder <folder>

构建校准池

./skills/content-calibrator/scripts/build-calibration-pool.sh

从 published-track DB + 各 work 的 calibration/score.json 构建全局校准池（per-work 归集）。

导入追爆报告

./skills/content-calibrator/scripts/import-viral-chaser.sh --platform <platform> <report-path>