validate-output

/digital-marketing-pro:validate-output

目的

根据预期的结构架构验证营销内容，确保内容完整、格式一致并达到可发布状态。检查必需章节、字数范围、Markdown 格式合规性、占位文本（未填充的模板变量、占位文本 lorem ipsum、TBD 标记），以及内容与 CTA 的一致性。支持 8 种常见营销内容类型的内置架构，也支持用于品牌专属模板的自定义架构。

此命令可捕捉质量评估可能遗漏的结构和格式问题——例如导致 SEO 出问题的缺失 H2、未被发现的占位文本「[INSERT COMPANY NAME]」、比需求规定少 300 个词的博客文章，或 CTA 承诺提供演示，但正文却在介绍白皮书的电子邮件。建议在通过 /digital-marketing-pro:eval-content 评估内容质量后，将此命令作为发布前的最终检查。

必需输入

用户必须提供（或系统会提示用户提供）：

• 要验证的内容：需要检查的文本——可直接输入、粘贴文本块或提供文件路径。支持任何营销内容格式
• 架构名称或文件（可选）：8 种内置架构之一——blog_post、email、ad_copy、social_post、landing_page、press_release、content_brief、campaign_plan——或自定义 JSON 架构的文件路径。如果省略，验证器会根据内容结构、长度和格式模式自动检测最可能的架构。自定义架构遵循 skills/context-engine/eval-framework-guide.md 中定义的格式

流程

1. 加载品牌背景：读取 ~/.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/ 中是否有自定义 schema。检查 ~/.claude-marketing/sops/ 中是否有代理机构的标准操作流程。如果不存在品牌，询问：“先设置品牌（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 确定 schema：如果用户提供了 schema 名称或文件，则直接使用。如果没有，则执行 scripts/output-validator.py --action list-schemas 获取所有可用的 schema，然后根据内容特征（长度、结构、格式模式）选择最合适的一个。说明选择了哪个 schema 以及原因，以便用户在选择有误时进行更改。
3. 运行结构验证：对于八个内置 schema 之一，执行 scripts/output-validator.py --action validate --text "{content}" --schema {builtin_schema_name}；对于自定义 schema 文件，则执行 --custom-schema {path/to/schema.json}（这两个标志不同——--schema 仅接受内置名称，--custom-schema 接受文件路径）。验证器会检查：
   • 必需章节：schema 中定义的所有章节均存在，且标题适当。对于每个缺失的章节，指出所需内容以及该章节应在内容结构中的位置
   • 字数：总字数和各章节字数均在 schema 定义的范围内。标出字数不足（内容太单薄、深度不够）和字数超出（内容太长、需要精简）两种情况
   • 格式合规性：Markdown 标题层级正确（无层级跳跃），列表格式正确，链接语法有效，图片包含替代文本，代码块已闭合，表格可正常渲染
   • 占位符检测：扫描未填写的模板变量（{placeholder}、[PLACEHOLDER]、[INSERT X]、TODO、TBD、FIXME、Lorem ipsum、xxx、用作占位符的 ACME Corp）、未完成内容，以及明显未自定义的模板化内容
   • CTA 一致性：行动号召应与内容主题和承诺相符——关于电子邮件营销的博客文章不应引导读者查看社交媒体指南，推广网络研讨会的邮件应链接到研讨会注册页面，而不是通用的联系页面
   • SEO 结构（适用于 blog_post 和 landing_page schema）：存在且仅有一个 H1，元描述长度在 150–160 个字符之间，标题标签长度在 50–60 个字符之间，存在内部链接，关键词出现在 H1 和前 100 个词中
   • 合规标记（适用于受监管行业）：包含必要的免责声明和强制披露，并在需要时引用条款与条件
4. 提供修复指导：对于每项未通过的检查，提供具体指导：
   • 缺失或错误之处，以及在内容中的确切位置
   • schema 的要求（所执行的规则）
   • 修复方法，并举例说明修正后的章节应是什么样子
   • 指明修复是必需的（schema 强制要求）还是建议的（最佳实践）
5. 处理自定义 schema 请求：如果用户需要的 schema 与任何内置选项都不匹配，则指导他们了解 JSON schema 格式：
   • 必需字段：name、sections（章节定义数组，包含名称、必需标记、最小/最大字数）、total_word_count（最小/最大值）、formatting_rules、placeholder_patterns
   • 提供根据当前内容结构生成基础 schema，供用户进一步调整
6. 以检查清单形式呈现结果：将所有验证结果整理为通过/失败清单，方便用户依次处理，并将最关键的失败项列在最前面。

输出

结构化验证报告，包含：

• 验证得分：已通过的检查数占运行检查总数的百分比——衡量结构完整性的核心指标
• 所用架构：应用的架构（内置名称或自定义文件路径）、由用户指定还是自动检测，以及自动检测时的置信度
• 通过/失败检查清单：逐项列出每项检查及其通过或失败状态：
  • 章节检查：列出必需章节及其存在/缺失状态。对于每个缺失章节，注明预期标题、应出现的位置，以及内容示例
  • 字数检查：总字数与架构范围的对比，以及超出预期范围的章节字数。显示差值（例如，“比最低要求的 1,500 字少 247 字”）
  • 格式检查：标题层级验证、列表格式、链接语法、图片替代文本、代码块闭合情况、表格渲染。注明每个问题的位置和违反的具体格式规则
  • 占位符检查：列出检测到的每个占位符实例，包括原文、所在行号和建议操作（替换为实际内容、删除，或确认有意保留）。按类型分组：模板变量、Lorem ipsum、TBD/TODO 标记、明显的占位符名称
  • CTA 一致性检查：CTA 是否符合内容主题和承诺。如果不符，指出具体不一致之处并给出修正建议
  • SEO 结构检查（如适用）：H1 的存在与唯一性、元描述长度、标题标签长度、关键词位置、内部链接
  • 合规性检查（如适用）：必需的免责声明、披露信息和法律引用
• 修复清单：按优先级列出所有失败项，并提供具体修复说明——先列出必需修复，再列出建议改进，每项附上修正文本示例
• 占位符清单：完整列出内容中检测到的所有占位符，并去重，方便用户集中查看所有待填写内容
• 架构参考：如用户可能需要，概述所应用的架构规则，帮助撰写者在撰写下一篇内容前了解结构要求

使用的 Agent

• quality-assurance — 选择和自动检测架构；执行涵盖所有检查维度（章节、字数、格式、占位符、CTA 一致性、SEO 结构、合规标记）的结构验证；生成包含具体示例的修复指导；整理检查清单；提供自定义架构创建指导