discover-brand

品牌发现

跨企业平台自主编排品牌素材的发现工作。本技能协调 discover-brand Agent，搜索已连接的平台（Notion、Confluence、Google Drive、Box、Microsoft 365、Figma、Gong、Granola、Slack），对来源进行分类筛选，并生成包含待解决问题的结构化发现报告。

发现工作流

0. 向用户说明流程

开始前，简要说明即将发生的事情，让用户了解预期：

"以下是品牌发现的工作方式：

1. 搜索 — 我会在您已连接的平台（Notion、Google Drive、Slack 等）中搜索品牌相关素材，包括风格指南、演示文稿、模板、转录稿等。
2. 分析 — 我会对找到的内容进行分类和排序，提取最佳来源，并生成发现报告，列出我的发现、存在的冲突以及待解决的问题。
3. 生成指南 — 您审阅报告后，我可以根据结果生成结构化的品牌语调指南文档。
4. 保存 — 您批准后，指南将保存到您工作文件夹中的 .claude/brand-voice-guidelines.md。在此步骤之前，不会写入任何内容。

搜索通常需要几分钟，具体取决于已连接的平台数量。准备好开始了吗？"

在用户确认之前，不要继续。如果用户对流程有疑问，请先回答。

1. 检查设置

如果存在 .claude/brand-voice.local.md，则读取该文件。提取以下内容：

• 公司名称
• 已启用的平台（notion、confluence、google-drive、box、microsoft-365、figma、gong、granola、slack）
• 搜索深度偏好（standard 或 deep）
• 最大来源数量限制
• “Known Brand Materials”下列出的任何已知品牌素材位置

如果不存在设置文件，则使用所有已连接的平台和标准搜索深度继续。

2. 验证平台覆盖范围

在确认范围之前，检查哪些平台实际已连接，并对其进行分类：

文档平台（品牌指南、风格指南、模板和演示文稿所在的地方）：

• Notion、Confluence、Google Drive、Box、Microsoft 365（SharePoint/OneDrive）

辅助平台（对发现规律有价值，但并非品牌文档的存储位置）：

• Slack、Gong、Granola、Figma

应用以下规则：

1. 如果未连接任何文档平台：停止。 告知用户："您尚未连接任何文档存储平台（Google Drive、SharePoint、Notion、Confluence 或 Box）。品牌指南和风格指南几乎都存放在这些平台之一中。请在运行发现前至少连接一个平台。Gong/Granola/Slack 的转录稿是有价值的补充，但不太可能包含正式的品牌文档。"

2. 如果同时未连接 Google Drive、Microsoft 365 和 Box：警告（但继续执行）："您的主要文件存储平台（Google Drive、SharePoint、Box）均未连接。品牌文档经常存放在这些平台上。发现将继续使用[已连接的平台]进行，但结果可能存在较大缺口。建议连接 Google Drive 或 SharePoint。"

3. 如果总共只连接了一个平台：警告（但继续执行）："目前只连接了[平台]。发现功能在连接 2 个及以上平台时效果最佳，可进行跨来源验证。单一平台的结果置信度较低。"

3. 与用户确认范围

在启动发现之前，确认以下内容：

• 要搜索哪些平台（默认：所有已连接的平台）
• 是否包含对话转录稿（Gong、Granola），还是仅搜索文档
• 是否有需要优先查看的已知位置

保持简洁，只问一个问题，而不是一份问卷。

4. 委派给 Discover-Brand Agent

通过 Task 工具启动 discover-brand agent。提供以下信息:

• 公司名称(来自设置或用户输入)
• 已启用的平台
• 搜索深度
• 需要优先检查的已知 URL 或位置

该 agent 会自主执行 4 阶段发现算法:

1. 广泛发现:跨平台并行搜索
2. 来源分类:对来源进行归类和排序
3. 深度抓取:检索并提取排名靠前来源的内容
4. 发现报告:包含待解决问题的结构化输出

5. 展示发现报告

agent 返回结果后,向用户展示报告并附上摘要:

• 发现并分析的来源总数
• 发现的关键品牌要素
• 来源之间存在的冲突
• 需要团队输入的待解决问题

6. 提供后续步骤

展示报告后,提供以下选项:

1. 立即生成指南:以发现报告为输入,衔接到 /brand-voice:generate-guidelines
2. 先解决待解决问题:在生成前处理高优先级问题
3. 保存报告:将发现报告存储到 Notion 或保存为本地文件
4. 扩大搜索范围:如果覆盖率较低,搜索更多平台或进行更深入的搜索

待解决问题

当发现 agent 遇到无法自行解决的歧义时,会产生待解决问题,例如:

• 文档相互冲突(例如 2023 年风格指南与 2024 年品牌更新)
• 缺少关键章节(例如未找到社交媒体指南)
• 各平台术语不一致

每个待解决问题都包含 agent 的建议。问题应以"确认或修改"的方式呈现,而不是死胡同。

与其他 Skills 的集成

• 指南生成:发现报告由 discover-brand agent 通过 Task 工具返回。将其作为结构化输入直接传递给指南生成 skill,无需用户手动收集来源。
• 品牌语音执行:从发现过程生成指南后,执行环节会自动使用这些指南。

错误处理

• 如果未连接任何平台,告知用户该插件支持哪些平台以及如何连接。
• 如果所有搜索都返回空结果,将此次发现标记为"覆盖率低",并建议用户手动提供文档或检查平台连接。
• 如果某个平台已连接但返回权限错误,记录该缺口并继续处理其他平台。

参考文件

如需了解详细的发现模式和算法,请参阅:

• references/search-strategies.md:各平台的搜索查询、按平台划分的查询模式,以及最大化发现覆盖率的技巧
• references/source-ranking.md:来源类别定义、排序算法权重以及分类决策标准