docs-as-marketing

此技能使軟體代理能夠彌補技術文檔與行銷策略之間的差距。它基於開發者通常在產品採用前將文檔視為主要接觸點的事實，使其成為行銷組合中最關鍵的轉換工具。該技能指導創作兼具教育與獲客功能的文檔，確保內容在技術搜尋查詢中排名靠前，同時有效地引導用戶進行激活。

• 資訊架構：實施教程、操作指南、API 參考與概念說明等邏輯結構，以降低跳出率與認知負載。

• 快速啟動優化：應用五分鐘法則設計高轉換率的入職流程，包括先決條件驗證、安裝指令與下一步路徑。

• API 文檔最佳實踐：標準化請求/回應格式，提供可驗證的複製貼上範例，並記錄錯誤代碼以確保可靠的整合。

• 開發者 SEO：優化文檔內容以捕捉技術搜尋意圖，專注於「如何做」查詢與特定的錯誤訊息疑難排解。

• 轉換導向寫作：超越枯燥的技術規格，闡述產品功能的「是什麼」、「為什麼」與「如何做」，透過透明度與準確性建立開發者信任。

• 輸入：需要存取 API 端點、程式碼片段、現有文檔結構以及已識別的開發者受眾角色（透過 developer-audience-context）。

• 輸出：可執行的基於 Markdown 的文檔檔案、優化的快速啟動流程、重構的導航階層與高保真程式碼範例。

• 實際使用：在審核當前文檔的流失點、發佈新 API 功能或優化入門體驗時使用此技能。它旨在與 devrel-content 及 sdk-dx 技能結合使用，以保持開發者生命週期的一致性。請始終優先考慮功能性程式碼片段，並驗證所有 curl 或 SDK 範例均為最新，以防止開發者感到挫折。