关于 case-study-writer
用于按 12 个部分撰写客户案例的技能,面向制作销售与营销材料的团队。它强调结果可核实、引述经客户确认、保密审查,并支持单页稿和 LinkedIn 写作交接等衍生格式。
主要功能
- 01按 12 个部分组织案例
- 02收集项目与成果证据
- 03缺少数据时使用占位符
- 04支持单页稿与 LinkedIn 交接
- 05提供视觉与发布前检查清单
适用场景
- 01根据访谈笔记撰写网站案例
- 02资料不足时准备 SME 问卷
- 03将案例压缩为提案单页稿
- 04向 LinkedIn 撰稿流程传递案例要点
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ victor-shulga/ account-management-skills --skill case-study-writer安装后在 Claude Code 中输入/case-study-writer确认已加载。
详细介绍
案例研究撰写工具
按照 案例研究工具包 结构撰写案例研究——这一标准格式共 12 个部分 (结果优先,60 秒内可快速浏览)。案例研究就是销售人员:它用数字和一系列决策说服 下一位潜在客户,而不是堆砌形容词。
此技能的产出
- 网站案例页面 — 完整的 12 部分文案,含行内视觉标记,可直接用于 CMS。
- 单页大纲 — 精简后的各部分内容,供销售人员作为 PDF 附件随提案发送。
- LinkedIn 交接稿 — 可直接发布的摘要,交由帖子撰写流程处理。
- 按需提供: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 个部分,顺序严格)
每个解决方案都与对应的挑战一一映射。讲述一条连贯的故事,让读者从痛点一路了解为什么选择我们、我们做了什么以及最终取得了什么成果;每个部分都为下一个部分铺垫。在线标注视觉素材占位符(供设计师使用)。
- 标题 + 核心指标 —
[我们做了什么] + [主要数字]。不要写成“How we built X”。 例如:“8 周内发布 MVP → 获得首批 100 位付费客户及 3 万美元加速器资金”。 数字是必需的。 - 概览
[SNAPSHOT]— 放在标题正下方、便于快速浏览的信息面板: 行业 · 地点 · 团队规模 · 合作模式 · 项目时长 · 技术栈 · 核心成果。 - 客户简介 — 用 2–3 句话介绍其业务、行业、市场地位和员工人数。 不要说空话。讲清楚他们是谁,以及为什么值得认真对待。
- 挑战 — 分为三个小节:
- 业务挑战 — 要解决的业务问题。
- 技术挑战 — 技术层面最棘手的问题。
- 交付挑战 — 团队、流程或时间安排方面的挑战。
在此处插入第一条关于痛点的引用语
[QUOTE]。说明不采取行动的代价。
- 为什么选择我们 + 工作方式 — 说明客户为什么选择我们,以及我们如何开展工作:需求探索 → 冲刺 → 关键里程碑。加入简短的时间线(第 0 / 2 / 6 / 8 周)。消除读者心中的“为什么要信任你们”。
- 解决方案 → 与挑战一一对应 — 明确指出每项解决方案解决了哪项挑战:
- 解决方案 → 业务挑战:……
[SCREEN] - 解决方案 → 技术挑战:……
[DIAGRAM] - 解决方案 → 交付挑战:…… 通过叙述自然融入功能,而不是将其单独列成清单。技术步骤也放在这里——不要另设一个与本节争夺内容的“工作方式”部分。这是案例中篇幅最长的部分(400–500 词)。
- 解决方案 → 业务挑战:……
- 成果与业务价值 — 用数字
[METRIC]展示之前 → 之后,不要只写“构建了一个仪表板”。使用表格:指标 · 之前 · 之后。然后插入第二条关于成果的引用语[QUOTE]。明确说明时间范围。 - 交付的功能 — 简短列出已交付的内容(4–6 项)。产出 ≠ 成果——不要与“成果”混淆。
- 技术栈
[STACK]— 前端、后端、基础设施、集成(标志或列表)。 - 完整客户评价
[QUOTE]— 2–4 句引言 + 姓名、职位、照片或标志。最有力的评价应谈及投资回报率或信任;放在成果部分之后。 - 行动号召 — 为有相同问题的读者提供一个行动选项,并以问句结尾。 “遇到类似挑战?→ 预约通话。”
- 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 痕迹,无负向平行结构) - 检查移动端效果
- 每个数字都有来源或标记为
[[уточнити]]——在末尾列出占位符 - 从公开版本中移除任何内部内容 / 参考资料部分