用途:review-brand 是 agentic-workflow 评审包中的内部品牌与文案评审环节,由 review-change 和 product-audit 在对话中组合调用,并非独立菜单入口。它针对调用方传入的 diff 或路径/glob 进行品牌与文案检查,默认比较当前变更与默认分支,并在返回表格顶部声明范围。
主要能力:按清单逐项评估,包括先阅读项目品牌文档(如 docs/brand/BRAND.md)并引用规则;检查变更文案语气是否符合声明的 voice;产品/领域术语是否与声明的词汇表一致(同一概念、同一词、同一大小写);是否出现品牌文档禁止或弃用的短语;声明是否诚实,代码强制执行的限制、约束和削减是否在文案中披露(未披露的限制属于 major 发现,是仓库硬规则);错误/空状态文案是否可操作、不指责用户;变更界面与其同类界面是否一致;diff 中是否残留占位或 lorem 文本。
使用方式:在任意 agent 上按路由步骤内联遵循该文件。调用方传入 diff 或路径/glob,默认当前变更对比默认分支。返回固定格式:REVIEW BRAND — scope、发现表格(#、Finding、Sev、Evidence、Suggested fix)、Checklist 统计、Summary 和 Decision(PASS 或 FAIL)。存在未解决的 critical 或 major 发现则 FAIL,否则 PASS;minor 不阻塞,交由调用方分诊。
适用场景:适合在代码变更评审中同步检查品牌与文案一致性,尤其是涉及用户可见文案、错误提示、产品术语和限制披露的改动。
限制:只输出发现,从不编辑或重构代码;仅当合格用户的结果会改变或项目明确声明的规则被违反时才报告,注释/标点错别字、纯格式漂移、无引用规则的风格偏好、超出 SPEC 命名场景的假设性健壮性均不算发现;项目无品牌文档时所有项标记 n/a 并说明。完成条件是每个清单项都有证据(file:line 或命令输出)或明确 n/a 及原因,并返回固定格式块,不修改任何代码。