mcpField
K
k2f-case-study

k2f-case-study

github.com/suzheng营销与增长3648 次安装2 周前更新
代码仓库

关于 k2f-case-study

k2f-case-study 是用于在排版前规划证据支持型项目案例的技能,适用于作品集、销售、营销或管理层受众。它生成语义内容与设计蓝图,再由 k2f 技能制作 K2F 包并导出。

主要功能

  1. 01设定受众、阅读深度与故事重点
  2. 02组织项目背景、过程、方案和结果
  3. 03区分事实、解读与预期
  4. 04明确个人与团队的贡献边界
  5. 05规划视觉素材与设计层级

适用场景

  1. 01将简历要点改写为作品集故事
  2. 02记录客户或内部项目成果
  3. 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 技能稍后将其映射到章节和视觉元素。

子步骤

  1. 故事纲要 — 主要读者(快速浏览的招聘人员、招聘经理、潜在客户)、目标阅读深度(3–5 分钟读完核心内容,或 10–15 分钟深入阅读可选内容),以及最能吸引注意力的一项成果。列出用户提供的输入;对于缺失信息,应标记出来,而不是编造指标、引言或材料。

  2. 明确职责 — 你的职称、团队规模、时间线、工作范围,以及你的贡献与团队共同完成的工作。以第一人称撰写个人贡献,并明确注明由团队负责的部分。

  3. 信息架构 — 默认结构(面向只快速浏览的受众时可缩短):

    • 主视觉 / 快速信息:项目名称、吸引眼球的指标或成果、职责、时间线、团队——组成便于浏览的元数据栏。
    • 概述:用 2–3 句话说明交付了什么以及其重要性。
    • 问题 / 挑战:业务背景、用户或客户的痛点、目标、限制条件——说明开展这项工作的价值。
    • 过程:研究与探索、探索过的方案(广度)、决策及其依据(深度)、根据反馈或测试进行的迭代——突出关键转折和洞见,而非记录每次会议的流水账。
    • 解决方案:逐步介绍已发布的成果;将关键功能或交付物与已说明的痛点对应起来;注明哪些地方需要依靠视觉元素来讲述(前后对比、流程、架构图)。
    • 成果 / 影响:注明时间范围和基准的量化结果、定性信号、业务影响;可选“我们会如何改进”。
    • 反思(作品集可选):经验、提升的技能,以及对后续工作的影响。
    • 视觉素材清单:列出每项计划使用的图片及其说明意图、敏感信息的脱敏要求,以及其必要性(必需或锦上添花)。
  4. 受众侧重点 — 不改变事实,只调整内容深度:PM/战略(优先级、权衡、指标);设计/UX(研究、迭代、易用性);工程(架构、限制条件、性能);营销(受众、创意、ROI)。删去与故事纲要目标读者无关的章节。

  5. 设计意图 — 记录引擎的文案语气、层级、信息密度和配色:

    • 语气:可信的讲述者——具体,证据不足时保持审慎;不夸大,也不使用泛泛的“热情”之类填充内容。
    • 层级:在主视觉和概述中突出最有力的成果;流程小标题呈现决策和洞见;用数字作为成果的视觉锚点。
    • 信息密度:段落和要点简短;每个区块只表达一个想法;用表格展示指标前后对比;将冗长的方法论放入可选小节或附录意图中。
    • 视觉节奏:在叙述区块之间穿插不同功能的配图;优先展现历程(草图 → 迭代 → 最终成果),而不是只放一张精修截图;在蓝图中统一配图尺寸,并提供说明性图注。
    • 配色:采用简洁的作品集或编辑风格(正文使用中性色,指标和重点提示使用一种强调色);符合 WCAG AA;谨慎使用引述框来呈现用户或利益相关者的原话。

规则与约束

  • 展示思考过程,而不只是产出:每个主要解决方案区块都要关联到明确提出的问题或洞见。
  • 证据阶梯:区分事实(用户数据)、解读(你的分析)和预测(预期影响)——绝不能把猜测说成结果。
  • 流程篇幅:内容要足以证明判断力;省略没有带来决策或认知的仪式性步骤。
  • 诚实说明贡献:面向面试官的作品中,不要含糊地说“我们”;团队交付的项目中,也不要把成果说成个人英雄事迹。
  • 浏览路径:即使读者看完主视觉、问题和成果后就停下,也能理解项目的价值。

常见问题

  • 直接粘贴简历要点,缺少叙事脉络 → 补充问题的重要性和关键决策节点。
  • 只展示解决方案,却不说明“所以呢” → 将每项产出与痛点或指标关联起来。
  • 把流程写成百科全书 → 精简为研究洞见、方案权衡和最终选择。
  • 成果缺失或含糊 → 有数据时量化;没有数据时标注 NEEDS USER INPUT。
  • 团队故事缺少区分 → 明确划分“我主导/我构建/我验证”的职责边界。
  • 只展示最终稿 → 在素材清单中规划前后对比图或迭代过程图。
  • 案例研究篇幅千篇一律 → 按项目说明的深度调整;如果读者是只想快速浏览一个成功案例的潜在客户,就删去反思内容。

质量检查清单

  • 项目说明明确目标读者、阅读深度和核心成果。
  • 主视觉中的事实与概述和成果一致;指标之间没有矛盾。
  • 问题部分说明目标和约束;解决方案明确回应这些问题。
  • 流程至少包含一个附有理由的决策,以及一个迭代或测试信号。
  • 成果区分实测与推断;注明时间范围和基线。
  • 视觉素材清单涵盖关键叙事节点,并说明图注意图。
  • 设计意图明确主视觉、成果和配图节奏的层级。
步骤 2:使用 content_and_design.md 和 k2f skill 生成 K2F 文件,并导出为合适的文件格式。

按照 k2f,根据蓝图创建各个章节和配图角色,应用设计意图,进行验证,并导出面向目标读者的案例研究。

评论

支持 Markdown