language-audit

/digital-marketing-pro:language-audit

目的

对品牌所有语言版本的内容进行全面的多语言一致性审计。检查所有语言版本是否正确关联并带有正确的 hreflang 注释、各语言版本的内容是否保持一致（无缺失翻译、无过时版本、无明显结构差异）、是否满足目标市场的区域合规要求，以及翻译质量是否符合品牌标准。涵盖多语言完整性的各个方面：技术 SEO 实施、内容完整性、语言质量、法律合规和特定地区的格式规范。

对于业务遍及多个市场的品牌而言，这项审计至关重要，因为多语言网站和营销活动的完整性会直接影响搜索可见性、用户体验和合规状况。它能发现那些悄然损害国际业务表现的问题——孤立的 hreflang 标签向搜索引擎传递相互冲突的信号、过时的译文导致品牌形象不一致、缺少合规要素带来法律风险，以及本地化不完整削弱当地受众的信任。

所需输入

用户必须提供（或将收到提示提供）：

• 网站 URL 或内容集：待审计的 URL（首页、特定版块或整个网站），或包含各语言版本的内容资源集（电子邮件营销活动、着陆页、广告文案）。对于网站，用户可以提供站点地图 URL、页面 URL 列表，或包含 hreflang 注释的 HTML 源代码。对于内容集，请提供每项资源的所有语言版本
• 要检查的语言：要审计的特定语言-地区代码（例如 en-US、de-DE、fr-FR、hi-IN），或使用“all configured”审计品牌语言配置中的所有语言。如果未提供，默认审计品牌资料中配置的所有语言
• 审计重点：要审计的维度——hreflang（仅检查标签实施情况）、content-parity（跨语言完整性和一致性）、compliance（区域监管要求）、quality（翻译评分）、localization（格式规范和文化适配）或 comprehensive（所有维度）。如果未指定，默认进行全面审计

流程

1. 加载品牌上下文：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景。加载语言配置，包括主要语言、次要语言、内容语言、禁止翻译的术语、翻译偏好和区域格式设置。还要检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如果存在，加载限制要求及相关类别文件，以了解针对特定市场的内容规则。检查 ~/.claude-marketing/sops/ 中是否有机构 SOP。如果没有品牌，询问：“先设置品牌（/digital-marketing-pro:brand-setup）？”——也可以使用默认设置继续。
2. 盘点多语言内容：识别正在审核内容的所有语言版本。对于网站，解析 hreflang 注释、备用链接标签和 URL 模式（子目录 /en/、/de/、子域名 en.example.com 或国家和地区顶级域名结构），梳理完整的语言与页面对应关系。对于内容集，按语言和内容类型归类所有提供的素材。建立语言—内容矩阵，标明哪些语言包含哪些素材，并立即标记任何缺口。
3. Hreflang 审核：对于带有 hreflang 注释的每个页面或内容集，检查以下事项：缺少指向自身的标签（每个页面都必须引用自身）、双向一致性（如果页面 A 引用了语言为 X 的页面 B，页面 B 必须引用页面 A）、ISO 639-1 语言代码和 ISO 3166-1 地区代码是否有效、是否存在且正确设置 x-default 标签（用作未匹配语言的回退）、同一页面是否存在重复的语言代码、是否使用绝对 URL（而非相对 URL）、是否有指向不存在或无响应页面的孤立注释，以及网站各页面的 hreflang 集合是否一致。为每项检查评定通过/未通过，并提供具体的页面级发现。
4. 内容一致性检查：比较各语言版本在结构和实质内容上的一致性。测量主要语言与每种译文之间的字数比例，并标记偏差超过 30% 的版本（译文显著较短可能表示缺少章节，显著较长则可能表示插入了未翻译内容或过度展开）。比较各版本的章节结构（H1/H2/H3 层级），找出缺少或多出的章节。检查每种语言版本是否都包含所有 CTA、表单、导航元素和交互组件。找出主要语言中存在、但一个或多个译文中完全缺失的内容——这是优先级最高的一致性缺口。
5. 翻译质量抽查：从每种语言版本中抽取有代表性的内容，包括标题、关键 CTA、产品描述和合规关键文本。通过 language-router.py --action score 对每个样本评分，检查与源文的长度比例、格式保留情况（Markdown、HTML、合并标签完整无损）、关键术语一致性（保留禁止翻译的术语）和占位符完整性（例如 {{first_name}} 这样的变量保持不变）。汇总每种语言的得分，找出翻译质量最高的版本，以及需要返工的版本。
6. 区域合规检查：针对每种语言和市场组合，验证是否包含正确的市场特定合规要素。欧盟语言（de-DE、fr-FR、es-ES、it-IT、nl-NL 等）需检查 GDPR 同意机制和隐私声明；印度语言（hi-IN、ta-IN、te-IN 等）需检查 DPDPA 数据保护要素；pt-BR 需符合 LGPD；ko-KR 需包含 PIPA 要素；ja-JP 需符合 APPI；面向加利福尼亚州的 en-US 内容需符合 CCPA/CPRA。检查免责声明、条款链接、隐私政策链接、Cookie 同意机制和退订机制是否存在且已正确本地化（而非只在德语页面上提供英文内容）。完整法规矩阵请参阅 skills/context-engine/compliance-rules.md。
7. 本地化完整性检查：验证各市场的区域格式是否正确——日期格式（en-US 使用 MM/DD/YYYY，de-DE 使用 DD.MM.YYYY，en-GB 使用 DD/MM/YYYY）、货币符号和格式（USD 金额前置 $，许多欧洲市场将金额置于 EUR 符号前）、计量单位（美国使用英制，其他地区均使用公制）、电话号码格式（国家代码、分组方式、分隔符）、地址格式（按国家和地区规定的顺序）以及数字格式（小数分隔符、千位分隔符）。标记源语言格式误用于译文的情况（例如，德国页面出现 USD 符号，日语内容使用美国日期格式）。
8. 生成审核报告：将所有发现汇总为按严重程度排序的审核报告。按 0–100 分制为每个维度评分。将每项发现归类为严重（阻碍发布或造成法律/SEO 风险）、警告（降低质量或影响用户体验，应在下一个更新周期前修复）或信息（改进机会，可纳入常规维护）。生成按严重程度和预估影响排序的优先修复清单，并为每项修复估算工作量。

输出

结构化的多语言审计报告，包含：

• 各维度审计评分：Hreflang 实施评分（0-100）、内容一致性评分（0-100）、翻译质量评分（0-100）、区域合规评分（0-100）、本地化完整度评分（0-100）以及多语言整体健康度评分（加权综合评分）
• 详细发现列表：列出发现的所有问题，按严重程度（严重／警告／信息）、维度、受影响的语言区域、受影响的页面或资源分类，并说明问题详情和建议修复方法
• Hreflang 实施状态：按页面细分，显示已设置、缺失或有误的 hreflang 标签、双向一致性状态以及 x-default 配置
• 内容一致性矩阵：以语言为列、内容资源为行为单位，显示内容是否存在、相对于主要语言的字数比例以及结构匹配状态，让翻译缺口一目了然
• 各市场合规缺口：按市场列出合规检查清单，说明各项必需内容是否存在、缺失或本地化有误，并为每项要求提供法规依据
• 各语言翻译质量评分：列出 language-router.py 为各语言版本给出的汇总评分和各样本评分，指出质量最差的译文及具体质量问题
• 本地化格式问题：列出特定地区格式错误（日期格式、货币、度量单位有误），并注明错误值和预期的正确格式
• 优先修复清单：按严重程度和影响对所有问题排序，并估算每项修复的工作量（快速修复／中等／重大返工），分为立即处理、下一周期修复和维护待办

使用的 Agent

• localization-specialist — 负责统筹各维度的审计工作。管理多语言内容清单，通过 language-router.py 评估翻译质量，检查特定地区格式是否正确，验证禁止翻译词语是否保留，评估文化适配质量，并汇总得出多语言整体健康度评分。协调整体审计流程并生成最终报告
• seo-specialist — 负责 hreflang 技术审计，包括标签验证、双向一致性检查、x-default 配置、依据 ISO 标准验证语言和地区代码，以及国际 SEO 最佳实践。评估发现的 hreflang 问题对 SEO 的影响，并为修复提供更正后的 hreflang 代码片段
• brand-guardian — 按目标市场执行区域合规检查，验证各语言版本是否符合特定市场的法规要求（GDPR、DPDPA、LGPD、PIPA、APPI、CCPA）。标记合规缺口及其严重程度和法规依据，并检查所有语言版本是否遵守品牌指南的限制