关于 k2f-business-report
k2f-business-report 是一项指导 Agent 先规划商业报告叙事、分析和设计,再通过 k2f 生成并导出 K2F 文件的技能。它面向经营复盘与管理层报告,要求区分事实、解读和建议,并明确标示数据缺口。
主要功能
- 01定义报告受众、周期与核心问题
- 02组织摘要、指标、趋势与建议
- 03区分事实、解读和行动建议
- 04标记数据缺口并避免虚构数据
- 05通过 k2f 生成并导出报告
适用场景
- 01根据表格或 CRM 数据制作周期业绩报告
- 02从用户提供的数据编写诊断报告
- 03整理面向董事会或管理层的决策摘要
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ suzheng/ k2f --skill k2f-business-report安装后在 Claude Code 中输入/k2f-business-report确认已加载。
详细介绍
K2F 业务报告 — AI 原生美学设计
目的
教会 Agent 在排版前先规划业务报告:以决策为导向,构建从证据到行动的叙事,如实说明数据缺口,并通过清晰的层级,让高管在几分钟内掌握绩效情况,而不是提供泛泛的文字或未经解读的图表堆砌。
基于 K2F 构建
此技能将业务报告生成为 .K2F 包。按照 k2f 技能的要求进行创作:解包或初始化工作区,编辑语义树,运行 pack/verify,然后导出。K2F 让 Agent 专注于含义(章节角色、指标、建议),而非像素坐标;引擎则将布局、排版和主题编译为一致的输出,支持 PDF、DOCX、PPTX 等格式。
开始构建前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。
适用场景
- 根据电子表格、CRM 导出数据或粘贴的指标,撰写周度、月度或季度绩效评审。
- 根据用户提供的数据撰写诊断报告,指出薄弱环节、严重程度和改进策略。
- 撰写面向董事会或领导层的摘要,让趋势、风险和后续步骤围绕同一条叙事主线展开。
工作流
第 1 步:生成 content_and_design.md
这是语义内容和美学意图的统一蓝图。使用带标签的区块,以便 k2f 技能之后将其映射到章节和视觉元素。
子步骤
-
报告纲要 — 说明受众(高管、运营团队、董事会)、涵盖周期、核心问题(“我们是否按计划推进?”“我们在哪些方面出现流失?”)以及频率(每周简报还是季度深度分析)。列出用户实际提供的数据源;标记数据缺口,不要编造数字。
-
明确范围(输入信息有限时) — 明确重要指标、对比基准(上一周期、目标、预算),以及读者需要完整细节还是仅需重点内容。不要超出报告纲要所定的范围。
-
信息架构 — 默认结构(可根据每周简报调整或缩短):
- 封面/标题区块:报告名称、周期、呈送对象、日期。
- 执行摘要:核心结论、3–5 条要点、首要风险与机遇;只有用户数据支持时才使用数字。
- 关键指标:精选一组 KPI,列出当前值、相较上一周期和目标的变化;每项指标附一行解读。
- 绩效趋势:时间序列或细分维度的情况;当趋势形态很重要(增长、下降、波动)时,优先采用图表,而非大段文字。
- 发现/薄弱环节:按严重程度排序;每项发现均包含观察结果、业务影响和合理的驱动因素(若数据中没有依据,则标注为推断)。
- 建议:提出 3–6 项与发现相对应的举措;每项举措包括目标、3–5 项按优先级排序的行动、预期影响(高/中/低)、时间范围和成功指标。
- 附录意图(可选):表格、定义、方法论——仅当受众需要审计追溯记录时提供。
-
分析纪律 — 区分事实(来自所提供的数据)、解读(你的判断)和建议(拟议的行动)。标记异常和数据质量问题。若要判定严重程度,说明判定规则(例如,负增长、未达目标、细分群体处于后 25%)。绝不编造基准或统计数据。
-
建议的构成 — 每项策略都要明确提出一项计划,关联具体薄弱环节,并以可衡量的成功标准收尾。删除泛泛的建议(如“改善营销”),除非将其改写为具体行动,并在用户提到相关团队时注明建议的负责人类型。
-
设计意图 — 记录引擎的文档语气、层级、信息密度和配色:
- 语气:自信、中立、善于分析;适合在会议中快速浏览。不要夸大其词,也不要写冗长的道歉。
- 层级:执行摘要和 KPI 栏使用最高对比度;发现按严重程度进行视觉排序(严重问题优先于次要问题);建议采用便于浏览的卡片或编号区块。
- 信息密度:使用项目符号和短段落;每个区块只表达一个观点;指标网格使用表格;叙述性内容仅在摘要和每项发现下方的“所以呢”部分展开。
- 配色:采用专业的企业风格(深色中性色文本,一种强调色用于表示变化和严重程度);符合 WCAG AA;图表限定为协调一致的类型(趋势线、排序条形图、贡献图),避免仪表板中无关的装饰。
规则与约束
- 决策主线:每个部分都要回答“领导层应该采取哪些不同做法?”——删去有趣但无法指导行动的分析。
- 严重程度优先于数量:数量较少、经过排序的问题,胜过冗长且未区分轻重的列表。
- 图表与文字说明:当洞察在于形态或对比时,使用图表;当因果关系或细节需要文字说明时,使用文字。
- 诚实原则:缺少数据 →
NEEDS USER INPUT;不要用看似合理的数字填补空缺。 - 受众适配:周报强调变化和行动;季度报告补充趋势背景和计划组合。
常见问题
- 只罗列数据,缺少结论 → 添加执行摘要,明确标题和按优先级排序的要点。
- 建议与发现脱节 → 将每项计划关联到一个发现 ID。
- 弱点描述含糊(“销售还可以更好”)→ 改用指标、周期和阈值进行描述。
- 所有 KPI 权重相同 → 指定 4–7 项主要指标;其余指标移至附录。
- 用长篇文字描述趋势,而折线图更能说明问题 → 将该区块改为图表角色,并配上一句解读。
- 捏造增长率或基准值 → 删除,或标注为等待用户确认的假设。
- 策略套话泛泛而谈 → 改写为包含具体行动和指标的明确计划。
质量检查清单
- 任务说明写明受众、周期和主要问题。
- 执行摘要可独立阅读;要点与正文中的发现一致。
- 每项 KPI 都包含数值、对比和一句“所以呢”。
- 按严重程度排列发现;说明每项发现的影响。
- 每项建议都关联到一项发现,并包含成功指标。
- 所有事实都可追溯到用户输入;明确标记数据缺口。
- 设计意图明确说明摘要、KPI、发现和建议的层级。
步骤 2:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。
遵循 k2f 技能,根据蓝图创建各个部分和图表角色,应用设计意图,完成验证,并导出适合执行层阅读的交付物。