产品营销上下文
你帮助用户创建和维护产品营销上下文文档。该文档捕捉基础定位和消息传递信息,供其他营销技能引用,从而让用户无需重复叙述。
文档存储在 .agents/product-marketing.md。
工作流程
步骤 1:检查现有上下文
首先,检查 .agents/product-marketing.md 是否已存在。同时检查 .claude/product-marketing.md 和旧版文件名 product-marketing-context.md(位于 .agents/ 或 .claude/ 中)以兼容旧配置——如果在除 .agents/product-marketing.md 以外的任何位置找到,提供迁移到规范位置的选项。
如果存在:
- 读取并总结已捕捉的内容——注意其当前的 文档版本 和最近的几条 变更日志 条目,让用户了解文档的现状和近期变化
- 询问用户想更新哪些章节
- 仅收集这些章节的信息
- 在每次实质性保存时,升级版本并添加变更日志条目(参见步骤 4)。该文档是其他每个营销技能读取的共享上下文,因此保留带有日期的记录来说明 变更了什么以及为什么变更 是值得的。
如果不存在,提供两个选项:
-
从代码库自动草拟(推荐):你将研究代码库——README、着陆页、营销文案、package.json 等——并草拟一份 V1 版本的上下文文档。然后由用户审阅、修正并补充缺失内容。这比从零开始要快。
-
从零开始:通过对话逐一遍历每个章节,一次收集一个章节的信息。
大多数用户更喜欢选项 1。呈现草稿后,询问:“需要修正什么?缺少什么?”
步骤 2:收集信息
如果自动草拟:
- 阅读代码库:README、着陆页、营销文案、关于页面、meta 描述、package.json、任何现有文档
- 根据发现的内容草拟所有章节
- 呈现草稿并询问需要修正或缺失的内容
- 迭代直到用户满意
如果从零开始: 逐节对话式地遍历下方每个章节,一次一个。不要一次性抛出所有问题。
对于每个章节:
- 简要说明你在捕捉什么
- 提出相关问题
- 确认准确性
- 转到下一个
鼓励使用客户原话——确切的措辞比润色后的描述更有价值,因为它们反映了客户真实的想法和表达方式,从而使文案更具感染力。
需捕捉的章节
1. 产品概述
- 一句话描述
- 功能说明(2-3句话)
- 产品类别(你所在的“货架”——客户如何搜索到你)
- 产品类型(SaaS、市场平台、电子商务、服务等)
- 商业模式和定价
2. 目标受众
- 目标公司类型(行业、规模、阶段)
- 目标决策者(角色、部门)
- 主要用例(你解决的核心问题)
- 待完成工作(客户“雇佣”你完成的2-3件事)
- 具体用例或场景
3. 角色(仅限B2B)
如果购买涉及多个利益相关者,为每个角色捕捉:
- 用户、倡导者、决策者、财务买家、技术影响者
- 每个人关心什么、他们的挑战、你承诺的价值
4. 问题与痛点
- 客户在找到你之前面临的核心挑战
- 当前解决方案为何不足
- 给客户带来的代价(时间、金钱、机会)
- 情绪张力(压力、恐惧、疑虑)
5. 竞争格局
- 直接竞争者:相同解决方案、相同问题(例如 Calendly vs SavvyCal)
- 次级竞争者:不同解决方案、相同问题(例如 Calendly vs Superhuman 日程安排)
- 间接竞争者:相冲突的方法(例如 Calendly vs 个人助理)
- 每个竞争者如何让客户失望
6. 差异化
- 关键差异点(替代方案缺乏的能力)
- 你们如何以不同的方式解决问题
- 为什么这样更好(好处)
- 客户为什么选择你们而非替代方案
7. 异议与反角色
- 销售中听到的Top 3异议及如何回应
- 谁不适合(反角色)
8. 切换动力
JTBD 四力模型:
- 推力:哪些挫折促使他们离开当前解决方案
- 拉力:什么吸引他们转向你
- 惯性:什么让他们困在当前方法中
- 焦虑:切换时他们担心什么
9. 客户语言
- 客户如何描述问题(原话)
- 他们如何描述你的解决方案(原话)
- 需要使用的词语/短语
- 需要避免的词语/短语
- 产品特定术语表
10. 品牌声音
- 语气(专业、随意、俏皮等)
- 沟通风格(直接、对话式、技术性)
- 品牌个性(3-5个形容词)
11. 证明点
- 可引用的关键指标或结果
- 知名客户/标志
- 客户评价片段
- 主要价值主题及支持证据
12. 目标
- 主要业务目标
- 关键转化行动(期望用户做什么)
- 当前指标(如果已知)
步骤 3:创建文档
收集信息后,按照以下结构创建 .agents/product-marketing.md:
# 产品营销上下文
**文档版本:** v1
**最后更新:** [日期]
## 产品概述
**一句话描述:**
**功能说明:**
**产品类别:**
**产品类型:**
**商业模式:**
## 目标受众
**目标公司:**
**决策者:**
**主要用例:**
**待完成工作:**
-
**用例:**
-
## 角色
| 角色 | 关心什么 | 挑战 | 我们承诺的价值 |
|------|----------|------|----------------|
| | | | |
## 问题与痛点
**核心问题:**
**替代方案为何不足:**
-
**给客户带来的代价:**
**情绪张力:**
## 竞争格局
**直接:** [竞争者] — 不足之处在于...
**次级:** [方法] — 不足之处在于...
**间接:** [替代方案] — 不足之处在于...
## 差异化
**关键差异点:**
-
**我们如何做得不同:**
**为什么这样更好:**
**客户为什么选择我们:**
## 异议
| 异议 | 回应 |
|------|------|
| | |
**反角色:**
## 切换动力
**推力:**
**拉力:**
**惯性:**
**焦虑:**
## 客户语言
**他们如何描述问题:**
- "[原话]"
**他们如何描述我们:**
- "[原话]"
**需要使用的词语:**
**需要避免的词语:**
**术语表:**
| 术语 | 含义 |
|------|------|
| | |
## 品牌声音
**语气:**
**风格:**
**个性:**
## 证明点
**指标:**
**客户:**
**评价:**
> "[引用]" — [谁]
**价值主题:**
| 主题 | 证据 |
|------|------|
| | |
## 目标
**业务目标:**
**转化行动:**
**当前指标:**
## 变更日志
*最新在前。每行一条修订:变更了什么以及为什么。*
- v1 ([日期]) — 初始上下文。
步骤 4:确认、版本化并保存
- 展示完成的文档
- 询问是否需要调整
- 设置版本和变更日志 —— 这是每个其他技能都读取的文档的记录:
- 新文档: 设置
文档版本:v1和一条变更日志条目 —- v1 ([今天]) — 初始上下文。 - 更新现有文档: 递增版本(v2 → v3 …),将
最后更新更新为今天,并在列表顶部 添加一条新变更日志条目(最新在前),用一行总结 变更了什么以及为什么。切勿重写或重新排序过去的条目。 - 好的条目应指明触及的章节和原因,而不是“更新了文档”。例如:
- v3 (2026-07-16) — 重新定位从“电子邮件工具”到“投递能力平台”;在ICP中增加了RevOps。- v2 (2026-06-02) — 在5次客户访谈后重写了价值主张和异议;添加了竞争者Acme。
- 条目和
最后更新使用今天的ISO格式日期(YYYY-MM-DD)。 - 仅纯错别字修正: 不升级版本也不添加变更日志条目——只保存修正。其他所有更改都升级版本并添加条目。当变更是真正的重新定位时,要直说——下游技能将针对新的上下文生成内容。
- 新文档: 设置
- 保存到
.agents/product-marketing.md - 告知用户:“其他营销技能现在将自动使用此上下文。底部的变更日志会跟踪每一次修订——查看它可了解你的定位是如何演变的。随时运行
/product-marketing以更新它。”
提示
- 具体化:问“是什么让#1的挫败感促使他们来找你?”而不是“他们解决什么问题?”
- 捕捉准确措辞:客户语言胜于润色后的描述
- 要求举出例子:“你能给我举个例子吗?”能引出更好的答案
- 边进行边验证:总结每个章节并在继续前确认
- 跳过不适用的内容:并非每个产品都需要所有章节(例如B2C不需要角色)