用途
validate-output 用于对照预期的结构模式校验营销内容，确保内容完整、格式一致并达到可发布状态。它检查必需章节、字数范围、Markdown 格式合规性、占位符文本检测（未填充的模板变量、lorem ipsum、TBD 标记）以及内容与 CTA 的一致性。支持八种常见营销内容类型的内置模式，以及品牌专属模板的自定义模式。
该命令用于捕捉质量评估遗漏的结构与格式问题，例如破坏 SEO 的缺失 H2、漏掉的占位符「[INSERT COMPANY NAME]」、比简报要求少 300 字的博客文章，或正文讲白皮书但 CTA 却承诺演示的邮件。它被设计为在通过 /digital-marketing-pro:eval-content 完成内容质量评估之后，作为最终发布前检查运行。
输入要求
用户必须提供（或将被提示提供）：
- 待校验内容：要检查的文本——可内联提供、作为粘贴块提供，或作为文件路径提供。支持任何营销内容格式。
- 模式名称或文件（可选）：八种内置模式之一——blog_post、email、ad_copy、social_post、landing_page、press_release、content_brief、campaign_plan——或自定义 JSON 模式的文件路径。如果省略，校验器会根据内容结构、长度和格式模式自动检测最可能的模式。自定义模式遵循 skills/context-engine/eval-framework-guide.md 中定义的格式。
处理流程
-
加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取活动 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌格式标准和内容要求。同时检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 处的指南——如果存在，从 templates/ 加载可能定义品牌专属必需章节、字数范围和格式规则的模板定义。检查 ~/.claude-marketing/brands/{slug}/schemas/ 处的自定义模式。检查 ~/.claude-marketing/sops/ 处的代理 SOP。如果不存在品牌，询问：「Set up a brand first (/digital-marketing-pro:brand-setup)?」——或使用默认值继续。
-
确定模式：如果提供了模式名称或文件，直接使用。如果未提供，执行 scripts/output-validator.py --action list-schemas 获取所有可用模式，然后根据内容特征（长度、结构、格式模式）选择最合适的模式。报告所选模式及原因，以便用户在选择错误时可以覆盖。
-
运行结构校验：对八种内置模式之一执行 scripts/output-validator.py --action validate --text "{content}" --schema {builtin_schema_name}，或对自定义模式文件执行 --custom-schema {path/to/schema.json}（两个标志不同——--schema 仅接受内置名称，--custom-schema 接受文件路径）。校验器检查：
- 必需章节：模式中定义的所有章节均以适当的标题存在。对于每个缺失章节，识别预期内容及其在内容结构中应出现的位置。
- 字数：总字数和各章节字数落在模式定义的范围内。标记字数不足（过于单薄、缺乏深度）和字数过多（过长、需要精简）。
- 格式合规性：Markdown 标题层级正确（无跳级）、列表格式正确、链接语法有效、图片有 alt 文本、代码块已闭合、表格正确渲染。
- 占位符检测：扫描未填充的模板变量（{placeholder}、[PLACEHOLDER]、[INSERT X]、TODO、TBD、FIXME、Lorem ipsum、xxx、用作占位符的 ACME Corp）、部分完成内容以及明显未定制的模板化内容。
- CTA 一致性：行动号召与内容主题和承诺匹配——关于电子邮件营销的博客文章不应 CTA 到社交媒体指南，推广网络研讨会的邮件应链接到网络研讨会注册页，而非通用联系页。
- SEO 结构（针对 blog_post 和 landing_page 模式）：H1 存在且唯一、meta 描述长度在 150-160 字符内、标题标签在 50-60 字符内、存在内部链接、关键词出现在 H1 和前 100 词中。
- 合规标记（针对受监管行业）：存在必需免责声明、包含强制披露、在需要处引用条款和条件。
- 生成修复指导：对于每个未通过的检查，提供具体指导：
- 缺失或错误的内容，以及内容中的确切位置
- 模式要求什么（正在执行的规则）
- 如何修复，并给出修正后章节应是什么样子的示例
- 修复是必需（模式强制要求）还是建议（最佳实践）
- 处理自定义模式请求：如果用户需要的模式与任何内置选项都不匹配，指导他们了解 JSON 模式格式：
- 必需字段：name、sections（章节定义数组，含 name、required 标志、min/max 字数）、total_word_count（min/max）、formatting_rules、placeholder_patterns
- 提议根据内容当前结构生成一个起始模式，供用户完善
- 以清单式结果呈现：将所有校验结果格式化为通过/失败清单，用户可按顺序逐项处理，最关键的失败项排在最前。
输出
一份结构化校验报告，包含：
- 校验得分：通过检查数占总运行检查数的百分比——结构完整性的首要指标。
- 所用模式：应用了哪个模式（内置名称或自定义文件路径）、是用户指定还是自动检测，以及自动检测时的检测置信度。
- 通过/失败清单：每项检查作为一行，带通过或失败状态：
- 章节检查：必需章节列表及存在/缺失状态。对于每个缺失章节，给出预期标题、应出现位置及其应包含内容的示例。
- 字数检查：总字数与模式范围的对比，以及任何超出预期范围的章节的逐节字数。显示差值（例如「比 1,500 字下限少 247 字」）。
- 格式检查：标题层级校验、列表格式、链接语法、图片 alt 文本、代码块闭合、表格渲染。每个问题附位置和违反的具体格式规则。
- 占位符检查：每个检测到的占位符实例，含确切文本、行位置和建议操作（替换为真实内容、删除或确认是否有意保留）。按类型分组：模板变量、lorem ipsum、TBD/TODO 标记、明显的占位符名称。
- CTA 一致性检查：CTA 是否与内容主题和承诺一致。如果不一致，指出具体不一致之处和建议修正。
- SEO 结构检查（如适用）：H1 存在性和唯一性、meta 描述长度、标题标签长度、关键词位置、内部链接。
- 合规检查（如适用）：必需免责声明、披露和法律引用。
- 修复清单：按优先级排序的所有失败项列表，附具体修复说明——必需修复在前，然后是建议改进，每项附修正后文本示例。
- 占位符清单：内容中所有检测到的占位符的完整去重列表，以便用户有一个统一参考，了解所有需要填写的内容。
- 模式参考：如果用户可能需要，提供所应用模式规则的摘要——有助于写作者在开始下一篇内容前理解结构要求。
使用的智能体
quality-assurance——模式选择和自动检测、跨所有检查维度（章节、字数、格式、占位符、CTA 一致性、SEO 结构、合规标记）执行结构校验、生成带具体示例的修复指导、清单格式化以及自定义模式创建指导。