case-study-writing

概觀

什麼是 case-study-writing 技能？

case-study-writing 技能是一套引導式工作流程，協助你運用 STAR 架構（Situation → Task → Action → Result）撰寫清楚可信的 B2B 成功案例。它以 inference.sh skill 形式提供，讓你的 agent 能進行研究、規劃大綱並撰寫強調實際商業成果的客戶故事。

不需要從空白頁開始，這個技能會引導 agent 依序完成：

• 設定 Situation 與客戶背景情境
• 以具體方式定義 Task 或挑戰
• 描述 Action（你的解決方案與導入方式）
• 以數據、前後對比與視覺呈現量化 Result

適合對象

如果你需要產出以下內容，就可以使用 case-study-writing 技能：

• SaaS、服務或 B2B 產品的 客戶成功案例
• 展現成果證據的 銷售支援素材
• 網站、簡報或行銷活動用的 行銷型案例研究
• 代理商、顧問或自由工作者的 作品集案例

適用於以下團隊：

• 行銷與內容行銷
• 客戶行銷與客戶成功
• 業務與售前工程
• 代理商與 B2B 顧問

它解決哪些問題？

此技能專為解決常見案例撰寫難題而設計：

• 內容空洞、缺乏明確商業影響的故事
• 結構鬆散、把最重要成果埋在細節裡的草稿
• 數據薄弱或缺失，導致可信度不足
• 對客戶產業與背景缺乏必要研究

透過固定的 STAR 結構與 repository 中的字數建議，agent 會讓每個段落聚焦，並將總長度控制在 800–1200 字 左右，在資訊量與可讀性之間取得平衡。

什麼時候適合使用 case-study-writing？

在以下情境特別適合選用此技能：

• 你的產品或服務具有可衡量的成果
• 需要在多個案例間維持一致且符合品牌的案例結構
• 希望 agent 以 研究 和 數據 支撐內容，而不是泛泛的行銷用語
• 打算將案例重複運用在銷售簡報、Landing Page 或社群活動中

在以下情況則 不太適合：

• 你只需要簡短推薦語或單一句引言
• 你要撰寫的只是純技術文件或使用手冊
• 你沒有權限提及客戶名稱、數據或成果，且也無法將其匿名化

使用方式

事前準備

在 repository 的技能定義中提到，此技能是設計給 inference.sh CLI (infsh) 執行的。

你應該先準備：

• 已安裝 Node.js（用來透過 npx 安裝 skill）
• 若要實際操作 Quick Start 的研究步驟，需能存取 infsh CLI

如果你打算使用原始範例中展示的 research flow，請依官方說明安裝 inference.sh CLI：

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

安裝步驟

使用 Agent Skills Finder 的安裝指令，將技能加入你的 agent 環境：

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

這會從 inferen-sh/skills repository 的 guides/writing/case-study-writing 路徑抓取 case-study-writing 的技能定義與相關指南檔案。

安裝完成後，請開啟：

• SKILL.md：技能的完整說明與工作流程
• guides/writing/case-study-writing 底下提到的所有指南：了解詳細結構與撰寫範例

搭配 STAR 的核心流程

安裝後，只要在需求中提到 case study、customer story、success story、B2B case study 或 client testimonial 等關鍵字，就可以提示 agent 使用 case-study-writing。

典型的操作流程如下：

1. 蒐集輸入資訊
   提供給 agent：

   • 客戶名稱與產業（或匿名化的等價資訊）
   • 使用的產品或服務
   • 主要挑戰與任何已知指標數據
   • 訪談內容摘要或引言（若有）

2. 研究客戶背景情境（選用，透過 infsh）
   SKILL 指南示範如何使用 inference.sh CLI 進行外部研究。例如：

   infsh login
   
   # Research the customer's industry
   infsh app run tavily/search-assistant --input '{
     "query": "SaaS customer onboarding challenges 2024 statistics"
   }'
   

   你可以依客戶產業（例如製造、fintech、ecommerce）調整查詢內容，蒐集最新數據與趨勢，強化 Situation 與 Task 兩個段落。

3. 依 STAR 結構撰寫草稿
   此技能建議的段落架構與大約字數如下：

   • Situation（100–150 words） – 描述客戶是誰、所處情境，以及為何現況無法滿足需求。
   • Task（100–150 words） – 以商業觀點說明具體挑戰或目標（例如降低流失率、提升潛在客戶品質、縮短 onboarding 時間）。
   • Action（200–300 words） – 說明導入了什麼解決方案、如何運作，以及重點實施步驟，突出你的產品或服務價值。
   • Result（100–200 words） – 呈現可量化成果，包含前後對比、時程與關鍵 KPI。

   在你的提示中，可以要求 agent：

   • 依序遵循 STAR 架構
   • 將全文控制在 800–1200 字範圍內
   • 清楚區分各個段落

4. 加入數據、視覺與引言
   技能描述特別強調：

   • 數據呈現 – 請 agent 明確點出例如轉換率、營收影響、節省時間或錯誤率下降等指標，並提出簡易視覺化構想（例如前後對比長條圖、漏斗流失圖），供設計師後續製作。
   • 客戶引言 – 若你提供訪談原始紀錄，可請 agent 建議 1–3 則簡短有力、且分別對應 Task、Action 與 Result 的引言。

5. 規劃發佈與重製格式
   在主文獲得核准後，你可以在同一技能脈絡下，要求 agent 將案例轉換為：

   • 一頁式銷售 PDF 的大綱
   • 銷售簡報用的投影片標題
   • 強調關鍵成果的短篇社群貼文
   • 網站或部落格的案例摘要文案

依你的流程客製這個技能

Repository 建議把這個技能當作 工作流程樣板，而不是死板的腳本。你可以：

• 視產業需求調整各段落長度，讓內容更具技術深度或商業細節
• 用你偏好的研究工具或資料來源替換範例中的 tavily/search-assistant
• 將 STAR 大綱整合到你的 CMS 或提案範本裡

在設定 agent 時，可以將常用的觸發語句（例如「draft customer success story」或「write SaaS onboarding case study」）對應至 case-study-writing，讓團隊在不同情境下都能穩定啟用同一套流程。

常見問題（FAQ）

case-study-writing 技能實際上會做什麼？

case-study-writing 會用 STAR 架構引導你的 agent 完成一套有結構的 B2B 成功案例工作流程。它特別重視：以研究建立背景情境、清楚定義問題、具體解釋你的解決方案，以及用數據、引言與建議視覺化方式來支撐成果。

我要如何安裝 case-study-writing？

執行以下指令：

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

接著在已安裝的 repository 中開啟 SKILL.md，即可查看完整說明，包括 Quick Start 及 STAR 架構表格。

一定要使用 inference.sh CLI（infsh）嗎？

SKILL 指南提供了使用 inference.sh CLI (infsh) 搭配 tavily/search-assistant 進行研究的範例指令。如果你希望自動化產業研究，建議採用。不過你也可以：

• 用自己的工具執行類似的研究流程，或
• 事先蒐集研究資料，再提供給 agent 使用。

case-study-writing 的核心結構（STAR 與字數建議）本身不依賴 infsh 也能照樣使用。

我要事先準備哪些資訊，才能得到最佳成果？

若想透過 case-study-writing 產出高品質案例，建議事先準備：

• 客戶背景（產業、規模、所在地、使用哪些產品）
• 主要商業挑戰或目標
• 導入細節（你的產品／服務是如何被實際採用）
• 量化成果（導入前後的 KPI）
• 任一訪談筆記或客戶引言

輸入越完整，最後的案例就越具體、越有說服力。

可以拿 case-study-writing 來寫非 B2B 的故事嗎？

此技能是為 B2B 情境與可量化商業指標所優化。你也可以調整後用於 B2C 或企業內部變革故事，不過整體結構、語氣與 KPI 取向，主要仍是為 B2B 案例研究設計。

完成的案例大約會有多長？

依 repository 中 STAR 架構的建議，推薦長度為 800–1200 字。通常足以交代背景脈絡、說明解決方案並呈現成果，而不至於讓讀者感到負擔過重。

這個技能適合拿來寫社群貼文或廣告嗎？

case-study-writing 主要是一種 報告型、長篇 的撰寫流程，最適合先完成完整案例，再進一步重製成：

• 社群貼文精華
• 銷售開發郵件
• 投影片或一頁式簡報

若你要的是純廣告文案或極短篇社群內容，建議搭配其他較專精於文案的技能，把案例當成源素材來使用。

我在哪裡可以看到這個技能的所有檔案與規則？

安裝完成後，在你的環境中開啟此技能的目錄，即可查看：

• SKILL.md – 主要說明與使用指引
• guides/writing/case-study-writing 下的其他指南檔案

你可以透過 Agent Skills Finder 的 Files 分頁，或使用本機編輯器瀏覽完整目錄樹，包括所有巢狀參考與 repository 提供的輔助素材。