核心用法
finebi-skills 是 FineBI 生态体系的主技能路由入口，本身不直接执行数据操作，而是作为意图识别器将用户请求分发至四个专业子技能：
| 子技能 | 核心能力 | 典型场景 |
|:---|:---|:---|
| `dashboard-briefing` | 看板摘要与群播报 | 日报/周报自动生成、经营看板定时推送 |
| `report-to-doc` | 看板导出与文档沉淀 | PDF 导出、经营分析报告撰写 |
| `alert-to-task` | 阈值监控与任务联动 | 库存告警、异常自动建任务、回款监控 |
| `sync-to-bitable` | 数据同步至外部系统 | 飞书多维表格增量更新、定时数据灌入 |
执行前必须完成：
1. 全局安装 npm install -g finebi-cli
2. 配置 FINEBI_BASE_URL 与 FINE_ACCESS_TOKEN 环境变量
3. 通过 finebi-cli init 完成本地认证（或宿主工具透传变量）
---
显著优点
1. 模块化架构清晰：主技能专注意图识别，子技能各司其职，避免单一文件臃肿，便于迭代维护。
2. 强约束的执行链路：强制要求先验证 CLI 可用性与环境配置，再进入业务流程，阻断因配置缺失导致的无效操作。
3. 精细化数据定位规则：明确区分仪表板/数据集/组件三级对象，强制遵循 dashboard-id-resolution → widget-resolution → get-widget-data 的标准链路，防止越级操作。
4. 防伪造机制完善：明文禁止伪造指标、趋势、导出结果等，要求必须用 read_only=False 模式复核 Excel 内容，保障数据可信度。
5. 降级策略简洁：无明确匹配时仅追问一个关键问题，避免多轮澄清消耗用户耐心。
---
潜在局限与风险
| 局限 | 说明 |
|:---|:---|
| 强依赖外部 CLI | 若 `finebi-cli` 未安装或版本不兼容，整个技能链路中断，无法降级为纯 API 调用 |
| 环境变量配置门槛 | 需同时管理 `FINEBI_BASE_URL` 与 `FINE_ACCESS_TOKEN`，多环境切换时易遗漏 |
| 子技能黑盒化 | 主技能仅负责路由，子技能内部逻辑未在主文件暴露，调试时需跨文件追踪 |
| 企业级权限依赖 | 实际可用功能受 FineBI 账号权限（如导出、告警配置）严格限制 |
常规风险：
- 数据泄露风险：同步至飞书多维表格时，若未设置行列级权限，可能暴露敏感经营数据
- 误告警风险：阈值监控若未结合数据波动周期配置，易产生无效告警疲劳
- 版本漂移：
finebi-cli与 FineBI 服务端版本不匹配时，可能出现接口契约断裂
---
适合人群
- BI 分析师：需要自动化日报/周报生成与看板解读
- 运营团队负责人：需将经营数据定时同步至协作工具（如飞书）
- 数据运营：需基于 FineBI 指标配置自动化监控与任务触发
- 企业数字化管理员：需规范团队的数据消费与导出流程
---
使用建议
1. 首次使用前务必执行 finebi-cli init 验证连通性
2. 涉及敏感数据的同步场景，优先在 sync-to-bitable 中配置字段脱敏规则
3. 告警类需求建议先通过 dashboard-briefing 预览数据范围，再配置 alert-to-task 阈值