/skill-publish-analytics

name: skill-publish-analytics
description: >-
  分析发布日志数据，从发布时间、标签效果、内容类型、粉丝增长四个维度归因内容表现，输出可执行的优化建议。
  当用户说"发布数据分析""归因分析""什么时间发好""标签效果""内容表现分析""发布日志分析"时使用。
  和 skill-social-performance-review 的区别：本 SKILL 从发布日志做四维归因，review 做跨平台月度组合复盘。
layer: attribute

发布数据归因分析

> 读取 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

3. 脚本输出结构化 JSON：`summary`（总数/日期范围/平台/各指标覆盖率/全量样本警告）+ 各模式结果。每个分析桶含 `count` 和 `warning`（单桶 <5 条标注样本不足）。 4. **解读输出**：按下方各模式说明和「输出格式」把 JSON 转成 Markdown 表格 → 关键发现（3 条）→ 方法论 → 局限性。局限性须含"关联性不等于因果性"。

模式 A — 最佳发布时间

**步骤：** 1. 解析 `published_at` 提取小时和星期几 2. 将时段分为 6 个桶：早晨(6-9) / 上午(9-12) / 午间(12-14) / 下午(14-18) / 晚间(18-22) / 深夜(22-6) 3. 交叉 initial_metrics 计算每个桶的平均互动量（views、likes、comments、shares） 4. 按平台分别统计

**输出：**

• 热力图表格（星期 × 时段），单元格为平均互动综合分
• 推荐 Top 3 发布时段（含具体星期和时间段）
• 各平台分别的最佳时段

**互动综合分计算：** `engagement_score = views × 0.1 + likes × 1.0 + comments × 2.0 + shares × 3.0`

模式 B — 标签效果分析

**步骤：** 1. 提取每条记录的 `tags[]`，统计各标签使用频次 2. 对每个标签计算其关联条目的平均 views、likes、comments、shares 3. 构建标签共现矩阵：标签 A 与标签 B 同时出现的次数 4. 识别高效标签（平均互动高于全局均值）和低效标签

**输出：**

• 标签效果排名表：标签 / 使用次数 / 平均浏览 / 平均点赞 / 平均评论 / 平均转发
• Top 5 与 Bottom 5 标签对比
• 标签共现矩阵（仅展示共现 >= 2 次的组合）

模式 C — 内容类型对比

**步骤：** 1. 按 `type` 字段分组（图文 / 视频 / 直播 / 文章） 2. 计算每类的发布数量、平均 views、likes、comments、shares 3. 交叉平台与类型生成二维表

**输出：**

• 类型对比表：类型 / 数量 / 平均浏览 / 平均点赞 / 平均评论 / 平均转发
• 每个指标标注 "winner"（最高值类型）
• 平台 × 类型 交叉表

模式 D — 增长归因

**前置条件：** `outputs/_analytics/follower-log.json`（从 `skill-data-tracker` 快照底座导出的派生视图，schema 与字段映射见 `references/follower-log-schema.md`）

**步骤：** 1. 读取 follower-log.json，若不存在则输出提示并跳过本模式 2. 将每条发布事件与发布后 24h / 48h / 7d 的粉丝变化关联 3. 计算每条发布的粉丝增量（发布后快照 - 发布前最近快照） 4. 按粉丝影响力排名

**输出：**

• 发布事件粉丝影响排名表：标题 / 平台 / 发布时间 / 24h增量 / 48h增量 / 7d增量
• 高增长条目的共性分析（类型、标签、时段）
• 若 follower-log.json 不存在，输出：

> "模式 D 需要粉丝数据。请在 outputs/_analytics/follower-log.json 中记录粉丝快照数据，schema 见 skill-publish-analytics/references/follower-log-schema.md"

输出格式

每个模式的输出均包含以下部分：

## 数据摘要
- 总条目数 / 日期范围 / 涉及平台
- 各指标覆盖率（非 null 比例）

## 分析结果
（模式对应的表格和图表）

## 关键发现
1. （最重要的可执行洞察）
2. （第二重要）
3. （第三重要）

## 方法论
- 互动综合分计算公式
- 聚合方式（均值 / 中位数）
- 时段划分标准

## 局限性
- 样本量说明
- null 数据覆盖率
- "关联性不等于因果性 — 时段/标签分析反映相关关系，不能直接推导因果"

Profile 感知

• **有 Profile**：
• 按 `profile` 字段过滤，只分析当前账号的数据
• 使用 Profile 中的 platform 和 timezone 字段
• 输出标注 "当前分析范围：{profile_name} @ {platform}"
• **无 Profile**：
• 分析全部条目，按平台分组展示
• 报告附注："提供 Profile 可按账号过滤数据并使用平台特定时区"

规则

1. **不捏造数据** — 所有数字必须来自 publish-log.json，不得推测或补全 2. **报告样本量** — 每个分析桶必须标注条目数 3. **关联非因果** — 时段和标签分析中必须注明"关联性不等于因果性" 4. **样本不足警告** — 全量 < 10 条时在报告头部加粗警告 5. **计算透明** — 展示每个指标的计算公式和聚合方式

自研备注

参考产品：Metricool analytics、Iconosquare insights、SocialBee performance reports、Later analytics。 本 SKILL 侧重中文社媒平台（小红书、抖音、B站、微博）的发布节奏与互动规律分析。