关于 k2f-case-study
k2f-case-study 是用于在排版前规划证据支持型项目案例的技能,适用于作品集、销售、营销或管理层受众。它生成语义内容与设计蓝图,再由 k2f 技能制作 K2F 包并导出。
主要功能
- 01设定受众、阅读深度与故事重点
- 02组织项目背景、过程、方案和结果
- 03区分事实、解读与预期
- 04明确个人与团队的贡献边界
- 05规划视觉素材与设计层级
适用场景
- 01将简历要点改写为作品集故事
- 02记录客户或内部项目成果
- 03针对不同专业受众调整同一项目叙述
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ suzheng/ k2f --skill k2f-case-study安装后在 Claude Code 中输入/k2f-case-study确认已加载。
详细介绍
K2F 案例研究 — AI 原生美学设计
目的
教会 Agent 在排版前规划案例研究:展示工作是如何以及为何开展的,而不是重复简历内容;如实说明工作范围,以证据支撑成果,并通过层次设计吸引快速浏览者、满足深度阅读者。
基于 K2F 构建
此技能将案例研究生成为 .K2F 包。编写时请遵循 k2f 技能:解包或初始化工作区,编辑语义树,运行 pack/verify,然后导出。K2F 让 Agent 专注于含义(章节角色、叙事节拍、视觉占位符),而非像素坐标;引擎则会编译布局、字体排印和主题,让 PDF、PPTX、DOCX 及其他格式的输出保持一致。
开始构建前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。
适用场景
- 将要点或幻灯片扩展为作品集项目故事,或适合面试展示的项目故事。
- 为销售、营销或管理层受众记录客户或内部项目的成果。
- 为 PM、设计、工程或营销方向调整同一个项目的侧重点,无需从头改写。
工作流
步骤 1. 生成 content_and_design.md
这是语义内容和美学意图的统一蓝图。使用带标签的区块,方便 k2f 技能稍后将其映射到章节和视觉元素。
子步骤
-
故事纲要 — 主要读者(快速浏览的招聘人员、招聘经理、潜在客户)、目标阅读深度(3–5 分钟读完核心内容,或 10–15 分钟深入阅读可选内容),以及最能吸引注意力的一项成果。列出用户提供的输入;对于缺失信息,应标记出来,而不是编造指标、引言或材料。
-
明确职责 — 你的职称、团队规模、时间线、工作范围,以及你的贡献与团队共同完成的工作。以第一人称撰写个人贡献,并明确注明由团队负责的部分。
-
信息架构 — 默认结构(面向只快速浏览的受众时可缩短):
- 主视觉 / 快速信息:项目名称、吸引眼球的指标或成果、职责、时间线、团队——组成便于浏览的元数据栏。
- 概述:用 2–3 句话说明交付了什么以及其重要性。
- 问题 / 挑战:业务背景、用户或客户的痛点、目标、限制条件——说明开展这项工作的价值。
- 过程:研究与探索、探索过的方案(广度)、决策及其依据(深度)、根据反馈或测试进行的迭代——突出关键转折和洞见,而非记录每次会议的流水账。
- 解决方案:逐步介绍已发布的成果;将关键功能或交付物与已说明的痛点对应起来;注明哪些地方需要依靠视觉元素来讲述(前后对比、流程、架构图)。
- 成果 / 影响:注明时间范围和基准的量化结果、定性信号、业务影响;可选“我们会如何改进”。
- 反思(作品集可选):经验、提升的技能,以及对后续工作的影响。
- 视觉素材清单:列出每项计划使用的图片及其说明意图、敏感信息的脱敏要求,以及其必要性(必需或锦上添花)。
-
受众侧重点 — 不改变事实,只调整内容深度:PM/战略(优先级、权衡、指标);设计/UX(研究、迭代、易用性);工程(架构、限制条件、性能);营销(受众、创意、ROI)。删去与故事纲要目标读者无关的章节。
-
设计意图 — 记录引擎的文案语气、层级、信息密度和配色:
- 语气:可信的讲述者——具体,证据不足时保持审慎;不夸大,也不使用泛泛的“热情”之类填充内容。
- 层级:在主视觉和概述中突出最有力的成果;流程小标题呈现决策和洞见;用数字作为成果的视觉锚点。
- 信息密度:段落和要点简短;每个区块只表达一个想法;用表格展示指标前后对比;将冗长的方法论放入可选小节或附录意图中。
- 视觉节奏:在叙述区块之间穿插不同功能的配图;优先展现历程(草图 → 迭代 → 最终成果),而不是只放一张精修截图;在蓝图中统一配图尺寸,并提供说明性图注。
- 配色:采用简洁的作品集或编辑风格(正文使用中性色,指标和重点提示使用一种强调色);符合 WCAG AA;谨慎使用引述框来呈现用户或利益相关者的原话。
规则与约束
- 展示思考过程,而不只是产出:每个主要解决方案区块都要关联到明确提出的问题或洞见。
- 证据阶梯:区分事实(用户数据)、解读(你的分析)和预测(预期影响)——绝不能把猜测说成结果。
- 流程篇幅:内容要足以证明判断力;省略没有带来决策或认知的仪式性步骤。
- 诚实说明贡献:面向面试官的作品中,不要含糊地说“我们”;团队交付的项目中,也不要把成果说成个人英雄事迹。
- 浏览路径:即使读者看完主视觉、问题和成果后就停下,也能理解项目的价值。
常见问题
- 直接粘贴简历要点,缺少叙事脉络 → 补充问题的重要性和关键决策节点。
- 只展示解决方案,却不说明“所以呢” → 将每项产出与痛点或指标关联起来。
- 把流程写成百科全书 → 精简为研究洞见、方案权衡和最终选择。
- 成果缺失或含糊 → 有数据时量化;没有数据时标注
NEEDS USER INPUT。 - 团队故事缺少区分 → 明确划分“我主导/我构建/我验证”的职责边界。
- 只展示最终稿 → 在素材清单中规划前后对比图或迭代过程图。
- 案例研究篇幅千篇一律 → 按项目说明的深度调整;如果读者是只想快速浏览一个成功案例的潜在客户,就删去反思内容。
质量检查清单
- 项目说明明确目标读者、阅读深度和核心成果。
- 主视觉中的事实与概述和成果一致;指标之间没有矛盾。
- 问题部分说明目标和约束;解决方案明确回应这些问题。
- 流程至少包含一个附有理由的决策,以及一个迭代或测试信号。
- 成果区分实测与推断;注明时间范围和基线。
- 视觉素材清单涵盖关键叙事节点,并说明图注意图。
- 设计意图明确主视觉、成果和配图节奏的层级。
步骤 2:使用 content_and_design.md 和 k2f skill 生成 K2F 文件,并导出为合适的文件格式。
按照 k2f,根据蓝图创建各个章节和配图角色,应用设计意图,进行验证,并导出面向目标读者的案例研究。