Back to Details

discover-brand

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Brand Discovery

品牌素材发现

Orchestrate autonomous discovery of brand materials across enterprise platforms. This skill coordinates the discover-brand agent to search connected platforms (Notion, Confluence, Google Drive, Box, Microsoft 365, Figma, Gong, Granola, Slack), triage sources, and produce a structured discovery report with open questions.
在多个企业平台中自动协调品牌素材的发现工作。该Skill会协调discover-brand agent搜索已连接的平台（Notion、Confluence、Google Drive、Box、Microsoft 365、Figma、Gong、Granola、Slack），对来源进行分类筛选，并生成带有待解决问题的结构化发现报告。

Discovery Workflow

发现工作流程

0. Orient the User

0. 向用户说明流程

Before starting, briefly explain what's about to happen so the user knows what to expect:
"Here's how brand discovery works:
  1. Search — I'll search your connected platforms (Notion, Google Drive, Slack, etc.) for brand-related materials: style guides, pitch decks, templates, transcripts, and more.
  2. Analyze — I'll categorize and rank what I find, pull the best sources, and produce a discovery report with what I found, any conflicts, and open questions.
  3. Generate guidelines — Once you've reviewed the report, I can generate a structured brand voice guideline document from the results.
  4. Save — Guidelines are saved to 
    .claude/brand-voice-guidelines.md
    in your working folder once you approve them. Nothing is written until that step.
The search usually takes a few minutes depending on how many platforms are connected. Ready to get started?"
Wait for the user to confirm before proceeding. If they have questions about the process, answer them first.
开始之前，简要说明即将进行的操作，让用户了解预期：
"品牌素材发现的流程如下：
  1. 搜索 — 我将在您已连接的平台（Notion、Google Drive、Slack等）中搜索品牌相关素材：风格指南、演示文稿、模板、对话记录等。
  2. 分析 — 我会对找到的内容进行分类和排序，提取最优来源，并生成一份包含发现结果、冲突点和待解决问题的发现报告。
  3. 生成指南 — 您审核报告后，我可以根据结果生成结构化的品牌语调指南文档。
  4. 保存 — 您批准后，指南将保存到工作目录下的
    .claude/brand-voice-guidelines.md
    文件中。在这一步之前不会进行任何写入操作。
搜索时间通常需要几分钟，具体取决于已连接平台的数量。准备好开始了吗？"
等待用户确认后再继续。如果用户对流程有疑问，先解答疑问。

1. Check Settings

1. 检查设置

Read 
.claude/brand-voice.local.md
if it exists. Extract:
  • Company name
  • Which platforms are enabled (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"
If no settings file exists, proceed with all connected platforms and standard search depth.
如果存在
.claude/brand-voice.local.md
文件，请读取该文件并提取以下信息：
  • 公司名称
  • 已启用的平台（notion、confluence、google-drive、box、microsoft-365、figma、gong、granola、slack）
  • 搜索深度偏好（标准或深度）
  • 最大来源数量限制
  • “已知品牌素材”部分列出的所有已知品牌素材位置
如果没有设置文件，则默认使用所有已连接平台和标准搜索深度。

2. Validate Platform Coverage

2. 验证平台覆盖范围

Before confirming scope, check which platforms are actually connected and classify them:
Document platforms (where brand guidelines, style guides, templates, and decks live):
  • Notion, Confluence, Google Drive, Box, Microsoft 365 (SharePoint/OneDrive)
Supplementary platforms (valuable for patterns, but not where brand docs are stored):
  • Slack, Gong, Granola, Figma
Apply these rules:
  1. If zero document platforms are connected: Stop. Tell the user: "You don't have any document storage platforms connected (Google Drive, SharePoint, Notion, Confluence, or Box). Brand guidelines and style guides almost always live on one of these. Please connect at least one before running discovery. Gong/Granola/Slack transcripts are valuable supplements but unlikely to contain formal brand documents."
  2. If no Google Drive AND no Microsoft 365 AND no Box: Warn (but proceed): "None of your primary file storage platforms (Google Drive, SharePoint, Box) are connected. Brand documents frequently live on these platforms. Discovery will proceed with [connected platforms], but results may have significant gaps. Consider connecting Google Drive or SharePoint."
  3. If only one platform total is connected: Warn (but proceed): "Only [platform] is connected. Discovery works best with 2+ platforms for cross-source validation. Results from a single platform will have lower confidence scores."
确认搜索范围之前，检查实际已连接的平台并进行分类：
文档平台（品牌指南、风格指南、模板和演示文稿的存储位置）：
  • 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. Confirm Scope with User

3. 与用户确认搜索范围

Before launching discovery, confirm:
  • Which platforms to search (default: all connected)
  • Whether to include conversation transcripts (Gong, Granola) or just documents
  • Any known locations to prioritize
Keep this brief — one question, not a questionnaire.
启动发现操作之前，确认以下内容：
  • 需要搜索的平台（默认：所有已连接平台）
  • 是否包含对话记录（Gong、Granola）还是仅搜索文档
  • 需要优先搜索的已知位置
请保持简洁——只需一个问题，而非问卷形式。

4. Delegate to Discover-Brand Agent

4. 委托给Discover-Brand Agent

Launch the discover-brand agent via the Task tool. Provide:
  • Company name (from settings or user input)
  • Enabled platforms
  • Search depth
  • Any known URLs or locations to check first
The agent executes the 4-phase discovery algorithm autonomously:
  1. Broad Discovery — parallel searches across platforms
  2. Source Triage — categorize and rank sources
  3. Deep Fetch — retrieve and extract from top sources
  4. Discovery Report — structured output with open questions
通过Task工具启动discover-brand agent，并提供以下信息：
  • 公司名称（来自设置文件或用户输入）
  • 已启用的平台
  • 搜索深度
  • 需要优先检查的已知URL或位置
Agent将自主执行四阶段发现算法：
  1. 广泛发现 — 跨平台并行搜索
  2. 来源筛选 — 对来源进行分类和排序
  3. 深度提取 — 检索并提取顶级来源的内容
  4. 生成发现报告 — 生成包含待解决问题的结构化输出

5. Present Discovery Report

5. 呈现发现报告

When the agent returns, present the report to the user with a summary:
  • Total sources found and analyzed
  • Key brand elements discovered
  • Any conflicts between sources
  • Open questions requiring team input
Agent返回结果后，向用户呈现报告并附带摘要：
  • 找到并分析的来源总数
  • 发现的关键品牌元素
  • 来源之间的冲突点
  • 需要团队输入的待解决问题

6. Offer Next Steps

6. 提供后续操作选项

After presenting the report, offer:
  1. Generate guidelines now — chain to 
    /brand-voice:generate-guidelines
    using discovery report as input
  2. Resolve open questions first — work through high-priority questions before generating
  3. Save report — store the discovery report to Notion or as a local file
  4. Expand search — search additional platforms or deeper if coverage is low
呈现报告后，提供以下选项：
  1. 立即生成指南 — 将发现报告作为结构化输入传递给
    /brand-voice:generate-guidelines
  2. 先解决待解决问题 — 在生成指南之前先处理高优先级问题
  3. 保存报告 — 将发现报告存储到Notion或本地文件
  4. 扩展搜索 — 如果覆盖范围较低，搜索更多平台或进行深度搜索

Open Questions

待解决问题

Open questions arise when the discovery agent encounters ambiguity it cannot resolve:
  • 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
Every open question includes an agent recommendation. Present questions as "confirm or override" — not dead ends.
当发现Agent遇到无法解决的歧义时，会产生待解决问题：
  • 冲突文档（例如2023版风格指南与2024版品牌更新文档）
  • 缺失关键章节（例如未找到社交媒体指南）
  • 跨平台术语不一致
每个待解决问题都包含Agent的建议。将问题以“确认或修改”的形式呈现，而非直接终止流程。

Integration with Other Skills

与其他Skill的集成

  • Guideline Generation: The discovery report is returned by the discover-brand agent via the Task tool. Pass it directly to the guideline-generation skill as structured input, replacing the need for users to manually gather sources.
  • Brand Voice Enforcement: Once guidelines are generated from discovery, enforcement uses them automatically.
  • 指南生成：发现报告由discover-brand agent通过Task工具返回。可直接将其作为结构化输入传递给指南生成Skill，无需用户手动收集来源。
  • 品牌语调执行：根据发现结果生成指南后，执行环节将自动使用这些指南。

Error Handling

错误处理

  • If zero platforms are connected, inform the user which platforms the plugin supports and how to connect them.
  • If all searches return empty results, flag the discovery as "low coverage" and suggest the user provide documents manually or check platform connections.
  • If a platform is connected but returns permission errors, note the gap and continue with other platforms.
  • 如果未连接任何平台，告知用户插件支持的平台以及连接方法。
  • 如果所有搜索都返回空结果，标记发现操作“覆盖范围低”，并建议用户手动提供文档或检查平台连接情况。
  • 如果平台已连接但返回权限错误，记录该遗漏并继续使用其他平台进行操作。

Reference Files

参考文件

For detailed discovery patterns and algorithms, consult:
  • references/search-strategies.md
     — Platform-specific search queries, query patterns by platform, and tips for maximizing discovery coverage
  • references/source-ranking.md
     — Source category definitions, ranking algorithm weights, and triage decision criteria
如需了解详细的发现模式和算法，请参考：
  • references/search-strategies.md
     — 平台特定搜索查询、各平台的查询模式以及最大化发现覆盖范围的技巧
  • references/source-ranking.md
     — 来源类别定义、排序算法权重和筛选决策标准