product-marketing-context

概览

这个技能的作用

product-marketing-context 技能帮助你为项目创建并维护一份统一、可复用的产品营销上下文文档。

你无需在每个新任务中反复解释自己的产品、受众和定位，这个技能会通过结构化问卷引导你梳理信息，并将结果保存到：

• .agents/product-marketing-context.md

其他兼容的营销技能和 agents 会读取这个文件来了解你的产品，从而生成始终保持统一调性的内容、活动和发布物料。

适用人群

在以下情况下，建议使用 product-marketing-context：

• 创始人 或 产品负责人，首次系统梳理产品故事
• 产品营销 或 市场负责人，希望不同活动之间的 messaging 保持一致
• 开发者，在搭建一套共享上下文文件的营销技能与 agents 系统

在以下类型的工作中尤其有用：

• 持续性的 内容营销（博客、邮件、广告、落地页等）
• 产品发布 与分层/套餐更新
• 产品定位或 ICP / 人物角色 优化与迭代

解决的问题

product-marketing-context 技能主要用来解决这些反复出现的问题：

• 在不同对话中一遍遍重复产品介绍和目标受众信息
• 不同 agents 或技能之间的 messaging 不一致
• 产品营销笔记散落在多个文件中，难以统一管理
• 定位文档难以维护、长期不更新

通过将这些内容集中沉淀到 .agents/product-marketing-context.md，你会得到一份持续更新的活文档，涵盖：

• 产品概览与价值主张
• 目标受众与 ICP（理想客户画像）
• 参与购买决策的 personas 与角色
• 你解决的问题与 jobs-to-be-done
• 竞争格局与差异化
• 潜在客户异议、迁移成本与证明点
• 客户常用语言、品牌语气与营销目标

适用与不适用的场景

适合使用 product-marketing-context 的情况：

• 你在启动一个 新项目，希望在使用其他营销技能前打好基础
• 你调整了价格、分层或目标受众（例如新增企业版或新的买方角色）
• 你在搭建需要共享上下文的 AI 驱动营销工作流

不太适合的情况：

• 你只需要一次性的文案输出，并不打算复用上下文
• 你的产品还处于非常早期阶段，对产品几乎没有清晰认知（可以先手动勾勒基础信息，再运行此技能）

如果你打算做不止一个营销相关任务，先安装并使用 product-marketing-context 通常会很快见效。

使用方式

安装

要在你的环境中添加 product-marketing-context 技能，运行：

npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context

这会从 coreyhaines31/marketingskills 仓库中拉取 product-marketing-context 技能，并与来自同一来源的其他技能一起供你使用。

安装完成后，你可以在编辑器中直接打开技能文件，了解其行为并按需调整自己的工作流：

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

核心工作流

product-marketing-context 技能围绕是否已存在上下文文件，设计了一个清晰的双路径工作流。

1. 检查是否已有上下文

被调用时，技能首先会检查是否存在上下文文档：

• 主路径：.agents/product-marketing-context.md
• 旧版路径：.claude/product-marketing-context.md（用于较早配置）

如果只在 .claude/ 下发现旧文件，技能会引导你将其迁移或升级到 .agents/，以保持结构一致。

2. 当上下文文件已存在

如果 .agents/product-marketing-context.md 已经存在，技能会：

1. 读取并总结当前内容
2. 询问你想更新哪些部分（例如 Target Audience、Personas 或 Differentiation）
3. 只针对你选择的部分进行引导，无需重新回答全部内容

这样就可以方便地进行增量更新，例如：

• 扩展目标受众（如新增 VP of Engineering 角色）
• 添加新的方案或套餐（如 enterprise 计划）
• 更新证明点、logo 或案例研究

3. 当上下文文件不存在

若未找到上下文文件，技能会提供两条路径：

1. 从 codebase 自动生成初稿（推荐）

   • 技能会检查你的仓库（如 README、落地页、营销文案、package.json 等）
   • 基于这些信息草拟一版产品营销上下文初稿
   • 你再对这版 V1 草稿进行审阅、修正和补充

2. 从零开始

   • 技能会以对话形式，逐段引导你完成各个部分
   • 你回答关于产品、受众和定位的针对性问题

在这两种情况下，流程完成后，技能都会将最终文档写入：

• .agents/product-marketing-context.md

上下文文件包含的版块

product-marketing-context 创建的上下文文件围绕一系列实用、可复用的版块结构。根据附带的评估配置，该技能预期在适用的情况下至少覆盖以下方面：

• Product Overview – 你卖什么，它做什么，适合谁
• Target Audience – 你的 ICP、角色、行业以及公司规模
• Personas – 核心干系人，例如 Product Managers、VPs、创始人或买方角色
• Problems You Solve – 痛点、jobs-to-be-done 和典型用例
• Competitive Landscape – 你的竞品是谁，买家如何看待替代方案
• Differentiation – 你的产品在哪些方面真正有差异
• Objections – 潜在客户犹豫或拒绝的常见原因
• Switching Dynamics – 用户迁移到你这边需要发生什么
• Customer Language – 客户实际使用的常用短语、表述和词汇
• Brand Voice – 你在各个渠道希望呈现的品牌语气
• Proof Points – 客户证言、核心指标、社会背书和案例研究
• Goals – 对你的营销和 go-to-market 来说，成功表现为何

并不是每个产品都必须填满所有版块，但技能会尽可能覆盖所有适用部分，并在信息缺失的地方主动提示你补充。

在工作流中使用上下文

一旦 .agents/product-marketing-context.md 文件生成，你可以：

• 在运行其他 营销相关技能 时引用它，让大家对你的产品形成统一理解
• 将其纳入代码仓库的版本管理，跟踪产品定位的演变
• 作为新同事或合作伙伴的内部“单一事实来源”文档

由于文件路径固定，以下场景会特别方便：

• marketingskills 集合中的其他 agents
• 你自定义的工具或脚本

……都可以轻松加载这个文件，在统一的产品营销基础上工作。

推荐查看的文件与目录

若想更深入理解或自定义此技能，可以从以下文件入手：

• SKILL.md – 核心技能定义、描述和工作流细节
• evals/evals.json – 示例提示与预期行为，便于理解技能在真实场景中的响应方式

你可以根据自己的仓库结构和自动化工具，调整技能的调用方式，或者与其他技能进行串联。

常见问题（FAQ）

用一句简单的话解释，product-marketing-context 是什么？

product-marketing-context 是一个引导式助手，帮你创建一份结构化的产品营销文档（保存在 .agents/product-marketing-context.md），系统梳理产品、受众、定位和关键信息传递，以便其他技能和 agents 直接复用。

如何安装 product-marketing-context？

从 coreyhaines31/marketingskills 仓库安装：

npx skills add https://github.com/coreyhaines31/marketingskills --skill product-marketing-context

安装后，你可以打开 product-marketing-context 目录下的 SKILL.md，查看完整工作流说明。

上下文文档存在哪里？

默认情况下，技能会在以下位置创建并维护你的产品营销上下文：

• .agents/product-marketing-context.md

它也可以检测旧配置中位于 .claude/product-marketing-context.md 的文件，并引导你迁移到 .agents/。

如果我已经有一个 product-marketing-context 文件会怎样？

如果 .agents/product-marketing-context.md 已存在，技能会：

1. 读取并总结当前内容
2. 询问你希望修改哪些部分
3. 只针对这些部分收集新信息

这样你就不必重复回答已经记录过的问题。

product-marketing-context 能在产品变化时帮我更新上下文吗？

可以。这个技能专门支持增量更新。例如当你：

• 新增 enterprise 等高级套餐
• 将目标受众扩展到新角色（如新增 VP of Engineering）
• 调整差异化主张或证明点

……你只需再次调用该技能，它会帮助你有选择地更新 .agents/product-marketing-context.md 中相关的部分。

这个技能会自动从代码仓里帮我起草内容吗？

会。当前没有上下文文件时，product-marketing-context 提供 auto-draft from codebase 选项。在该模式下，它会根据仓库中的可用资料（如 README、营销文案或 package 元数据）生成一版初稿，由你再进行优化完善。

product-marketing-context 如何与其他营销技能配合？

你配置中的其他营销类技能可以读取 .agents/product-marketing-context.md，以便：

• 理解你的产品和 ICP
• 复用你的品牌语气和 messaging
• 与既定的定位和目标保持一致

通常，你会在新项目一开始先运行 product-marketing-context，然后在生成邮件、落地页、发布公告或其他资产时，统一基于这份共享上下文文件。

product-marketing-context 对开发者有什么用？

很有用。正在搭建多技能工作流的开发者，可以把 .agents/product-marketing-context.md 当作单一来源的真相文档：

• 保存在代码仓中
• 易于程序化读取和解析
• 让所有营销相关技能始终对齐

在更复杂的自动化系统中，当多个 agents 都需要一致的产品与受众信息时，这尤其实用。

想理解或自定义这个技能，我应该看哪些文件？

建议从以下文件开始：

• SKILL.md – 说明 product-marketing-context 的用途及其工作流
• evals/evals.json – 展示示例 prompts 和预期输出，帮助你理解技能在真实场景中的表现

然后，你可以根据自己的仓库结构和营销流程，调整它的调用方式，或与其他技能进行编排和串联。