product-marketing-context

product-marketing-context skill 概覽

product-marketing-context 的作用是什麼

product-marketing-context skill 會幫你在 .agents/product-marketing-context.md 建立並維護一份共用的產品行銷來源檔。它的任務很單純，但很有價值：把產品概述、目標受眾、定位、常見異議、佐證依據與訊息基礎先整理一次，之後其他行銷工作流程就能直接重用，不必每次都從頭問同樣的基本問題。

誰適合使用這個 skill

這個 skill 特別適合創辦人、產品行銷人員、成長負責人，以及需要在 repo 或客戶專案中反覆進行 AI 輔助行銷工作的代理商。若你希望在定位、ICP 分析、落地頁草稿、活動規劃或 sales enablement 內容上維持較高一致性，它會特別有幫助。

它真正要解決的工作是什麼

多數團隊缺的不是「更多文案」，而是一層穩定的上下文，讓模型在開始產出任何內容前可以先參照。product-marketing-context skill 就是為了這個前置設定而設計。它會先建立一份可重用的行銷脈絡文件，之後其他 skill 再以此為基礎往下延伸。

為什麼這比一般提示詞更好

一般提示詞也能要求模型幫你做定位，但通常只會產出一次性的答案。product-marketing-context 的設計則是圍繞這些實務流程：

• 先檢查是否已經有現成的 context file
• 只更新有變動的段落
• 提供從 codebase 自動起草，或從零開始的引導式流程
• 把結果存到固定可預期的檔案路徑，方便其他 skill 引用

所以它比單純一句「幫我做 messaging」更偏向可操作、可持續的工作流。

最適合與不適合的使用情境

最適合：

• 新產品，尚未建立訊息與定位基礎
• 同一個 repo 會搭配多個 AI 行銷 skill 使用
• 團隊在產品上線、價格調整或受眾轉移後，需要更新定位

較不適合：

• 單次文案任務，且你不想保留持續使用的 context
• 沒有可供檢視的 repo 或產品資料
• 團隊期待這個 skill 單獨完成深度市場研究

如何使用 product-marketing-context skill

安裝情境與檔案存放位置

如果你的環境支援 Skills 安裝，加入其 parent repository 後，就可以從中使用 product-marketing-context skill。這個 skill 主要圍繞的輸出檔案是：

/.agents/product-marketing-context.md

它也會檢查 .claude/product-marketing-context.md，以支援較舊的使用方式，並協助把既有內容往新的位置遷移。

先檢查是否已有現成的 context file

在建立任何新內容前，預設工作流程應先找：

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

如果 context file 已經存在，正確做法不是「整份重寫」。你應該先讀它、整理目前已經記錄的內容，再只更新受使用者變更影響的段落。

為 product-marketing-context 選對起手方式

repo 內展示了兩條實際可行的進入路徑：

1. 從 codebase 自動起草
   適合 repo 中已有足夠訊號，例如 README.md、落地頁文案、文件、package.json，或產品內建文案。

2. 從零開始建立
   當 repo 資訊偏少、私有材料比程式碼更重要，或產品本身仍在定義中時，這條路徑通常更合適。

這是 product-marketing-context guide 中非常重要的採用細節之一：只要起手方式和你手上證據品質相符，結果通常會好很多。

product-marketing-context 需要哪些輸入

若要得到有用的輸出，至少應提供：

• 產品是什麼
• 產品是給誰用的
• 它解決的核心問題
• 它和替代方案有何不同
• 目前有哪些佐證或限制條件
• 這次是第一版起草，還是更新既有內容

額外提供以下資訊會更有幫助：

• 價格方案或級距變更
• 新增 persona
• win/loss pattern
• 來自通話或評論的客戶用語
• 品牌語氣偏好
• 銷售常見異議
• 上線目標或季度目標

這個 skill 會建立哪些段落

根據 repository 中的 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 file，而不只是短短一段定位敘述。

把模糊需求變成高品質提示

較弱：

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.

一套能降低猜測成分的實用 workflow

建議的工作順序如下：

1. 先檢查是否已有 context file。
2. 判斷該走 auto-draft 還是 guided interview。
3. 逐段建立或更新 context file。
4. 明確標示假設與缺失證據。
5. 和使用者一起檢查並修正。
6. 存到 .agents/product-marketing-context.md。
7. 在後續行銷任務中重複使用這份檔案。

這也是為什麼建議在專案早期就完成 product-marketing-context install：前面先做好，後面每次行銷任務就能少掉大量重複設定。

先讀這些 repository 檔案

如果你想快速評估，建議先看：

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

SKILL.md 說明的是操作層面的 workflow；evals/evals.json 則很有參考價值，因為它展示了在真實提示中，什麼樣的使用方式才算是「正確使用」，也包含產品變動後的更新案例。

哪些因素會實質提升輸出品質

最好的輸出來自證據，不是來自願景。若你想讓 context 文件更扎實，請把 skill 指向這些材料：

• 首頁或落地頁文案
• 產品文件與 onboarding 文字
• demo transcript 筆記
• 價格與方案說明
• 客戶訪談引述
• 你實際會使用的競品比較
• 銷售通話中的異議
• 既有品牌規範

少了這些資料，草稿仍可能可用，但裡面會包含更多偏泛化的假設。

第一版 product-marketing-context 草稿可以期待什麼

用 product-marketing-context 建出的 V1，應該被視為工作文件，而不是最終定案。真正有價值的第一版通常會：

• 把已確認事實與推測出的定位分開
• 揭露 proof points 或受眾清晰度上的空缺
• 提供足夠結構，讓後續 AI 行銷任務維持一致

如果你要的是更成熟、可直接對外使用的策略型訊息，通常在初版產出後，還需要至少再做一輪審閱。

product-marketing-context skill 常見問題

product-marketing-context 適合新手嗎？

適合。它對新手友善的原因在於流程很明確：先檢查既有檔案、再選 auto-draft 或 guided setup，接著填入各個指定段落。即使你不熟正式的 PMM framework，也能先做出可用的第一版。

什麼時候該用 product-marketing-context，而不是一般提示詞？

當你希望同一份 context 能被多個任務重複使用時，就應該用它。如果你的目標只是寫一個 landing page headline，一般提示詞可能就夠了；但如果你要在多種輸出中維持訊息一致，product-marketing-context for Product Marketing 會是更穩的基礎。

它可以更新既有 context，而不是整份重建嗎？

可以，這正是它的核心行為之一。這個 skill 的設計就是先讀取現有的 .agents/product-marketing-context.md，整理已存在的內容，再只修訂被新資訊影響的段落。

它會幫我做市場研究嗎？

不完全會。它可以從 repo 和產品材料中推導出很多內容，但不能取代真正的客戶研究。如果你手上的證據很弱，輸出在結構上可能仍有幫助，但在策略深度上會比較薄。

如果我的 repo 幾乎沒有行銷文案怎麼辦？

請改用從零開始的路徑，並以對話方式回答問題。這通常比硬要從資訊稀少的 codebase 強行 auto-draft 更好，因為後者往往無法充分反映客戶、異議或購買情境。

product-marketing-context 只有在這個 repo 生態系內才有用嗎？

它在和其他會引用 .agents/product-marketing-context.md 的行銷 skill 搭配時最有價值，但這份檔案本身是可攜的。就算你不在完整的 skill ecosystem 中使用，也仍可以把它當成標準 PMM brief。

什麼情況下這個 skill 不適合？

以下情況可以跳過：

• 你只需要一次性的單一文案輸出
• 你的團隊不會維護共用的 context file
• 你的產品目前仍太不明確，連基本受眾與問題定義都無法回答

如何改進 product-marketing-context skill 的使用效果

給 product-marketing-context 證據，不要只給目標

提升 product-marketing-context skill 品質最有效的方法，就是提供更好的來源材料。像「我們想要更強的定位」這種說法本身不夠。請提供原始輸入，例如：

• homepage 文案
• 客戶通話筆記
• sales 團隊最常遇到的異議
• 客戶為何轉換
• feature 到 benefit 的說明
• 帶有數字的 proof points

這樣模型才能把主張建立在依據上，而不是自行補想像。

明確指出到底變了什麼

在更新情境下，如果實際上只改了兩件事，就不要要求做全面 refresh。直接說清楚新增或變動的是什麼：

• 新的 pricing tier
• 擴大的 ICP
• 類別名稱重命名
• 更明確的 enterprise focus
• 新的競爭壓力

這能幫助 skill 精準更新正確段落，也避免把原本還正確的 messaging 一起弱化掉。

要求模型標示假設

常見失敗模式之一，就是把猜測藏在看似肯定的表述裡。若想提升輸出品質，可以要求模型明確標示：

• confirmed facts
• likely inferences
• missing inputs
• questions for review

這會讓第一版更容易被審核，也更容易後續修正。

逐段審查，最終成品通常會更好

不要等整份文件寫完才第一次看。最值得優先驗證的高價值段落是：

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

如果這幾段一開始就錯了，後續所有建立在這份檔案上的訊息也很容易一起偏掉。

強化 customer language 的收集

常見的弱點是措辭過於 generic。若要在實務上提升 product-marketing-context guide 的效果，請餵給它客戶真實使用的語句，來源可以包括：

• 訪談
• support tickets
• review sites
• sales calls
• onboarding feedback

真實客戶語言會大幅提升後續文案的貼近度與相關性。

注意這些常見失敗模式

典型問題包括：

• 把 feature list 偽裝成定位
• ICP 過度寬泛
• 對模糊「competitors」做出薄弱差異化
• 品牌語氣很理想化，但沒有實例
• 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 長期最有價值的用法，不是一次性設定，而是持續維護。當產品、受眾、定價、類別定位或銷售方式改變時，就應回頭更新這份檔案。這樣所有後續行銷任務才能持續對齊當下現實，而不是建立在過時假設上。