# Content Calibrator

DNA 表现评估引擎, , 消费 published-track 的发布与互动数据，按量触发 DNA...

- Repository: https://github.com/TeamWiseFlow/xiaobei (8678 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TeamWiseFlow/xiaobei --skill content-calibrator -g -a claude-code -y`
Codex: `npx skills add TeamWiseFlow/xiaobei --skill content-calibrator -g -a codex -y`
Cursor: `npx skills add TeamWiseFlow/xiaobei --skill content-calibrator -g -a cursor -y`
Gemini CLI: `npx skills add TeamWiseFlow/xiaobei --skill content-calibrator -g -a gemini-cli -y`

## Description

DNA 表现评估引擎, , 消费 published-track 的发布与互动数据，按量触发 DNA 评估，产出报告与优化建议，经用户确认后回写。用户开启、调整或停用定时取数复盘时，提供参考并派 IT engineer 管理原生 Automation。发布与指标记录由 published-track 管理，平台取数由各专家包 engagement 工具负责。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Content Calibrator, DNA 表现评估引擎

> **四条评估铁律**：
> 1. **趋势优先**：绝对值只作上下文。数据好坏看「同账号相对值 + 其走向」, , 新号数据天然低、老号天然高，同 DNA 跨账号不可直接比绝对值，要的是趋势
> 2. **脚本只给证据**：聚合、基线、比值、走向由 `content-calibrator eval` 计算；好坏归因由 Agent 回读 DNA 文档与作品原文完成，脚本不下结论
> 3. **先排混杂再归因**：账号成熟度、粉丝自然增长、选题热度、季节性流量都会污染信号；排除不了的混杂，结论降级写「观察」不写「结论」
> 4. **DNA 更新必须用户逐条确认**：评估只产出建议，Agent 不得自动改 DNA

---

## 职责边界（与 review / published-track 的分工）

| 角色 | 回答什么 | 产出 |
|------|---------|------|
| `published-track` | 数据在哪 | 发布记录 + 互动指标存储；各平台专家包 engagement 工具取数后回填 |
| **本技能** | **这个 DNA 好不好、该怎么改**（共性引擎） | 触发规则、基线归一化与趋势证据、评估报告结构；`<platform>/dna/<dna-id>/evals/*.eval.md` |
| 各平台专家包 `review` workflow | 该平台的数据复盘怎么做（平台特性） | 平台归因方法（指标语义、映射、混杂因素）+ 复盘编排；heartbeat 与用户临时发起的该平台复盘都走它 |

本技能只给**共性归因步骤与原则**，不含任何平台特有归因方法，平台归因方法一律由该平台专家包 review workflow 提供。本技能的结论**必须落到 DNA 动作**（保持 / 调整某维度规则 / 调整 template 某部分），经用户逐条确认后走对应平台的 style-dna workflow 更新。

---

## 核心闭环

```
📥 专家包 engagement 取数并回填 published-track → 📊 阈值检查(--check) → 🧬 DNA 评估(聚合+归因) → 📝 评估报告 → 👤 用户逐条确认 → 🔁 专家包 style-dna 更新 DNA
```

### 触发机制：数据采集每天跑，评估按量触发

- **定时取数**：用户启用后由独立 Automation 按约定频率调用各平台专家包 engagement 工具，回填 published-track；默认不创建每日任务。
- **按量**：每个（平台, DNA）的**成熟待评估记录**累积 **≥5 条**时评估一轮。成熟 = 发布 ≥3 天（数据稳定）；待评估 = `perf_evaluated=0` 且 `dna_id` 非空。一轮评估覆盖该 DNA 全部待评估记录（可多于 5 条）。
- **手动兜底**：低频 DNA 凑不满 5 条时，用户说「复盘一下这个 DNA」→ `--force` 强制评估。
- `dna_id=NULL`（历史补录/未归属）不参与 DNA 评估。

### 归因：共性步骤与原则

**原则**：

1. **归因方法平台特有，本技能不定义**：指标语义、互动路径（漏斗/完播/其他）、到 DNA 维度的映射、平台混杂因素清单，全部由该平台专家包 review workflow 提供。本技能只做平台无关的事：触发、聚合、归一化、趋势、报告结构。
2. **判定看相对值与走向**：绝对值只作上下文；`baseline_insufficient` 的记录只作绝对观察，不参与趋势结论。
3. **先排混杂再归因**：账号成熟度、粉丝自然增长、平台流量波动、选题热度、季节性等 DNA 之外能影响数据的因素，排除不了的，结论降级写「观察」不写「结论」。

**共性步骤**：

The rest: https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/main/skills/content-calibrator/SKILL.md