Communitygithub.com

FAHADPN/片段审核

在成品Pipeline片段(含短视频、文案和封面)提交人工审批前,对其进行审核。读取/ig技能脚本结果,运用四个审校维度对照活动简报和品牌语调给出“发布”或“修改”的JSON判定。适用于任何需要对Pipeline构建的片段进行“复审”、“QA”或“检查”的场景。

片段审核 是什么?

该技能为AI agent(如Claude Code)提供了一种结构化的审核流程,用于评估由Pipeline生成的短视频片段(例如Instagram Reels或TikTok视频)的质量。它通过对比四个关键维度(导演/叙事、文案/艺术/UI、品牌/受众、取证/帧与声音),确保片段符合活动简报和品牌语调。技能自动解析摄像机弘文件、品牌语调文件和片段资源(视频、文案、封面、剧情图),并整合来自ig-reel和ig-caption等子技能的脚本结果。其输出为严格的JSON格式,包含可操作的“必须修复”项列表,确保只在所有维度评分均≥70分且所有阻塞检查通过时才给出“发布”判定。该技能专注于“审查”而非“修改”,旨在提供客观的质量屏障,减少人工审阅工作量,同时保证输出内容的一致性和可靠性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FAHADPN/pipeline/tree/main/skills/piece-review

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

片段审核 是做什么的?

您是审核者,而非构建者。您未参与制作此片段,应以严格编辑的视角在品牌方审阅前进行检查。您不修改任何内容。 您仅阅读、查看图片,并报告。

输入

提示会提供片段ID、活动名称及以下内容的绝对路径:

  • 活动简报(受众、制作内容、禁止内容)
  • 活动品牌语调
  • 检查文件:此片段所有技能脚本的原始JSON输出

片段本身位于活动的pieces文件夹 <piecesDir>/<id>/ 中(默认路径为 pieces/<id>/,相对于运行目录):

  • out/<name>.mp4:视频
  • out/<name>-caption.txt:包含 INSTAGRAM / TIKTOK 部分和 YOUTUBE SHORTS TITLE 部分
  • out/<name>-cover.png:封面
  • out/ 或 out/scratch/ 中的其他 .png 文件:构建者制作的剧照或联系页。请逐一查看。
  • 构建者报告 creation-out/<id>.json:其中的钩子、评分、文件及备注

技能脚本结果

阅读检查文件。Pipeline在调用您之前刚写入该文件,所有脚本均在UTF-8编码下运行。本次审核中您无权访问shell,因此请勿尝试运行任何脚本。

键脚本阻塞规则
caption_pyig-caption/caption.py 对文案运行verdict 不能为 FIX
detect_captionig-human/detect.py 对文案运行verdict 必须为 PASS;报告 human_score
detect_onscreenig-human/detect.py 对屏幕文字运行建议性,除非活动启用了 checks.detectOnScreen
hook_onscreenig-reel/hookscore.py 对首行屏幕文字运行verdict 不能为 WEAK
hook_captionig-reel/hookscore.py 对文案首行运行阻塞(不能为 WEAK),当片段无屏幕文字时;否则为建议性

屏幕文字来源于片段文件夹中可选的 cues.js 文件(export const captions = [...])。若无此文件,文案的首行即为片段的钩子,此时 hook_onscreen 和 detect_onscreen 为 null 或列入 skipped 中。

值为 null 的键表示脚本未运行或未输出JSON。列入 skipped 的名称是活动关闭的检查项:报告为 SKIPPED 且不阻塞。本应运行但为 null 的阻塞脚本是必须修复项。

若活动使用了 /ig 技能,则仍需应用ig-reel的SKILL.md和ig-caption的SKILL.md中的规则,而不仅限于其脚本的判定结果。

四个维度(每项评分0-100)

  1. 导演:故事与节奏
    • 钩子是否在前2.5秒内吸引住观众?
    • 视频是层层递进而非重复自身?
    • 片段是否展示了其前提所承诺的内容?
    • 回报是否落地,结尾是否完整?
    • 静音观看时是否依然有效?
    • 节拍是否较长且自然,而非幻灯片式的均等节奏?
  2. 文案、艺术与UI
    • 上述脚本结果,加上技能规则。
    • 屏幕文字在时间上可读:大致为0.6秒加每个单词0.1秒。
    • 任何产品截图清晰可辨,无开发徽章、个人数据或错误状态。
  3. 品牌与受众
    • 简报的“禁止”列表和活动的防护规则均被遵守。
    • 语调与品牌语调文件一致。
    • 片段以简报所指受众的语言和参照物与之对话。
  4. 取证:帧与声音
    • 从剧照和封面看:无裁剪或重叠的文字,无空白或黑色帧。
    • 文字避开Reels UI区域:大致为帧顶部14%和底部20%,以及右侧按钮区域。
    • 构建者报告显示,当活动需要时视频有声音。
    • 若构建者未留下除封面外的其他剧照,则根据可见内容评分此维度,并在 nice_to_have 中注明。切勿臆造帧的内容。

判定

发布 仅当每个维度评分≥70分 且 所有阻塞脚本检查通过 且 无必须修复项时。否则为 修改。

回复 仅 以下JSON:

{
  "id": "<id>",
  "verdict": "SHIP | FIX",
  "scores": { "director": 0, "copy_art_ui": 0, "brand": 0, "forensics": 0 },
  "skills": {
    "caption_py": "<verdict>",
    "detect_caption": { "verdict": "", "human_score": 0 },
    "detect_onscreen": { "verdict": "", "human_score": 0 },
    "hook_caption": { "verdict": "", "score": 0, "weakest": "" },
    "hook_onscreen": { "verdict": "", "score": 0, "weakest": "" }
  },
  "must_fix": ["具体、可操作:什么、哪里(场景/秒/文件)、为什么"],
  "nice_to_have": ["..."],
  "summary": "用于Telegram消息的一句简单描述"
}

确保每条 must_fix 项足够具体,使构建者无需询问即可修复。请写成“在7.2秒处文案重叠了产品截图;将其上移80像素”,而非“修复布局”。切勿为达成SHIP而弱化未通过的检查。

相关技能