飞书数据分析报告 Skill

把 Excel/CSV 原始数据、业务数据分析过程、计算结果、可视化看板和图文报告沉淀到飞书的 Agent Skill。

需求背景

在日常业务分析中，Agent 往往可以很快读懂 Excel、完成统计计算并给出结论，但分析过程经常停留在本地脚本、临时文件或聊天记录里。业务方后续想复核口径、追踪原始数据、调整计算步骤、继续维护看板时，会遇到上下文丢失、过程不可追溯、结果难协作的问题。

本项目把「数据分析」从一次性回答升级为可沉淀、可复核、可协作的飞书产物：Agent 会读取用户提供的 Excel/CSV 数据，在飞书多维表格中建立分析过程记录仓库，写入原始数据、字段体检、指标口径、清洗步骤、聚合结果和洞察建议，并进一步创建 Base 仪表盘和飞书云文档报告。

解决痛点

过程不可追溯：不只返回口头结论，而是把输入数据、清洗步骤、计算口径和结果表沉淀到飞书 Base。
口径难复核：每个指标都记录分子、分母、过滤条件、计算公式和口径边界。
协作成本高：分析结果以飞书多维表格、仪表盘和云文档交付，便于业务团队查看、评论和继续维护。
报告与数据脱节：报告中的关键数字、图表和结论都引用对应 Base 表、视图或看板组件。
重复分析低效：通过标准化表结构和步骤编号，让用户后续可以要求 Agent 重算某一步、调整某个指标或追加分析问题。

功能流程

用户提供 Excel/CSV
        |
        v
本地数据读取与字段体检
        |
        v
飞书 Base 分析过程仓库
  - 原始数据_<来源>
  - 00_输入数据目录
  - 01_字段字典与质量检查
  - 02_分析问题与指标口径
  - 03_清洗转换步骤
  - 04_核心明细或宽表
  - 05_聚合结果表
  - 06_洞察与行动建议
        |
        v
飞书 Base 仪表盘
        |
        v
飞书云文档图文报告

核心能力

读取和分析 .xlsx、.xls、.csv、.tsv 文件。
将原始数据导入或写入飞书 Base，并保留业务主键或源记录键。
生成输入数据目录、字段画像、缺失值、唯一值、样本行和质量检查结果。
设计可复核的指标口径、清洗转换步骤和分析结果表。
将原始数据、过程表、结果表和洞察建议写入飞书多维表格。
创建飞书 Base 看板，用指标卡、趋势图、排名图、结构图等方式呈现结论。
创建飞书云文档报告，包含摘要、数据来源、口径说明、关键发现、图表解读、行动建议和风险限制。
保留来源文件、来源字段、来源筛选条件、来源行数、源记录键等溯源信息。

目录结构

.
├── SKILL.md                         # Skill 主说明，定义触发条件、工作流和质量标准
├── agents/
│   └── openai.yaml                  # Agent 展示名、简介和默认提示词
├── scripts/
│   └── profile_excel.py             # Excel/CSV 数据体检脚本
└── references/                      # 飞书 CLI 原子命令、建模、看板、报告等参考文档

前置依赖

安装本 Skill 前，请先安装并配置飞书 CLI：

飞书 CLI 仓库：https://github.com/larksuite/cli.git

请确认命令可用：

lark-cli --help
lark-cli base --help
lark-cli docs --help

如果需要创建多维表格、云文档、仪表盘或白板图表，还需要按飞书 CLI 文档完成登录授权，并确保当前账号具备对应飞书空间的创建和编辑权限。

安装方式

方式一：让 Agent 自主安装

如果你的 Agent 支持从 GitHub 安装 Skill，可以直接把下面这句话发给 Agent：

请从 https://github.com/chenningling/lark-data-analysis-skill.git 安装飞书数据分析报告 Skill。安装前请先检查本机是否已安装并配置 lark-cli；如果没有，请先引导我安装 https://github.com/larksuite/cli.git。

Agent 应先检查 lark-cli 是否可用，再把本项目安装到它自己的 Skill 目录中。

方式二：手动 clone 到 Agent 的技能目录

git clone https://github.com/chenningling/lark-data-analysis-skill.git

然后将项目目录放入你使用的 Agent 对应的 Skills/技能安装目录。不同 Agent 的目录约定可能不同，请以对应 Agent 文档为准。

常见放置方式示例：

<AGENT_SKILLS_DIR>/lark-data-analysis-report/

对于 Codex 类环境，通常可以放到：

$CODEX_HOME/skills/lark-data-analysis-report/

或：

~/.codex/skills/lark-data-analysis-report/

放置后重启 Agent 或刷新技能索引，让 Agent 重新发现 Skill。

使用方式

安装完成后，在对话中上传或提供 Excel/CSV 文件，并用自然语言说明分析目标，例如：

请分析这份销售数据，帮我找出收入增长来源、异常渠道和下月优化建议。请把分析过程写入飞书多维表格，创建看板，并生成飞书云文档报告。

Agent 会按 Skill 工作流完成：

读取表格并做字段体检。
创建或导入飞书 Base 作为分析过程仓库，并先沉淀原始数据表。
设计分析问题、指标口径和过程表。
写入字段质量检查、清洗步骤、结果表和洞察建议。
创建飞书 Base 仪表盘。
创建飞书云文档分析报告。
返回飞书文档链接、飞书多维表格链接、看板名称和关键产物清单。

适用场景

销售、收入、订单、渠道 ROI 分析。
用户分层、留存、转化、流失预警分析。
经营 KPI、同比/环比、贡献度拆解。
产品运营、功能使用、路径转化分析。
财务成本、预算偏差、毛利分析。
供应链、库存、履约时效和异常明细分析。

注意事项

本 Skill 依赖 lark-cli 执行飞书资源创建和写入，安装 Skill 不等于安装飞书 CLI。
写入飞书属于创建资源操作，请在授权账号、目标空间和权限明确后使用。
对大表写入 Base 时，Agent 应分批写入，单批建议不超过 200 行。
如果只想本地探索数据，不希望创建飞书资源，请在提示词中明确说明。
最终分析质量取决于输入数据质量、业务问题清晰度和飞书账号权限。

许可证

本项目使用 MIT License，详见 LICENSE。

lark-data-analysis-report