knowhow_raw.md
2.39 KB
内容发布技能 - Hunt 阶段原始调研
技能概述
- 技能名称: content-publisher
- 角色: 内容发布员 (Publisher)
- 核心功能: 将已审核的剧本按固定格式上传至生产端,完成内容生产
业务背景
ABC Inc. 是一家 AI 互动剧公司,业务流程:
- 热点抓取 (trend-hunter)
- 选题筛选 (topic-selector)
- 深度研究 (researcher)
- 剧本整理 (screenwriter)
- COO审核 (coo)
- 内容上传 (publisher) ← 当前阶段
- 数据监控 (data-analyst)
输入数据格式
{
"title": "剧本标题",
"genre": "题材类型",
"scenes": [
{
"sceneId": 1,
"description": "场景描述",
"characters": ["角色1", "角色2"],
"dialogues": [
{"character": "角色1", "line": "台词内容", "emotion": "情绪"}
]
}
],
"metadata": {
"author": "作者",
"createdAt": "创建时间",
"tags": ["标签"]
}
}
生产端 API 分析
典型内容上传 API 模式
REST JSON API (最常见)
- POST /api/v1/content
- Content-Type: application/json
- 认证: Bearer Token
FormData 上传
- POST /api/v1/upload
- Content-Type: multipart/form-data
- 用于包含文件(图片/视频)的内容
GraphQL API
- Mutation: createContent(input: ContentInput!)
- 适合复杂嵌套数据
必需字段
title: 标题content: 内容/剧本正文category: 分类tags: 标签author: 作者status: 状态 (draft/published)
错误处理
- 400: 参数错误
- 401: 认证失败
- 413: 内容过大
- 429: 请求过于频繁
- 500: 服务器错误
重试策略
- 指数退避: 1s → 2s → 4s → 8s
- 最大重试: 3次
- 超时: 30秒
种子数据集 (20条)
测试用例 1: 军事题材
{
"title": "铁血长城",
"genre": "军事",
"scenes": [...],
"metadata": {"tags": ["战争", "英雄"]}
}
测试用例 2: 娱乐八卦
{
"title": "星光闪耀时",
"genre": "娱乐",
"scenes": [...],
"metadata": {"tags": ["明星", "综艺"]}
}
... (共20条)
爬取配置
{
"api_doc_sources": [
"https://platform.openai.com/docs/api-reference",
"https://docs.contentful.com",
"https://developers.wordpress.com/rest-api"
],
"test_format": "json",
"timeout": 30000
}
调研时间: 2026-03-26 调研者: Innovator (Hunt Phase)