Brand Voice Plugin 质量保障 Agent 实战指南：基于 Claude Cowork 的品牌内容合规校验体系

Brand Voice Plugin 质量保障 Agent 实战指南基于 Claude Cowork 的品牌内容合规校验体系【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins导读本文深入解析 knowledge-work-plugins 仓库中 Brand Voice Plugin 的专职质量保障QAAgent —— quality-assurance.md。它用于在品牌内容与品牌指南交付用户之前执行快速、结构化的合规校验内容是否贴合 We Are / We Are Not 声音属性、语气是否符合上下文、术语是否合规、指南是否完整、开放问题是否可落地、是否存在 PII 泄露。读完本文你将掌握这套三层校验内容校验 / 指南校验 / 开放问题审计的完整规则、标准化的校验输出格式以及它与品牌发现、指南生成、声音执行三个工作流的联动机制。一、QA Agent 在 Brand Voice Plugin 中的定位1.1 插件的整体架构Brand Voice Plugin 是面向 Claude Cowork 的知识工作者插件其目标是把散落在 Confluence、Google Drive、Box、SharePoint、Slack、Gong、Granola 等平台上的品牌素材转化为 LLM 可执行的品牌护栏并据此校验每一份 AI 生成内容。仓库中 README.md 将其能力划分为三个主流程Brand Discovery跨平台搜索品牌素材/brand-voice:discover-brandGuideline Generation将素材合成为 LLM-ready 品牌指南/brand-voice:generate-guidelinesBrand Voice Enforcement生成内容时全程按指南执行/brand-voice:enforce-voice。而quality-assuranceAgent 正是这三条流程之上的质检关口——README 的文件结构说明中明确标注其职责为 Compliance and open questions audit合规与开放问题审计。1.2 Agent 的定义与触发场景quality-assurance.md 的 frontmatter 定义了该 Agent 的元数据配置项值含义namequality-assuranceAgent 唯一标识description校验内容与品牌指南是否合规、一致、完整并覆盖开放问题决定何时被自动调用的意图描述modelhaiku选用轻量快速模型——质检是快速、结构化的合规检查不需要重型推理coloryellow界面标识色toolsRead/Glob/Grep只需读取与检索无需写文件maxTurns10单次任务最多 10 轮交互frontmatter 中的两个example明确给出了典型触发场景场景 A内容校验brand-voice-enforcementSkill 生成了一封冷邮件在呈现给用户之前调用 QA Agent 对照品牌指南校验 —— Check this email against our brand guidelines场景 B指南校验品牌指南刚刚生成完毕在呈现之前校验其完整性与质量 —— Validate these brand guidelines for completeness and quality。这两条示例说明了一个关键设计原则质检不是事后补救而是交付前强制关口。内容生成与指南生成两条链路都会主动委派给它。1.3 与相邻 Agent 的分工仓库agents/目录下共有五个 Agent它们形成一条发现 → 分析 → 生成 → 质检的流水线详见 README.mdAgent 文件职责discover-brand.md跨平台自主搜索品牌素材document-analysis.md品牌文档解析conversation-analysis.md销售通话转录分析content-generation.md品牌对齐的内容创作quality-assurance.md合规校验与开放问题审计调用关系在两个 Skill 中有明确证据brand-voice-enforcement/SKILL.mdFor high-stakes content, delegate to the quality-assurance agent for validation高风险内容委托 QA Agent 校验guideline-generation/SKILL.md第 6 步 Quality Check 要求交付前通过 QA Agent 逐项核对完整性、证据、语气矩阵、置信度、溯源、PII 与开放问题。二、三层校验体系之一内容校验Content Validation当 QA Agent 收到待校验的生成内容时执行五项检查。它对照的基准是用户自己的品牌指南结构参考 guideline-template.md。2.1 Voice Compliance声音合规核心问题是内容是否体现了 We Are 属性是否越过了 We Are Not 边界We Are / We Are Not 表是品牌声音的锚点把品牌人格定义为成对的属性与禁区。voice-constant-tone-flexes.md 给出了一份示例表We AreWe Are NotConfident— 了解产品并为之背书Arrogant— 绝不居高临下Approachable— 让复杂话题可理解Casual or sloppy— 亲和不等于不专业Direct— 快速清晰切入要点Blunt or aggressive— 直接也要有同理心Data-driven— 用证据支撑主张Dry or academic— 数据讲故事而非说教Innovative— 推动边界、挑战现状Hype-driven— 创新是真实而非空话校验时逐条核对正向属性是否在内容中体现负向边界是否被触碰。注意一个执行细节同文件 Common Enforcement Mistakes并非每个属性都要出现在每份内容里应让 2-3 个与内容类型、受众最相关的属性领衔。2.2 Tone Appropriateness语气适配检查语气在正式度formality、能量energy、技术深度technical depth三个维度上是否匹配内容类型与受众。guideline-template.md 中的 Tone-by-Context 矩阵是判定基准上下文正式度能量技术深度核心原则冷开发信MediumHighLow快速钩住注意力发现通话MediumMedium-HighMedium多问少说Demo/演示Medium-HighHighHigh展示而非空谈企业提案HighMediumHighROI 与精确跟进邮件MediumMediumLow-Medium每次触达补充新价值社交媒体Low-MediumHighLow简洁与个性客户成功MediumWarmMedium共情与专业内部沟通LowMedium视情况真实、少修饰特别留意Warm温暖这一能量档位——它专门用于客户成功、异议处理等需要共情的场景是语气矩阵中一个容易漏检的取值。2.3 Messaging Alignment信息对齐检查关键信息支柱Key Message Pillars是否在合适的位置自然出现而不是生硬堆砌。指南模板中每个支柱都包含核心观点、使用时机、示例措辞与频率数据见 guideline-template.mdQA 据此判断该说的有没有说到位。2.4 Terminology术语合规对照指南的 术语表 核查四类术语Must-Use Terms必须使用的术语是否在用Preferred Terms优先术语是否正确选用Avoid These Terms应避免的术语是否出现Never-Use Terms禁止术语是否绝迹。2.5 Example Alignment示例对齐检查生成内容的质量是否达到指南中 Excellent Examples 的水准。指南模板要求所有示例带来源归因guideline-template.mdQA 以之为质量标尺。三、三层校验体系之二指南校验Guideline Validation当 QA Agent 收到的是新生成的品牌指南时执行六项质量检查——这一环节与 guideline-generation/SKILL.md 第 6 步 Quality Check 的要求完全对应。3.1 Completeness完整性所有主要小节是否填充完毕包括 Brand Personality、Content Examples 等只要素材支持就应存在We Are / We Are Not 表是否至少 4 行模板使用说明明确 minimum 4 rows, ideally 5-7guideline-template.md。若表不足 4 行即视为不达标。3.2 Evidence Quality证据质量每个声音属性是否有支撑引语Evidence 字段并带来源引用。指南模板中每个属性需记录 Evidence: source quote or pattern, with citationguideline-template.md。这与 confidence-scoring.md 的置信度体系互相印证——证据越充分置信度越高。3.3 Actionability可操作性指南是否具体到可以落地执行而非空泛原则。置信度方法论中对 High Confidence 有一条明确标准Specific, actionable instructions (not just vague principles)confidence-scoring.mdQA 校验时以同一标准审视指南的可执行性。3.4 Consistency一致性检查各小节之间是否互相矛盾——例如声音属性说 Approachable语气矩阵却给冷开发信定了僵硬的高正式度或术语表中 Must-Use 与 Avoid 出现同一词。矛盾的小节通常也会在置信度评估中被标记为 unresolved conflictsconfidence-scoring.md。3.5 Tone Matrix Coverage语气矩阵覆盖语气矩阵至少覆盖 3 个内容上下文。模板使用说明要求最低覆盖 cold outreach、proposals、social media 三类guideline-template.md完整版应有 8 个上下文见上文 2.2 的矩阵。3.6 PII Check隐私检查客户姓名、联系方式等敏感信息是否在示例中脱敏。这一检查贯穿整个指南生成链路而非仅出口把关——guideline-generation/SKILL.md 明确要求全程脱敏客户姓名与联系方式、按需匿名化转录中的公司名、处理中标记敏感信息。四、三层校验体系之三开放问题审计Open Questions Audit开放问题Open Questions是 Brand Voice Plugin 的特色设计——当遇到无法消解的歧义冲突文档、缺失指南、宣称与实操的品牌偏差时将歧义转化为待团队决策的问题而不是死胡同。README 明确 Open questions are a feature, not a failureREADME.md。QA Agent 对指南中 Open Questions 小节执行五项检查4.1 Completeness完整性每个歧义与冲突是否都有对应的开放问题指南模板按优先级组织开放问题guideline-template.mdHigh Priority阻塞指南完成的问题Medium Priority改善质量的问题Low Priority锦上添花的问题。4.2 Recommendations建议每个开放问题是否都包含 Agent 建议这是硬性要求——生成规范写明 Every open question MUST include an agent recommendation. Turn ambiguity into confirm or override — never a dead end.guideline-generation/SKILL.md。模板中每个问题固定包含三个字段What was found发现的歧义描述Agent recommendation建议的解决方案及理由Need from you团队需要做出的具体决策。4.3 Priority优先级问题是否被正确标记为 High/Medium/Low优先级判定有可复用的映射规则confidence-scoring.md 给出了低置信度与开放问题的对应关系触发条件生成的问题优先级低置信度 来源冲突High Priority低置信度 数据缺口Medium Priority中置信度 轻微不一致Low Priority4.4 Actionability可落地性每个问题是否明确说明了团队需要做的具体决策Need from you而不是开放式提问。4.5 No Dead Ends无死胡同没有任何问题让用户停留在没有前进路径的状态。这是开放问题机制的底线即便团队暂时不决策Agent 的推荐也应给出可执行的默认路径。五、标准化的校验输出格式QA Agent 必须以固定结构输出校验结果便于上层 Skill 与用户快速解析。原文档定义的模板如下Validation Result: [Pass / Needs Revision / Fail] Checks: - Voice Compliance: [Pass/Fail] - [details] - Tone: [Pass/Fail] - [details] - Messaging: [Pass/Fail] - [details] - Terminology: [Pass/Fail] - [issues found] - Open Questions: [Pass/Fail] - [details] - PII: [Pass/Fail] Issues Found: 1. [Severity: Critical/Suggested] [description] - Fix: [recommendation] Overall: [summary]这套格式与 content-generation.md 的 Brand Application Notes 输出形成闭环生成端标注品牌选择质检端返回逐项校验结果两层证据让用户可以追溯每一处内容决策。六、质量标准的三个铁律原文档最后定义了 QA Agent 自身的质量标准这三条是保证校验结论可信的底线每个发现必须引用所依据的具体指南条目Every finding must cite the specific guideline it references——没有溯源就没有可验证性建议必须可执行Recommendations must be actionable——与开放问题审计中的 Agent recommendation 要求同源严重级别三档制Critical必须修复触碰 We Are Not 边界、使用禁止术语、PII 泄露、指南缺核心小节等Suggested应当修复语气档位偏差、优先术语未用、示例质量不足等Optional锦上添花可优化但不影响合规的改进项。七、QA Agent 与配置、执行链路的配合7.1 与 enforcement 设置的联动brand-voice.local.md.example 中enforcement.strictnessstrict / balanced / flexible与always-explain两个设置决定了执行时的松紧与解释粒度。QA 校验应在用户配置的严格度语境下进行strict 模式下任何 We Are Not 越界都应判 Criticalflexible 模式下部分边界允许在说明权衡后弹性处理——这与 brand-voice-enforcement/SKILL.md 的冲突处理策略说明冲突 → 给出建议 → 提供三种选项保持一致。7.2 完整质检调用链综合仓库源码QA Agent 的典型完整调用链为/brand-voice:discover-brand发现素材discover-brand Skill/brand-voice:generate-guidelines生成指南第 6 步 Quality Check调用 QA Agent 校验指南guideline-generation/SKILL.md/brand-voice:enforce-voice执行指南生成内容高风险内容再次调用 QA Agent 校验内容brand-voice-enforcement/SKILL.md校验结果返回上层 Skill由 Skill 决定是否修订、如何呈现给用户。7.3 为什么 QA 用 haiku 模型QA Agent 配置为model: haiku且maxTurns: 10这是刻意的成本/速度设计合规校验是结构化、规则明确的任务——查表比对、逐项核查、套用固定输出模板——不需要长链推理。与之对比content-generation.md 使用sonnet且maxTurns: 15因为生成长内容需要同时平衡多项品牌约束。README 的架构设计说明也印证了 Progressive disclosure——frontmatter 精简、SKILL.md 聚焦、细节放在 references/ 的整体原则README.md。八、实践要点速查校验维度判定基准关键证据文件声音合规We Are / We Are Not 表逐条比对voice-constant-tone-flexes.md语气适配正式度 × 能量 × 技术深度guideline-template.md术语合规Must-Use / Preferred / Avoid / Never-Use 四层表guideline-template.md指南完整性主要小节齐全 We Are / We Are Not ≥ 4 行guideline-template.md证据质量属性带引语与来源引用confidence-scoring.md开放问题完整性 / 建议 / 优先级 / 可落地 / 无死胡同guideline-generation/SKILL.mdPII客户名、联系方式脱敏guideline-generation/SKILL.md结语Brand Voice Plugin 的 QA Agent 用一套轻量、结构化、可追溯的校验协议把像我们一样写作从口号变成了可验证的工程标准。它的核心价值在于三点前置交付前强制校验而非事后补救、结构化固定输出格式让机器与人都能秒级解析、可溯源每个结论必须引用具体指南条目。对于任何需要在 AI 工作流中维护品牌一致性、内容合规性与开放问题治理的团队这套 Agent 定义都是一个可以直接借鉴的蓝本。如需深入理解其上游数据与下游消费建议通读 guideline-template.md校验对象的完整结构、confidence-scoring.md置信度与开放问题的联动以及 voice-constant-tone-flexes.md声音恒定、语气弹性的底层心智模型。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考