report-generator

Files (2)

• SKILL.md
• generate_report.py · scripts/

SKILL.md (first lines)

# 视频分析报告生成 (Report Generator)

## 概述

视频分析报告生成技能将分镜拆解数据和（可选的）钩子分析结果整合为一份专业的 Markdown 格式分析报告。报告包含视频基本信息、前三秒钩子评分、分镜概览表格、BGM 分析、场景分析和平台推荐等章节。

## 适用场景

1. **视频分析交付**：为客户或团队生成完整的视频分析文档
2. **创意复盘**：生成结构化的视频内容复盘报告
3. **竞品报告**：批量生成竞品视频分析报告

## 使用步骤

### 完整报告（分镜 + 钩子分析）

```bash
# 1. 准备分镜拆解数据和钩子分析数据（JSON 文件）
# 2. 生成报告
python scripts/generate_report.py breakdown.json hook_analysis.json

# 3. 保存到文件
python scripts/generate_report.py breakdown.json hook_analysis.json > report.md
```

### 仅分镜报告（无钩子分析）

```bash
python scripts/generate_report.py breakdown.json
```

## 报告结构

生成的报告包含以下章节：

```markdown
# 视频分析报告

## 基本信息
- 视频时长、分镜数量、分辨率

## 前三秒钩子分析（核心）
- 综合评分
- 5维度评分表格
- 钩子类型
- 优势/不足/优化建议
- 留存预测

## 分镜概览
- 前10个分镜的概览表格

## BGM 分析
- 音乐风格、情绪基调、节拍

## 场景分析
- 主要场景、视频风格、目标受众
- 平台推荐

报告生成时间
```

## 输入格式

### breakdown.json（必需）

```json
{
  "duration": 30.5,
  "segment_count": 12,
  "resolution": "1920x1080",
  "segments": [...],
  "bgm_analysis": {
    "music_style": {"primary": "流行"},
    "emotion": {"primary": "欢快"},
    "tempo": {"bpm_estimate": 120, "pace": "中速"}
  },
  "scene_analysis": {
    "primary_scene": "室内",
    "video_style": {"overall": "生活方式", "target_audience": ["年轻人"]},
    "platform_recommendations": [...]
  }
}
```

### hook_analysis.json（可选）

```json
{
  "overall_score": 7.5,
  "visual_impact": 8.0,
  "visual_comment": "评价...",
  "language_hook": 7.0,
  "language_comment": "评价...",
  "emotion_trigger": 7.5,
  "emotion_comment": "评价...",
  "information_density": 7.0,
  "info_comment": "评价...",
  "rhythm_control": 8.0,
  "rhythm_comment": "评价...",
  "hook_type": "好奇型",
  "strengths": ["优点1", "优点2"],
  "weaknesses": ["不足1"],
  "suggestions": ["建议1", "建议2"],
  "retention_prediction": "中：50-70%，因为..."
}
```

## 输出格式

Markdown 格式的完整报告文本，直接输出到 stdout。

## 示例

```bash
# 完整流程
python ../video-breakdown-skill/scripts/process_video.py "https://example.com/video.mp4" > breakdown.json
cat breakdown.json | python ../hook-analyzer-skill/scripts/analyze_hook_segments.py - > hooks.json
# (hooks.json 需经 LLM 评分后得到 hook_analysis.json)
python scripts/generate_report.py breakdown.json hook_analysis.json > report.md

From bytedance/agentkit-samples, Apache-2.0.

More from bytedance/agentkit-samples