mcpField
C
case-study-writer

case-study-writer

github.com/victor-shulga营销与增长040 次安装3 周前更新
代码仓库

关于 case-study-writer

用于按 12 个部分撰写客户案例的技能,面向制作销售与营销材料的团队。它强调结果可核实、引述经客户确认、保密审查,并支持单页稿和 LinkedIn 写作交接等衍生格式。

主要功能

  1. 01按 12 个部分组织案例
  2. 02收集项目与成果证据
  3. 03缺少数据时使用占位符
  4. 04支持单页稿与 LinkedIn 交接
  5. 05提供视觉与发布前检查清单

适用场景

  1. 01根据访谈笔记撰写网站案例
  2. 02资料不足时准备 SME 问卷
  3. 03将案例压缩为提案单页稿
  4. 04向 LinkedIn 撰稿流程传递案例要点

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/victor-shulga/account-management-skills --skill case-study-writer

安装后在 Claude Code 中输入/case-study-writer确认已加载。

详细介绍

案例研究撰写工具

按照 案例研究工具包 结构撰写案例研究——这一标准格式共 12 个部分 (结果优先,60 秒内可快速浏览)。案例研究就是销售人员:它用数字和一系列决策说服 下一位潜在客户,而不是堆砌形容词。

此技能的产出

  1. 网站案例页面 — 完整的 12 部分文案,含行内视觉标记,可直接用于 CMS。
  2. 单页大纲 — 精简后的各部分内容,供销售人员作为 PDF 附件随提案发送。
  3. LinkedIn 交接稿 — 可直接发布的摘要,交由帖子撰写流程处理。
  4. 按需提供:SME 访谈问卷(尚未撰写任何内容时)、设计师视觉简报和发布前检查清单。

工作语言:与用户使用相同的语言。案例语言:客户所在市场的语言(如不明确,请询问—— 通常为英语)。一开始就询问需要哪些输出格式(默认 = 网站页面)。

硬性规则

  • 不得编造。 每个数字都必须来自用户或其提供的材料。缺少数字时 → 插入醒目的占位符 [[уточнить: X]],并在末尾列出所有占位符。 不得编造指标、引述或时间线。
  • 没有成果,就没有案例。 尚无可衡量的成果 → 如实说明,并提供弱数据模式 (见下文),不得伪造成效。
  • 每部分不超过 150 个单词。 必须能在 60 秒内浏览完。“2000 个单词”不是目标, 清晰才是。如果某一部分无法推动销售,就删掉。
  • 成果 ≠ 产出。 成果 = 业务影响(之前 → 之后)。功能 = 交付了什么。两者绝不可混为一谈。
  • 客户保密 / NDA。 询问是否可以使用客户名称和 Logo。如不可以,则匿名处理:“一家拥有 120 名员工的 MEP 工程公司(美国)”——行业 + 规模 + 地区,不含名称。 对截图中的 NDA 数据进行模糊处理或匿名化。询问哪些内容不得发布(数字、名称)。
  • 引述必须逐字引用所提供的材料。允许轻微润色语法,但不得改变含义。至少 2 条重点引述(一条放在挑战部分,一条放在成果部分)+ 1 条完整客户推荐语。
  • 必须有 CTA,并以问句结尾。没有 CTA 的案例会失去潜在客户。
  • 避免 AI 陈词滥调和否定式对比(«не X, а Y»——禁止;“cutting-edge”“seamless”“game-changing”——禁止)。使用主动语态、过去时和具体表述。最终稿须通过 anticopywriting-ai 检查。
  • 事实核查:发布前,逐一对照 SME 的回答,核实每个数字和名称。

第 1 步 — 信息收集(SME 问卷 → 12 个部分)

如果用户有笔记或通话记录稿 → 先从中提取答案,只询问缺失的信息。如果他们没有任何书面材料 → 输出此问卷(他们与交付团队或客户进行一次 45–60 分钟的访谈,然后继续)。提出开放式问题,并始终询问具体数字;如果对方说“不知道确切数字” → 询问范围或估算值。

  • A · 客户背景(→ 第 2、3 部分)— 公司业务、市场/地域、员工人数;公司的差异化优势;利益相关者的身份(先询问职位,不问姓名);合作模式、持续时间、我方团队构成。(可自行调研。)
  • B · 挑战(→ 第 4 部分)— 客户需要达成的业务成果,以及为何要现在解决(截止日期、投资方、竞争对手);最棘手的技术部分(遗留系统、集成、负载、数据);交付挑战(时间线、团队、需求不稳定、时区);不解决问题的代价;之前的尝试或其他供应商,以及失败原因。
  • C · 为什么选择我们 + 方案(→ 第 5 部分)— 客户为何选择我们而非竞争对手或内部团队;项目如何启动(探索、研讨会、审计);关键里程碑和日期(第 0 周 → 上线);过程中发生了哪些变化(范围、优先级)。
  • D · 解决方案(→ 第 6 部分)— 如何解决 3 项挑战(业务、技术、交付);关键架构/产品决策及其原因;有意做出的取舍(缩减范围、聚焦 MVP);最能展示解决方案的页面/流程(→ 设计师)。
  • E · 成果 — 必须提供数字(→ 第 7 部分)— 主要成果指标及数值(必填);3–4 项指标的前后对比(时间、金钱、转化率、用户数、增长百分比);对业务的影响(收入、融资、节省、速度、留存率);客户现在能够做到而之前无法做到的事情;任何上线后的数据(3 / 6 个月)。
  • F · 交付内容(→ 第 8 部分)— 已交付的 4–6 项关键功能/模块;客户最看重的内容。
  • G · 技术(→ 第 9 部分)— 完整技术栈(前端、后端、基础设施、集成、AI/数据);选用这些技术的原因。
  • H · 引言(→ 第 4、7、10 部分)— 客户是否愿意提供正式引言,以及姓名/职位/Logo;一句话说明他们为何愿意推荐我们;是否可以公开公司名称,或需匿名处理(NDA)。
  • I · 法律 / 媒体 — 哪些内容不得公开(受 NDA 限制的数字、姓名、页面);可用的品牌素材(Logo、团队照片、产品页面)。

第 2 步 — 找到主线

写作前,用一句话说明:这个案例为谁推介什么。选出对目标读者(下一位潜在客户,而非过去的客户)最重要的一个成果。其他所有内容都围绕它展开。如果项目取得了多项成果,就优先突出最接近收入或风险的那一项。

第 3 步 — 撰写(网站格式 · 12 个部分,顺序严格)

每个解决方案都与对应的挑战一一映射。讲述一条连贯的故事,让读者从痛点一路了解为什么选择我们、我们做了什么以及最终取得了什么成果;每个部分都为下一个部分铺垫。在线标注视觉素材占位符(供设计师使用)。

  1. 标题 + 核心指标 — [我们做了什么] + [主要数字]。不要写成“How we built X”。 例如:“8 周内发布 MVP → 获得首批 100 位付费客户及 3 万美元加速器资金”。 数字是必需的。
  2. 概览 [SNAPSHOT] — 放在标题正下方、便于快速浏览的信息面板: 行业 · 地点 · 团队规模 · 合作模式 · 项目时长 · 技术栈 · 核心成果。
  3. 客户简介 — 用 2–3 句话介绍其业务、行业、市场地位和员工人数。 不要说空话。讲清楚他们是谁,以及为什么值得认真对待。
  4. 挑战 — 分为三个小节:
    • 业务挑战 — 要解决的业务问题。
    • 技术挑战 — 技术层面最棘手的问题。
    • 交付挑战 — 团队、流程或时间安排方面的挑战。 在此处插入第一条关于痛点的引用语 [QUOTE]。说明不采取行动的代价。
  5. 为什么选择我们 + 工作方式 — 说明客户为什么选择我们,以及我们如何开展工作:需求探索 → 冲刺 → 关键里程碑。加入简短的时间线(第 0 / 2 / 6 / 8 周)。消除读者心中的“为什么要信任你们”。
  6. 解决方案 → 与挑战一一对应 — 明确指出每项解决方案解决了哪项挑战:
    • 解决方案 → 业务挑战:…… [SCREEN]
    • 解决方案 → 技术挑战:…… [DIAGRAM]
    • 解决方案 → 交付挑战:…… 通过叙述自然融入功能,而不是将其单独列成清单。技术步骤也放在这里——不要另设一个与本节争夺内容的“工作方式”部分。这是案例中篇幅最长的部分(400–500 词)。
  7. 成果与业务价值 — 用数字 [METRIC] 展示之前 → 之后,不要只写“构建了一个仪表板”。使用表格:指标 · 之前 · 之后。然后插入第二条关于成果的引用语 [QUOTE]。明确说明时间范围。
  8. 交付的功能 — 简短列出已交付的内容(4–6 项)。产出 ≠ 成果——不要与“成果”混淆。
  9. 技术栈 [STACK] — 前端、后端、基础设施、集成(标志或列表)。
  10. 完整客户评价 [QUOTE] — 2–4 句引言 + 姓名、职位、照片或标志。最有力的评价应谈及投资回报率或信任;放在成果部分之后。
  11. 行动号召 — 为有相同问题的读者提供一个行动选项,并以问句结尾。 “遇到类似挑战?→ 预约通话。”
  12. SEO / 元数据 — 目标关键词(出现在 H1 和前 100 个词中)、元标题 ≤60 个字符、元描述 ≤155 个字符、所有视觉素材均添加 alt 标签、添加指向相关案例和服务的站内链接。

语气:平实、具体,杜绝夸大。

篇幅是硬性要求,不是建议。 正文应为 1500–2000 词。少于 1200 词就是项目卡片,不是案例研究——先回去向 SME 核实信息,不要直接交付。各部分篇幅建议:

部分词数
标题 + 数字25
概览60
客户简介120
挑战250
为什么选择我们 + 工作方式250
解决方案400–500
成果:之前 → 之后200
交付的功能120
技术栈80
客户评价80
行动号召40

两条行内引用语另增加约 60 词。解决方案必须是篇幅最长的部分。 如果它比“挑战”部分短,案例讲述的就是问题,而不是实际工作。40 词的部分会显得内容单薄;每个部分都应填入真实的决策和背景,只删空话。

数字不足模式

如果客户无法分享确切数字(受 NDA 限制,或未测量基线):

  • 以运营层面的变化为开头:“从 3 款工具和手动复制粘贴转变为一条统一流程”,“从一个零产出的渠道获得首批 5 个 SQL”。
  • 使用与客户商定的范围或比例(“速度约提升 2 倍”“不到 4 周”)。
  • 绝不要把定性描述包装成指标。

步骤 4 — 衍生格式

  • 单页简介:标题 · 3 个数据卡片 · 问题(2 行)· 解决方案(3 个要点)· 成果 (2 行)· 引言 · 联系方式。控制在一页内。
  • LinkedIn 交接稿:5–7 行摘要(候选吸引点 + 核心数据 + 一个出人意料的细节)。明确标注这是帖子撰写流程的输入内容,而非完成稿。

步骤 5 — 设计师简报(视觉标记)

草稿中留下的每个标记都代表一项需要制作的视觉素材:

标记制作内容
[HERO]顶部主视觉:结合实际场景展示产品 + 以徽章形式呈现的标题数据
[SNAPSHOT]一览面板(图标:行业 / 团队 / 时长 / 技术栈)
[BEFORE/AFTER]前后对比(数据或 UI)
[DIAGRAM]架构 / 流程 / 过程
[SCREEN]放入设备边框中的产品屏幕,清晰、视网膜级
[METRIC]成果部分的大号数据卡片
[STACK]一排技术徽标
[QUOTE]带有客户照片 / 徽标的引言卡片

设计要求:使用代理机构的品牌颜色 / 字体;屏幕下方为白色背景;使用真实项目屏幕(签署 NDA 时进行模糊处理 / 匿名化),而非素材样机;确保移动端对比度和可读性(大多数流量来自手机);每个视觉素材都添加替代文本;导出为 WebP / 优化格式,使用延迟加载,并尽可能控制在 ≤200KB。

步骤 6 — 发布前检查清单

  • 标题中包含数字
  • 已填写一览面板
  • 每项挑战都对应一个解决方案(1:1)
  • 成果采用有数字的前→后格式
  • 正文 ≥1500 词,且解决方案是篇幅最大的部分
  • 至少 2 条引言 + 1 篇完整客户证言
  • 包含 CTA,可点击,并以问题结尾
  • 所有 [markers] 都已替换为最终视觉素材
  • 已就数据 / 名称 / 屏幕取得法务批准(尤其是 NDA 相关内容)
  • SEO:元标题 / 描述、关键词、替代标签、内部链接
  • 使用 anticopywriting-ai 检查(无 AI 痕迹,无负向平行结构)
  • 检查移动端效果
  • 每个数字都有来源或标记为 [[уточнити]]——在末尾列出占位符
  • 从公开版本中移除任何内部内容 / 参考资料部分

评论

支持 Markdown