brand-context

品牌背景

为每个品牌创建并维护一个 brand-context.md 文件：它是有关企业销售什么、卖给谁、如何沟通以及能提供哪些证明的唯一事实来源。本合集中的其他所有技能都会在向用户询问品牌相关问题前读取此文件，因此用户只需解释一次业务，而不是每项任务都解释一次。

这是中心辐射模型中的枢纽。广告文案、博客文章、冷邮件、社交内容和落地页工作都基于相同的定位和语气；将这些内容统一保存在一份持续维护的文档中，每项下游技能都能从一开始就掌握背景，并保持一致。

文件约定。 文档保存在持久存储中的固定路径 /files/<brand-slug>/brand-context.md，每次都在同一位置复用。创建一次后，在原文件中更新；如果文件已存在，切勿从头重新创建（否则会丢失用户整理的客户原话和证明材料）。如果某次运行修改了文档，请更新 Last updated 行。

要求

• 已连接 Hyper MCP。 https://app.hyperfx.ai/mcp — 文件工具需要它来持久保存文档，也用于自动起草。
• 建议启用自动起草功能： 前往 https://app.hyperfx.ai/apps 启用 Firecrawl（读取品牌网站并提取视觉识别信息）。如果未启用，请跳过自动起草并采用访谈流程——此技能仍然可用。
• 可选补充信息： customer-research 使用的 Apify 抓取工具（客户原话）和 HyperSEO（竞争格局）。两者都属于锦上添花；任何缺少真实数据支持的章节都应标记为未验证，而不是编造内容。

如何运行此技能中的工具

此技能中的每个工具都使用其规范名称。请按照你所用界面提供的调用方式运行：

界面	查找工具	运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")，然后 describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"，然后 hyperai describe <name>	hyperai call <name> --json '{...}'

如果找不到某个工具，说明其集成尚未连接或未在工作区中启用：请停止并告知用户需要连接哪个集成。

工具范围

任务	工具
读取、创建、更新 brand-context.md	文件工具（read_file、create_file、edit_file）
根据品牌网站自动起草	firecrawl_urls_scrape（首页、关于、定价、产品页面），备用工具为 web_pages_scrape
视觉识别信息（颜色、徽标、字体）	firecrawl_branding_extract
客户原话（可选）	转交给 customer-research
竞争格局（可选）	转交给 competitor-intel、seo-research

不在此技能范围内：转交给其他技能

请求	转交给
深入挖掘客户之声（Reddit、评论、社交媒体）	customer-research
全面的竞争对手研究、竞争对比资料、监控	competitor-intel
博客主题策略和已发布文章日志	blog-generation（其 blog-strategy.md 中的 Brand brief 应基于此文档填充，而不是重新编写）
提取用于图像生成的品牌素材	ad-creative-generation（在创意制作时使用 firecrawl_branding_extract）
关键词或 SERP 研究	seo-research

文档

包含各章节指引的完整模板位于 references/brand-context-template.md。章节按以下顺序排列：

1. 产品概览 — 产品是什么、做什么、所属类别，以及一句话介绍。
2. 目标受众 / ICP — 具体客户、公司或人口统计特征，以及产品不适合哪些人。
3. 用户画像 — 2–4 个买家 / 用户画像，包括角色、触发因素和成功标准。
4. 痛点 — 推动购买的问题，按优先级排序。
5. 竞争格局 — 直接和间接替代方案，包括“什么都不做” / 电子表格 / 维持现状。
6. 差异化 — 客户为何选择该品牌而非各种替代方案；只有该品牌能提出的主张。
7. 异议与转换 — 什么因素会拖延交易、潜在客户担心什么，以及转换会让他们付出什么代价。
8. 客户语言 — 原话引用：客户如何用自己的话描述问题和产品。这是文档中最有价值的部分。
9. 品牌语调 — 语气、阅读难度、视角、推荐用词和禁用词。
10. 证明材料 — 真实数据、具名客户、资质、数据。这里只能包含已核实的内容。
11. 目标与当前重点 — 营销本季度要推动什么，以及优先渠道。
12. 素材与渠道 — 网站 URL、博客、社交媒体账号、正在使用的广告账户、视觉形象说明。

编写文档

步骤 0：检查是否已有文档。 在品牌对应路径（以及合理的旧路径）下查找 brand-context.md。如果存在，则本次为更新：完整阅读，然后只修改用户要求变更的章节，或与新证据相矛盾的章节。只有在不存在任何文档时，才从头编写。

路径 A — 自动起草（品牌有网站时的默认方式）。

1. 如果还不知道网站 URL，先询问。
2. 使用 firecrawl_urls_scrape 抓取关键信息页面：主页、关于页面、定价页面、1–2 个产品 / 功能页面，以及存在时包含推荐语或案例研究的客户页面。
3. 可选：调用一次 firecrawl_branding_extract，补充第 12 节的视觉形象说明。
4. 为有真实证据支持的所有章节起草内容。对于网站未提及的内容（异议、目标、大部分客户语言），将章节标记为 *(unverified — needs input)*，不要猜测。
5. 保存前，按章节向用户展示草稿并征求修改意见。 网站呈现的是品牌希望成立的事实；用户了解的才是实际情况。请重点询问：ICP（“实际是谁在购买？”）、差异化（“人们为什么选择你而不是 X？”）以及证明材料（“这些数据中哪些真实且仍然有效？”）。
6. 保存到 /files/<brand-slug>/brand-context.md，并告知用户路径。

路径 B — 访谈（没有网站、尚未发布，或用户更愿意交流时）。 按照 references/brand-context-template.md 中给出的顺序，以对话形式逐次讨论几个章节，而不是一次性提出一大堆问题。从产品概览和 ICP 开始（其他内容都以此为基础），并允许用户跳过章节；诚实的不完整文档胜过塞满内容的完整文档。逐步保存，这样即使访谈中断，也能留下可用的文档。

**无论采用哪种路径，保存前：**都要执行下方的质量检查。

质量门槛

• 绝不编造任何内容。 切勿杜撰客户引言、统计数据、竞争对手的说法或用户画像细节。标注为“需要输入”的空白部分才是正确做法；看似合理的杜撰内容会造成严重危害——下游技能会信心十足地在广告和邮件中重复这些内容。
• 逐字引用就必须一字不差。 客户用语必须精确引用客户说过或写过的内容，并注明来源（评论、通话、Reddit 帖子）。润色后的转述应放在定位部分，而不是第 8 部分。
• 具体胜过面面俱到。 “在电商领域、拥有 20–200 名员工、正被承运商电子表格淹没的运营经理”很有用；“想节省时间的企业”则是凑数。删掉凑数内容。
• 验证证据数据。 只使用用户确认过的数字和名称。注明日期（“截至 2026 年 6 月，有 2,400 名客户”）。
• 一句话描述须通过陌生人测试。 用一句陌生人也能复述的话，说明类别、受众和核心价值。

其他技能如何使用本文档（协作约定）

当任何营销技能需要品牌背景信息——定位、受众、语气、证据时：

1. 先检查 brand-context.md：在询问用户任何品牌问题之前，先查看 /files/<brand-slug>/brand-context.md。如果文件存在，请完整阅读，并且只询问任务需要、但文档未涵盖的内容。
2. 遵循语气部分的要求——可用词语／禁用词语列表是生成文案时必须遵守的硬性约束。
3. 从客户用语中提取吸引点——第 8 部分中的逐字短语比杜撰的文案更有效；撰写标题、主题行和开场白时优先使用这些短语。
4. 绝不引用第 10 部分中没有的证据数据。 如果文档没有支持某项主张的证据，文案就不能提出该主张。
5. 检查时效性。 如果 Last updated 距今超过约 6 个月，请指出并建议更新，但不要在任务中途悄悄重建文档。
6. 不要写回任何内容。 其他技能只读取；只有此技能会与用户一起写入。如果任务中发现适合加入文档的内容——例如出色的客户引言或新的竞争对手——请建议用户运行 brand-context 将其添加进去。

维护文档

本文档会持续更新。当定位发生变化、出现重要的新竞争对手、定价变更，或研究（来自 customer-research／competitor-intel）带来更有价值的引言和市场数据时，请更新文档。执行更新时：先阅读，只修改变更之处，保留用户整理的所有内容，更新 Last updated，并向用户概述差异。对于多个品牌，请在各自的 <brand-slug> 目录下为每个品牌保留一份文档——切勿在同一个文件中混合多个品牌。

参考资料

• references/brand-context-template.md：完整的可直接复制粘贴的文档模板、各部分的优质内容撰写指南，以及 Path B 的访谈问题库。