product-marketing-context

概觀

這個技能的用途

product-marketing-context 技能協助你為專案建立並維護一份單一、可重複使用的產品行銷情境文件。

你不需要在每一個新任務裡重新解釋產品、受眾與定位。這個技能會透過結構化問卷一步步引導你，並將結果儲存到：

• .agents/product-marketing-context.md

其他相容的行銷技能與代理之後會讀取這個檔案，了解你的產品，進而產出符合訊息主軸的內容、活動與產品發表素材。

適用對象

在以下情境，你很適合使用 product-marketing-context：

• 作為 創辦人 或 產品負責人，第一次要清楚定義產品故事
• 作為 產品行銷人員 或 行銷經理，希望不同活動之間的訊息保持一致
• 作為 開發者，正在串接一套共享共同情境檔的行銷技能與代理系統

在下列工作內容中，它會特別有幫助：

• 持續性的 內容行銷（部落格、電子報、廣告、Landing pages）
• 產品發表 與方案層級更新
• 產品定位或 ICP／persona 的調整與優化

能解決的問題

product-marketing-context 技能主要用來解決這些反覆出現的痛點：

• 在多次對話中一再重複相同的產品說明與目標客群資訊
• 不同代理或技能產出的訊息不一致
• 產品行銷筆記零散分布在許多檔案裡、難以統整
• 產品定位文件難以維護、很少更新或內容過時

透過將內容集中在 .agents/product-marketing-context.md 中，你會得到一份「活的文件」，涵蓋：

• 產品概覽與價值主張
• 目標受眾與 ICP
• 在購買流程中相關的人物誌與角色
• 你替客戶解決的問題與 jobs-to-be-done
• 競爭環境與差異化
• 常見抗拒點、轉換動機與佐證重點
• 客戶用語、品牌語氣與行銷目標

什麼時候適合或不適合使用

適合使用 product-marketing-context 的情況：

• 你正在啟動一個 新專案，希望在使用其他行銷技能前先打好基礎
• 你調整了定價、方案層級或目標受眾（例如新增 enterprise 方案或新的決策角色）
• 你正在建立一套需要共享情境的 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、Landing pages、行銷文案、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 集合中的其他代理
• 你自行撰寫的自訂工具或 scripts

……都可以讀取這份檔案，建立一致的產品行銷基礎。

建議檢視的檔案與目錄

若你想更深入了解或自訂這個技能，可以從以下檔案開始：

• SKILL.md – 核心技能定義、說明與流程細節
• evals/evals.json – 範例提示與預期行為，有助於理解技能在實際情境中的反應

你可以依照自身儲存庫結構與自動化工具，調整這個技能的呼叫方式，或將它與其他技能串接起來。

FAQ

可以用簡單方式說明 product-marketing-context 是什麼嗎？

product-marketing-context 是一個引導式助手，協助你建立一份結構化的產品行銷文件，儲存在 .agents/product-marketing-context.md。內容涵蓋產品、目標受眾、定位與關鍵訊息，讓其他技能與代理可以直接重複使用。

要怎麼安裝 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 中相關的區段。

這個技能會自動從我的 codebase 草擬內容嗎？

會。在沒有現有情境檔案時，product-marketing-context 會提供 auto-draft from codebase 選項。在這個模式下，它會檢視你儲存庫中可用的資料（例如 README、行銷文案或 package metadata），草擬出第一版內容，再由你進行修正與優化。

product-marketing-context 如何與其他行銷技能搭配？

你環境中其他專注於行銷的技能可以讀取 .agents/product-marketing-context.md 來：

• 理解你的產品與 ICP
• 重用你的品牌語氣與訊息主軸
• 與你的產品定位與行銷目標保持一致

通常你會在新專案上 先 執行 product-marketing-context，之後在產出電子報、Landing pages、發表公告或其他素材時，再透過這份共享情境檔讓所有技能同步。

product-marketing-context 對開發者也有幫助嗎？

有。正在串接多個技能工作流程的開發者，可以把 .agents/product-marketing-context.md 當作：

• 儲存在 repo 中的單一真相來源
• 容易被程式化解析或載入的文件
• 讓所有行銷相關技能保持對齊的基準

在較大型的自動化架構裡，當不同代理都需要一致的產品與受眾資訊時，這會特別實用。

想了解或自訂這個技能時，我應該先看哪些檔案？

建議從以下檔案開始：

• SKILL.md – 說明 product-marketing-context 的用途與完整工作流程
• evals/evals.json – 提供範例提示與預期輸出，幫助你了解技能在實際場景中的行為

接著你就可以依自己的 repo 結構與行銷流程，調整呼叫方式或與其他技能的串接方式。