品牌发现 (Brand Discovery)

跨企业平台协调自主发现品牌材料。此技能协调 discover-brand 智能体，搜索已连接的平台（Notion、Confluence、Google Drive、Box、Microsoft 365、Figma、Gong、Granola、Slack），对来源进行分类，并生成结构化的发现报告及待解决问题。

发现工作流 (Discovery Workflow)

0. 引导用户 (Orient the User)

在开始之前，简要说明将要发生的事情，以便用户了解预期：

“品牌发现的工作方式如下：

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

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

在继续之前等待用户确认。如果他们对此过程有疑问，请先回答。

1. 检查设置 (Check Settings)

如果存在 .claude/brand-voice.local.md，请读取它。提取：

• 公司名称 (Company name)
• 哪些平台已启用（notion、confluence、google-drive、box、microsoft-365、figma、gong、granola、slack）
• 搜索深度偏好（标准或深度）(Search depth preference – standard or deep)
• 最大来源数量限制 (Max sources limit)
• “已知品牌材料”下列出的任何已知品牌材料位置 (Any known brand material locations listed under “Known Brand Materials”)

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

2. 验证平台覆盖范围 (Validate Platform Coverage)

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

文档平台 (Document platforms)（品牌指南、样式指南、模板和演示文稿通常存放于此）:

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

辅助平台 (Supplementary platforms)（对识别模式有价值，但不是品牌文档的存储位置）:

• Slack、Gong、Granola、Figma

应用以下规则：

1. 如果零个文档平台已连接 (If zero document platforms are connected)：停止 (Stop)。 告知用户：“您尚未连接任何文档存储平台（Google Drive、SharePoint、Notion、Confluence 或 Box）。品牌指南和样式指南几乎总是存在于这些平台之一。请在运行发现之前至少连接一个。Gong/Granola/Slack 的转录稿是有价值的补充，但不太可能包含正式的品牌文档。”
2. 如果既没有 Google Drive 也没有 Microsoft 365 也没有 Box (If no Google Drive AND no Microsoft 365 AND no Box)：警告 (Warn)（但继续）：“您的主文件存储平台（Google Drive、SharePoint、Box）均未连接。品牌文档经常存放在这些平台上。发现将使用 [已连接的平台] 进行，但结果可能存在重大空白。请考虑连接 Google Drive 或 SharePoint。”
3. 如果总共只连接了一个平台 (If only one platform total is connected)：警告 (Warn)（但继续）：“仅连接了 [平台]。发现功能在连接 2 个以上平台时效果最佳，可实现跨源验证。单个平台的结果置信度分数较低。”

3. 与用户确认范围 (Confirm Scope with User)

在启动发现之前，确认：

• 要搜索哪些平台（默认：所有已连接的）(Which platforms to search – default: all connected)
• 是否包含对话转录稿（Gong、Granola）还是仅文档 (Whether to include conversation transcripts – Gong, Granola – or just documents)
• 任何要优先查找的已知位置 (Any known locations to prioritize)

保持简短——一个问题，而不是一份问卷。

4. 委派给 Discover-Brand 智能体 (Delegate to Discover-Brand Agent)

通过 Task 工具启动 discover-brand 智能体。提供：

• 公司名称（来自设置或用户输入）(Company name – from settings or user input)
• 已启用的平台 (Enabled platforms)
• 搜索深度 (Search depth)
• 任何已知的 URL 或要优先检查的位置 (Any known URLs or locations to check first)

该智能体将自主执行 4 阶段发现算法：

1. 广泛发现 (Broad Discovery) — 跨平台并行搜索
2. 来源分类 (Source Triage) — 对来源进行分类和排序
3. 深度获取 (Deep Fetch) — 从顶级来源检索和提取
4. 发现报告 (Discovery Report) — 带有待解决问题的结构化输出

5. 呈现发现报告 (Present Discovery Report)

当智能体返回时，向用户呈现报告并附上摘要：

• 找到和分析的来源总数 (Total sources found and analyzed)
• 发现的关键品牌元素 (Key brand elements discovered)
• 来源之间的任何冲突 (Any conflicts between sources)
• 需要团队输入的待解决问题 (Open questions requiring team input)

6. 提供后续步骤 (Offer Next Steps)

呈现报告后，提供以下选项：

1. 立即生成指南 (Generate guidelines now) — 链接到 /brand-voice:generate-guidelines，使用发现报告作为输入
2. 先解决待解决问题 (Resolve open questions first) — 在生成之前处理高优先级问题
3. 保存报告 (Save report) — 将发现报告保存到 Notion 或作为本地文件
4. 扩大搜索 (Expand search) — 如果覆盖率低，搜索其他平台或进行更深层次的搜索

待解决问题 (Open Questions)

当发现智能体遇到无法解决的歧义时，会产生待解决问题：

• 冲突的文档（例如，2023 年样式指南 vs. 2024 年品牌更新）(Conflicting documents – e.g., 2023 style guide vs. 2024 brand update)
• 缺少关键部分（例如，未找到社交媒体指南）(Missing critical sections – e.g., no social media guidelines found)
• 跨平台术语不一致 (Inconsistent terminology across platforms)

每个待解决问题都包含智能体建议。将问题呈现为“确认或覆盖”——而非死胡同。

与其他技能的集成 (Integration with Other Skills)

• 指南生成 (Guideline Generation)：发现报告由 discover-brand 智能体通过 Task 工具返回。将其作为结构化输入直接传递给指南生成技能，取代用户手动收集来源的需求。
• 品牌声音执行 (Brand Voice Enforcement)：一旦根据发现生成了指南，执行过程将自动使用这些指南。

错误处理 (Error Handling)

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

参考文件 (Reference Files)

有关详细的发现模式和算法，请参考：

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