mcpField
K
k2f-business-report

k2f-business-report

github.com/suzheng文档处理32.5k 次安装2 周前更新
代码仓库

关于 k2f-business-report

k2f-business-report 是一项指导 Agent 先规划商业报告叙事、分析和设计,再通过 k2f 生成并导出 K2F 文件的技能。它面向经营复盘与管理层报告,要求区分事实、解读和建议,并明确标示数据缺口。

主要功能

  1. 01定义报告受众、周期与核心问题
  2. 02组织摘要、指标、趋势与建议
  3. 03区分事实、解读和行动建议
  4. 04标记数据缺口并避免虚构数据
  5. 05通过 k2f 生成并导出报告

适用场景

  1. 01根据表格或 CRM 数据制作周期业绩报告
  2. 02从用户提供的数据编写诊断报告
  3. 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 技能之后将其映射到章节和视觉元素。

子步骤

  1. 报告纲要 — 说明受众(高管、运营团队、董事会)、涵盖周期、核心问题(“我们是否按计划推进?”“我们在哪些方面出现流失?”)以及频率(每周简报还是季度深度分析)。列出用户实际提供的数据源;标记数据缺口,不要编造数字。

  2. 明确范围(输入信息有限时) — 明确重要指标、对比基准(上一周期、目标、预算),以及读者需要完整细节还是仅需重点内容。不要超出报告纲要所定的范围。

  3. 信息架构 — 默认结构(可根据每周简报调整或缩短):

    • 封面/标题区块:报告名称、周期、呈送对象、日期。
    • 执行摘要:核心结论、3–5 条要点、首要风险与机遇;只有用户数据支持时才使用数字。
    • 关键指标:精选一组 KPI,列出当前值、相较上一周期和目标的变化;每项指标附一行解读。
    • 绩效趋势:时间序列或细分维度的情况;当趋势形态很重要(增长、下降、波动)时,优先采用图表,而非大段文字。
    • 发现/薄弱环节:按严重程度排序;每项发现均包含观察结果、业务影响和合理的驱动因素(若数据中没有依据,则标注为推断)。
    • 建议:提出 3–6 项与发现相对应的举措;每项举措包括目标、3–5 项按优先级排序的行动、预期影响(高/中/低)、时间范围和成功指标。
    • 附录意图(可选):表格、定义、方法论——仅当受众需要审计追溯记录时提供。
  4. 分析纪律 — 区分事实(来自所提供的数据)、解读(你的判断)和建议(拟议的行动)。标记异常和数据质量问题。若要判定严重程度,说明判定规则(例如,负增长、未达目标、细分群体处于后 25%)。绝不编造基准或统计数据。

  5. 建议的构成 — 每项策略都要明确提出一项计划,关联具体薄弱环节,并以可衡量的成功标准收尾。删除泛泛的建议(如“改善营销”),除非将其改写为具体行动,并在用户提到相关团队时注明建议的负责人类型。

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

    • 语气:自信、中立、善于分析;适合在会议中快速浏览。不要夸大其词,也不要写冗长的道歉。
    • 层级:执行摘要和 KPI 栏使用最高对比度;发现按严重程度进行视觉排序(严重问题优先于次要问题);建议采用便于浏览的卡片或编号区块。
    • 信息密度:使用项目符号和短段落;每个区块只表达一个观点;指标网格使用表格;叙述性内容仅在摘要和每项发现下方的“所以呢”部分展开。
    • 配色:采用专业的企业风格(深色中性色文本,一种强调色用于表示变化和严重程度);符合 WCAG AA;图表限定为协调一致的类型(趋势线、排序条形图、贡献图),避免仪表板中无关的装饰。

规则与约束

  • 决策主线:每个部分都要回答“领导层应该采取哪些不同做法?”——删去有趣但无法指导行动的分析。
  • 严重程度优先于数量:数量较少、经过排序的问题,胜过冗长且未区分轻重的列表。
  • 图表与文字说明:当洞察在于形态或对比时,使用图表;当因果关系或细节需要文字说明时,使用文字。
  • 诚实原则:缺少数据 → NEEDS USER INPUT;不要用看似合理的数字填补空缺。
  • 受众适配:周报强调变化和行动;季度报告补充趋势背景和计划组合。

常见问题

  • 只罗列数据,缺少结论 → 添加执行摘要,明确标题和按优先级排序的要点。
  • 建议与发现脱节 → 将每项计划关联到一个发现 ID。
  • 弱点描述含糊(“销售还可以更好”)→ 改用指标、周期和阈值进行描述。
  • 所有 KPI 权重相同 → 指定 4–7 项主要指标;其余指标移至附录。
  • 用长篇文字描述趋势,而折线图更能说明问题 → 将该区块改为图表角色,并配上一句解读。
  • 捏造增长率或基准值 → 删除,或标注为等待用户确认的假设。
  • 策略套话泛泛而谈 → 改写为包含具体行动和指标的明确计划。

质量检查清单

  • 任务说明写明受众、周期和主要问题。
  • 执行摘要可独立阅读;要点与正文中的发现一致。
  • 每项 KPI 都包含数值、对比和一句“所以呢”。
  • 按严重程度排列发现;说明每项发现的影响。
  • 每项建议都关联到一项发现,并包含成功指标。
  • 所有事实都可追溯到用户输入;明确标记数据缺口。
  • 设计意图明确说明摘要、KPI、发现和建议的层级。
步骤 2:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。

遵循 k2f 技能,根据蓝图创建各个部分和图表角色,应用设计意图,完成验证,并导出适合执行层阅读的交付物。

评论

支持 Markdown