prompt-preflight-qa

提示词预检 QA

适用场景

• 已有分镜提示词或完整视频请求。
• 需要在消耗额度前，发现首帧薄弱、约束缺失、偏移风险、产品出场时机不当或泛泛的广告式措辞。
• 输出应为简洁的就绪情况报告，而非创意审批。

不适用场景

• 不要在生成后用它来评判成片的创意质量。
• 除非用户要求，否则不要重写整个提示词；应指出阻碍，并交由合适的上游技能处理。

核心规则

根据提示词的可控性而非文案是否出彩来判断其质量。

默认工作流

1. 对提示词对象进行分类：分镜网格提示词、完整视频请求、无参考草稿或参考驱动的复刻草稿。
2. 检查开场力度、前三秒钩子的清晰度、观众疑问、可见证据、承诺兑现情况、产品出场时机、负面约束、参考约定、明确的参考绑定、UGC 真实感、输出格式和长视频分段计划。
3. 在有用时，生成机器可读的预检报告。
4. 返回简洁的结论，说明风险、缺失字段、可能的偏移、修复措施，以及提示词现在是否可以运行。

归因规则

将弱点归到正确的上游阶段：

• 路由错误 -> media-router 或 video-request-architect
• 钩子逻辑缺失或不合适 -> video-request-architect
• 钩子解读薄弱 -> reference-decode
• 分镜面板、节拍或请求逻辑薄弱 -> video-request-architect
• 学习与禁止复制的边界不清 -> reference-contract-builder

输出格式

产物包含 verdict、canRunNow、missingFields、majorRisks、likelyDrift 和 fixNow。

停止条件

• 如果缺少必要的用户意图、源证据或自有输入产物，且猜测会改变结果，则停止。
• 如果自有 CLI 或脚本命令失败，报告确切错误并停止。不要通过仅提供元数据的回答、就绪状态探测、本地载荷重写、备用提供方或未发布工具来绕过失败。

移交

• 返回 report.json 或 stdout JSON，并附上最小化的上游修复方案。
• 修复后，在生成前重新运行此预检。

公共命令边界

• 根据用户输入，选择匹配度最高且最精简的命令或工作流，并直接运行。
• 如果自有 CLI 或脚本命令失败，报告确切错误并停止。不要通过仅提供元数据的回答、就绪状态探测、本地载荷重写、备用提供方或未发布工具来绕过失败。
• 此公共技能由指令驱动。应直接根据可用证据生成工作流所描述的产物。
• 不要调用私有提供方或运行时路径，也不要调用未发布的本地工具。
• 如果 CLI 返回报价确认挑战，则运行 postplus quote confirm --json --challenge-file <challenge.json>，并使用返回的令牌重试。