skill-publish-analytics

发布数据归因分析

读取 publish-log.json，从时间、标签、类型、增长四个维度分析内容表现，输出结构化归因报告。

数据层定位

本 SKILL 是归因链的消费层，只读底座、不新建存储、不回写：

数据	权威底座	维护方	本 SKILL 用途
发布事件	outputs/_analytics/publish-log.json	skill-publish-log	模式 A/B/C
粉丝 / 时序快照	outputs/_analytics/snapshots/{profile}/{platform}/{date}.json	skill-data-tracker	模式 D 增长归因

粉丝时序的权威来源是 skill-data-tracker 的快照底座。 模式 D 读取的 outputs/_analytics/follower-log.json 由 track.py export-followers 确定性导出，不应手工维护。字段映射见 references/follower-log-schema.md。

输入

用户指定分析模式（可组合）：

• 模式 A — 最佳发布时间：分析发布时段与互动数据的关系
• 模式 B — 标签效果分析：评估标签对内容表现的影响
• 模式 C — 内容类型对比：按内容类型对比各项指标
• 模式 D — 增长归因：关联发布事件与粉丝增长

未指定模式时默认执行 A + B + C。模式 D 前先运行 python3 skills/openclaw/skill-data-tracker/scripts/track.py export-followers。

数据源

publish-log.json 结构

{
  "version": "1.0",
  "entries": [{
    "id": "唯一标识",
    "platform": "xiaohongshu|douyin|bilibili|weibo",
    "title": "标题",
    "url": "发布链接",
    "type": "图文|视频|直播|文章",
    "published_at": "ISO 8601 时间戳",
    "logged_at": "记录时间",
    "initial_metrics": {
      "views": null | number,
      "likes": null | number,
      "comments": null | number,
      "shares": null | number
    },
    "skill_source": "生成该内容的 SKILL",
    "profile": "账号画像名",
    "tags": ["标签列表"],
    "notes": "备注"
  }]
}

数据处理规则

• null 指标：排除出该指标的平均值计算，报告覆盖率百分比
• 样本量警告：单桶 < 5 条时标注 ⚠ 样本不足；全量 < 10 条时在报告头部警告结果可能不具统计意义
• 时区：有 Profile 时使用 Profile 中的时区，无 Profile 时默认 Asia/Shanghai

执行步骤

四种分析模式的全部计算（时段分桶、标签聚合、类型对比、增长归因、样本量警告、 覆盖率）由 scripts/analyze.py 确定性完成。不要用内联 Python 心算，直接调脚本。 LLM 只负责选模式、按 Profile 过滤、解读 JSON、写关键发现/方法论/局限性。

1. 检查 Profile 上下文（=== EASEL ACCOUNT PROFILE === 标记），有则取 profile 名。
2. 调用脚本（--profile 须放在子命令前；publish-log.json 不存在时脚本友好报错）：

python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py all
python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py --profile 画像名 time
python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py --profile 画像名 tags
python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py --profile 画像名 types
python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py --profile 画像名 growth