product-marketing-context

product-marketing-context 技能概览

product-marketing-context 是做什么的

product-marketing-context 技能用于创建并维护一个共享的产品营销源文件，路径为 .agents/product-marketing-context.md。它的作用很直接，但非常实用：把产品概述、目标受众、定位、常见异议、证据点和基础 messaging 一次性沉淀下来，供后续其他营销工作流反复复用，而不是每次都从头回答同样的基础问题。

谁适合使用这个技能

这个技能特别适合创始人、产品营销负责人、增长负责人，以及需要在 repo 或客户项目中重复开展 AI 辅助营销工作的代理机构团队。如果你希望在定位、ICP 梳理、落地页初稿、活动规划、销售赋能内容等任务中保持更好的信息一致性，它会尤其有帮助。

它真正解决的问题是什么

大多数团队并不缺“更多文案”，真正缺的是一个在模型开始写作前可稳定引用的上下文层。product-marketing-context skill 正是为这个准备步骤设计的。它会先产出一个可复用的营销上下文文档，再让其他技能在此基础上继续展开。

为什么它比通用提示词更好

普通提示词当然也可以要求模型输出定位内容，但通常只能得到一次性的回答。product-marketing-context 的设计更偏流程化，重点在于：

• 先检查是否已经存在 context 文件
• 只更新发生变化的部分
• 支持基于代码仓库自动起草，或通过引导式问答从零开始
• 把结果保存到其他技能可稳定引用的固定路径

因此，它比泛泛的“帮我做 messaging”提示词更适合落地执行。

最适合与不太适合的使用场景

最适合：

• 新产品还没有成型的 messaging 基础
• 一个 repo 中会配合使用多个 AI 营销技能
• 团队在发布后、改价后或目标受众变化后更新定位

不太适合：

• 一次性的文案任务，而且你并不想保留长期上下文
• 没有可访问 repo 或产品材料可供分析的产品
• 希望仅靠这个技能完成深入市场研究的团队

如何使用 product-marketing-context 技能

安装上下文与文件存放位置

如果你的环境支持 Skills 安装，把父级仓库加入后即可使用其中的 product-marketing-context 技能。这个技能围绕的核心输出文件是：

/.agents/product-marketing-context.md

对于较早的配置方式，技能也会检查 .claude/product-marketing-context.md，并可协助你把其中内容迁移到新的位置。

先检查是否已有现成的 context 文件

在创建任何新内容之前，推荐的工作流是先查找：

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

如果 context 文件已经存在，正确做法不是“全部重写”。而是先读一遍，概括其中已经沉淀了什么，再只更新受用户变更影响的部分。

选择正确的初始化路径

仓库里展示了两种非常实际的入口方式：

1. 基于代码仓库自动起草
   当 repo 中有足够可用信号时推荐使用，比如 README.md、落地页文案、文档、package.json，或产品应用内文案。

2. 从零开始
   当 repo 信息较薄、私有材料比代码更重要，或者产品本身还在定义阶段时，这条路径更合适。

这是 product-marketing-context guide 里一个非常关键的落地细节：只有根据证据质量选择匹配路径，结果才会更可靠。

product-marketing-context 需要哪些输入

想让输出真正有用，至少需要提供：

• 产品是什么
• 面向谁
• 解决的核心问题是什么
• 与替代方案相比有何不同
• 当前有哪些证据点或现实约束
• 这次是首版草稿还是已有内容更新

额外有帮助的输入包括：

• 定价层级变化
• 新增 persona
• 赢单 / 丢单模式
• 来自访谈或评论的客户原话
• 品牌语气偏好
• 销售异议
• 发布目标或季度目标

这个技能要构建的核心章节

结合仓库中的 evals 和工作流来看，product-marketing-context usage 一般会覆盖如下章节：

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

这个结构本身很重要，因为它产出的不是一段定位文案，而是一个可长期维护的 context 文件。

如何把模糊需求变成高质量提示

较弱的写法：

Help me with product marketing.

更好的写法：

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

适合更新场景的最佳写法：

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

一套能减少拍脑袋判断的实用工作流

推荐的操作顺序是：

1. 检查是否已有现成的 context 文件。
2. 判断应走自动起草还是引导式访谈。
3. 按章节构建或更新 context 文件。
4. 标记假设和证据缺口。
5. 与用户一起复核并修正。
6. 保存到 .agents/product-marketing-context.md。
7. 在后续营销任务中反复复用该文件。

这也是为什么建议在项目早期就完成 product-marketing-context install：它能显著减少后续重复搭建上下文的成本。

优先先看这些仓库文件

如果想快速评估，先从下面两个文件开始：

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

SKILL.md 解释的是具体执行工作流。evals/evals.json 的价值在于，它展示了“正确使用方式”在真实提示场景中的样子，包括产品变化后的更新用法。

什么因素会显著提升输出质量

最好的输出来自证据，而不是愿景。如果你想拿到更强的 context 文档，就应把技能指向这些材料：

• 官网首页或落地页文案
• 产品文档与 onboarding 文案
• demo 记录或转录笔记
• 定价与套餐说明
• 客户访谈原话
• 团队实际使用的竞品对比
• 销售通话中的异议
• 现有品牌指南

如果缺少这些材料，草稿仍然可能可用，但其中会包含更多泛化假设。

对首版草稿应有什么预期

用 product-marketing-context 生成的 V1 应该被视为工作文档，而不是最终定稿。最有价值的首版通常具备这些特点：

• 把已确认事实与推断出的定位清楚区分开
• 暴露证据点不足或受众定义不清的缺口
• 为后续 AI 营销任务提供足够稳定的一致性框架

如果你想要更成熟、可直接对外使用的战略 messaging，通常要在首版文件生成后再做一轮复核。

product-marketing-context 技能常见问题

product-marketing-context 适合新手吗？

适合。它对新手友好的原因在于流程非常明确：先检查现有文件，再选择自动起草或引导式搭建，然后补齐具体章节。即使你不熟悉正式的 PMM 框架，也能做出一个可用的第一版。

什么时候应该用 product-marketing-context，而不是普通提示词？

当你希望同一套上下文被多个任务复用时，就应该用它。如果你的目标只是写一个落地页标题，普通提示词可能已经够用；但如果你的目标是在大量输出中保持 messaging 一致性，那么 product-marketing-context for Product Marketing 会是更好的基础设施。

它能更新现有 context，而不是重新创建吗？

可以。这正是它的核心行为之一。这个技能会读取已有的 .agents/product-marketing-context.md，先总结现有内容，再只修改那些受到新信息影响的章节。

它会替我完成市场研究吗？

不完全会。它可以从 repo 和产品材料中推断出很多内容，但它并不能替代真实的客户研究。如果你的证据基础偏弱，输出在结构上依然会有帮助，但战略深度会明显不足。

如果我的 repo 几乎没有营销文案怎么办？

那就走从零开始的路径，以对话方式回答问题。相比强行从一个信息稀薄、几乎看不出客户、异议和购买语境的代码仓库里自动起草，这样通常更靠谱。

product-marketing-context 只有在这个 repo 生态里才有用吗？

当它与其他会引用 .agents/product-marketing-context.md 的营销技能配合使用时，价值确实最大；但这个文件本身是可移植的。即使不处在完整技能生态内，你依然可以把它当作自己的标准 PMM brief 来使用。

什么时候这个技能不适合用？

在以下情况下建议跳过：

• 你只需要一次性的单条文案输出
• 团队不会持续维护共享的 context 文件
• 产品目前还过于模糊，连最基本的受众和问题定义都答不上来

如何改进 product-marketing-context 技能的使用效果

给技能提供证据，而不只是目标

提升 product-marketing-context skill 质量最有效的方式，是提供更好的源材料。仅仅说“我们想要更强的定位”远远不够。你应该提供这类原始输入：

• homepage 文案
• 客户通话记录
• 销售最常遇到的异议
• 客户为何转用你的产品
• 功能到收益的解释
• 带数字的证据点

这样模型才能基于材料锚定判断，而不是自行脑补。

明确说明到底变了什么

在做更新时，如果实际只变了两件事，就不要笼统要求“整体刷新”。要明确告诉模型新增了什么：

• 新的 pricing tier
• 扩展后的 ICP
• 重命名后的品类
• 更强的 enterprise 侧重
• 新出现的竞品压力

这样技能才能准确修改对应章节，而不会误伤原本仍然正确的 messaging。

要求模型标注假设

一个很常见的失败模式是：模型在悄悄猜，但没有告诉你哪里在猜。想提升输出质量，可以明确要求它标记：

• 已确认事实
• 高概率推断
• 缺失输入
• 待确认问题

这样首版草稿会更容易审核，也更容易继续迭代。

按章节审阅，最终结果会更好

不要等整份文档写完后才第一次审阅。最值得优先确认的高价值章节是：

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

这些部分一旦错了，后面基于该文件生成的 messaging 也会一路跑偏。

强化 customer language 的采集

常见薄弱点之一，是措辞太泛、太像内部视角。要让 product-marketing-context guide 在实际使用中效果更好，尽量输入客户在这些场景下的真实表达：

• 访谈
• support tickets
• 评论网站
• 销售通话
• onboarding 反馈

真实客户语言会显著提升后续文案的相关性和说服力。

留意这些常见失败模式

典型问题包括：

• 把功能清单伪装成定位
• ICP 过于宽泛
• 对“竞品”的描述模糊，导致差异化很弱
• 品牌语气很理想化，却没有示例支撑
• 所谓 proof points 只是口号，不是证据

如果你看到这些问题，应该先回头补强源输入，而不是立刻要求整篇重写。

用有针对性的追问来迭代

拿到第一版后，建议使用更聚焦的提示继续打磨，例如：

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

这种定向迭代，通常比要求“整篇重写”更快、更有效。

把 product-marketing-context 当作持续维护的活文件

product-marketing-context 的最佳长期用法，不是一次性初始化，而是持续维护。当产品、受众、定价、品类定义或销售方式发生变化时，就应该回头更新这个文件。这样所有后续营销任务才能始终基于当前现实，而不是过时假设。