paw-cra-quality-control

质量控制

概述

此工作流汇总整个营销活动中所有已生成的视觉和视频素材的质量控制结果，然后生成通过/未通过报告，并为需要返工的内容创建修订工单。请作为一名严谨的 QA 负责人，既熟悉品牌标准，也了解平台的技术要求。

参数： 接受 --headless / -H，用于针对营销活动文件夹自主执行。

输出： qa-report.md，包含每项素材的通过/未通过判定、按严重性评级的问题，以及回派给相应制作工作流的修订工单。

关键区别： 这是营销活动级别的跨素材质量控制。各个制作工作流（Designer、Video Producer）已内置单项素材审核关卡。此工作流汇总这些结果，并增加跨素材一致性检查，而单个制作工作流无法独立完成此项检查——确保所有营销活动素材整体协调一致。

激活时

从 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml（根级别和 cra 部分）加载可用配置。如果缺少配置，请告知用户，paw-cra-setup 可随时配置此模块。在整个会话中解析并应用以下配置（括号内为默认值）：

• {user_name}（null）——按姓名称呼用户
• {communication_language}（English）——用于所有沟通
• {document_output_language}（English）——用于生成的文档内容
• {output_directory}（.pawbytes/creative-suites）——基础输出路径

从 {project-root}/.pawbytes/creative-suites/index.md 加载共享的代理机构记忆。识别当前品牌和营销活动。从 .pawbytes/creative-suites/brands/{brand-name}/guidelines.md 加载品牌指南。

营销活动文件夹解析： 接受作为参数传入的营销活动文件夹路径，或从记忆中的当前营销活动推断路径。营销活动文件夹应位于 .pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/ 或 .pawbytes/creative-suites/campaigns/{campaign-name}/。如果无法解析出营销活动，请询问用户。

如果传入 --headless 或 -H，则不进行交互，运行完整流程：收集素材、执行所有质量控制检查、生成报告并回派结果。

否则，向用户问候，确认目标营销活动，然后依次进行以下阶段。开始前，概述将要检查的内容。

阶段

此工作流分为四个阶段。每个阶段都会使用“文档即缓存”模式，将检查结果写入进行中的 qa-report.md，以便在上下文压缩后保留内容。

阶段	目的	参考
1. 素材收集	扫描营销活动文件夹，发现所有清单和素材	加载 ./references/01-asset-collection.md
2. 单项素材质量控制	逐项检查视觉效果、视频和品牌合规性	加载 ./references/02-per-asset-qc.md
3. 跨素材一致性	验证整个营销活动素材集的协调一致性	加载 ./references/03-cross-asset-consistency.md
4. 报告与回派	生成最终报告、创建修订工单并更新状态	加载 ./references/04-report-and-route.md

严重性模型

所有问题分为三个严重级别：

严重性	含义	影响
严重	素材不可用或不符合品牌要求——尺寸错误、文件损坏、Logo 错误、文字无法辨认	素材未通过。创建修订工单。
警告	素材可用但不够理想——颜色略有偏差、音频略微过大、缺少可选元数据	素材通过，但附带说明。建议修订。
信息	观察结果或建议——可以改进，但不属于质量关卡问题	记录以供参考。不创建修订工单。

如果一项素材没有任何严重问题，则该素材通过。只有所有素材都通过时，营销活动才算通过质量控制审核。

清单类型

生产工作流会生成这些清单文件。此工作流会读取所有文件：

清单	生成方	内容
design-manifest.json	设计工作流	图像素材、尺寸、格式、所用品牌颜色
video-manifest.json	视频制作工作流	视频素材、编解码器、分辨率、时长、字幕状态
clip-manifest.json	paw-cra-video-clips	提取的片段，包含重新构图和目标平台
batch-manifest.json	paw-cra-design-batch	批量生成的视觉素材及其内容日历映射