case-study-writing

概览

case-study-writing 技能是什么？

case-study-writing 技能提供了一套基于 STAR 框架（Situation → Task → Action → Result）的引导式 B2B 案例写作流程。它作为一个 inference.sh 技能存在，可以帮助你的 agent 进行调研、搭建大纲并撰写突出真实业务成果的客户故事。

与其从一张白纸开始，这个技能会引导 agent 依次完成：

• 梳理**Situation（情境）**和客户背景
• 以具体、业务化的方式定义Task（任务/挑战）
• 说明Action（行动）（你的解决方案与实施过程）
• 用数据量化Result（结果），包括指标、前后对比和可视化建议

适用人群

在以下场景中可以使用 case-study-writing 技能：

• 为 SaaS、服务或 B2B 产品撰写客户成功案例
• 产出展示成果证明的销售赋能材料
• 为网站、演示文稿或营销活动撰写营销型案例研究
• 为代理商、咨询顾问或自由职业者准备作品集案例

适用团队包括：

• 市场与内容营销团队
• 客户营销和客户成功团队
• 销售与售前（sales engineering）团队
• 各类代理商和 B2B 咨询团队

解决哪些问题？

该技能专门针对常见案例写作痛点设计：

• 案例空泛、像“故事会”，看不到实质业务价值
• 结构混乱，最重要的结果被淹没
• 指标薄弱或缺失，影响可信度
• 缺乏对客户行业及业务背景的深入调研

通过遵循固定的 STAR 结构以及仓库中提供的字数参考，agent 能让每个部分聚焦明确，并将全文控制在 800–1200 词，在信息量和可读性之间取得平衡。

什么时候适合用 case-study-writing？

在这些情况下更适合选择该技能：

• 你的产品或服务具有可量化的业务成果
• 你需要在多篇案例中复用统一的、符合品牌调性的结构
• 你希望 agent 使用研究和数据，而不是空泛的营销话术
• 你计划将案例复用到销售 deck、落地页或社交媒体活动中

在以下情况中，它不太适合：

• 你只需要简短的客户推荐或一两句引言
• 你在撰写纯技术文档或用户手册
• 你没有权限引用客户名称、指标或成果，也无法进行匿名化处理

使用方式

前置条件

该技能在仓库中的定义说明：它主要配合 inference.sh CLI（infsh） 运行。

你需要具备：

• 已安装 Node.js（以便使用 npx 安装技能）
• 如计划跟随 Quick Start 的调研步骤，则需可访问 infsh CLI

如果你打算使用源示例中的 research 流程，请根据官方说明安装 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 仓库下的 guides/writing/case-study-writing 路径中拉取 case-study-writing 技能定义以及相关指南文件。

安装完成后，建议查看：

• SKILL.md：权威技能说明和整体工作流
• guides/writing/case-study-writing 下提及的各类指南：了解详细结构和示例

基于 STAR 的核心工作流

完成安装后，只要在对 agent 的 prompt 中提到诸如 case study、customer story、success story、B2B case study 或 client testimonial 等触发词，就能调用 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 词） – 介绍客户是谁、所处环境，以及现状为何不可持续。
   • Task（100–150 词） – 以业务语言描述具体挑战或目标（如降低流失率、提高线索质量、缩短 onboarding 时间等）。
   • Action（200–300 词） – 说明采用了什么解决方案、如何运作，以及关键实施步骤，突出你的产品或服务价值。
   • Result（100–200 词） – 展示可量化结果，包括前后对比、时间线和关键 KPI。

   在 prompt 中，你可以明确要求 agent：

   • 按 STAR 顺序写作
   • 将全文控制在 800–1200 词范围内
   • 清晰区分并标示每个部分

4. 补充指标、可视化与引语
   技能说明中强调：

   • Metrics presentation（指标呈现） – 引导 agent 突出展示指标，如转化率、营收影响、节省时间或错误率下降等，并让其提出简单可视化构想（例如 before/after bar chart、funnel drop-off chart），以便后续由设计师落地。
   • Customer quotes（客户引语） – 如果你提供了访谈原始记录，可要求 agent 基于内容提炼 1–3 条有冲击力的引言，与 Task、Action 和 Result 部分呼应。

5. 规划分发与改编形式
   当主案例文本通过评审后，可以在同一技能上下文中引导 agent 将案例改编为：

   • 一页式 sales PDF 提纲
   • 销售 deck 的分页标题与要点
   • 突出关键成果的短社交媒体文案
   • 网站或博客上的案例摘要文案

将技能融入你的工作流

仓库建议将该技能视作一个工作流模版，而非死板脚本。你可以：

• 根据行业特点调整各部分篇幅，给技术细节更多空间
• 用你自己的 research 工具或数据源替换示例中的 tavily/search-assistant
• 将 STAR 大纲整合进你的 CMS、投标书模板或 standard proposal 中

在配置 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

然后在安装好的仓库中打开 SKILL.md，查看完整使用说明，其中包括 Quick Start 和 STAR 框架表格等内容。

必须使用 inference.sh CLI（infsh）吗？

SKILL 指南中使用 inference.sh CLI（infsh） 调用 tavily/search-assistant 进行调研，这种方式能自动化行业研究，官方也推荐。但你也可以：

• 使用自有工具执行类似的 research 工作流，或
• 直接将你已整理好的调研资料提供给 agent。

case-study-writing 的核心结构（STAR 和字数建议）本身并不依赖 infsh，即便不用 infsh 也可以照此执行。

为了获得最佳输出，我需要提前准备哪些信息？

要让 case-study-writing 输出高质量案例，建议事先准备：

• 客户背景（所属行业、规模、地区、产品使用情况）
• 主要业务挑战或目标
• 实施细节（你的产品/服务是如何落地的）
• 可量化结果（关键 KPI 的前后对比）
• 访谈记录或客户原话引述（如有）

输入越充分，最终案例就越具体、越有说服力。

可以拿 case-study-writing 写非 B2B 的故事吗？

该技能对 B2B 场景进行了优化，尤其适合带有业务指标的案例。你也可以将结构迁移到 B2C 或内部变革故事上使用，但整体结构、语气和 KPI 导向是围绕 B2B 案例设计的。

最终一篇案例大概多长？

根据仓库中 STAR 框架的建议长度，一篇完整案例推荐控制在 800–1200 词。这一篇幅通常足以交代背景、说明解决方案并证明成果，同时不会给读者造成阅读负担。

这个技能适合写社交媒体或广告文案吗？

case-study-writing 本质上是一个偏报告风格、长篇内容的工作流，重点是产出完整案例文本，然后你可以将其二次拆解为：

• 社交媒体短内容
• 销售拓展邮件
• Slides 或一页式资料

如果你的主要需求是广告文案或极短的社交内容，建议搭配更专门的 copywriting 技能使用，将本技能生成的案例作为素材来源。

哪里可以查看该技能的所有文件和规则？

安装完成后，在你的环境中打开对应的技能目录，即可查看：

• SKILL.md – 核心说明与使用指南
• guides/writing/case-study-writing 下的附加写作指南

你可以在 Agent Skills Finder 的 Files 视图，或本地编辑器中浏览完整目录结构，查看仓库提供的所有引用文件和辅助材料。