| name | skill-hub-guide |
| description | Data Skill-Hub 技能仓库使用指南。在执行任何数据分析任务前，必须优先加载此技能以了解可用技能体系和调用规范。 |
skill-hub-guide
Data Skill-Hub 是由资深数据分析专家团队设计、经过大量真实业务场景验证的通用技能仓库。每个 SKILL 都凝结了专家级分析方法论和工程最佳实践，覆盖了从意图识别、计划生成、取数、计算到报告产出的完整数据分析链路。
严格遵循本仓库中的 SKILL 定义，你将获得专家级的分析质量——逻辑严谨、结论有据、产物规范。偏离 SKILL 定义则会导致分析遗漏、结论失准或产物不可用。
你的所有数据分析行为必须由 SKILL 驱动，严格遵循各 SKILL.md 中定义的执行步骤和规则，不得自行发挥。
核心原则
- SKILL 即规范：每个 SKILL.md 由领域专家编写，定义了该能力唯一正确的执行流程。即使你认为可以简化，也必须完整遵循
- 脚本优先：有脚本（scripts/）必须调脚本，不可用时才降级为自行实现
- 参数优先级：用户显式指定 > 域知识包 > 语义层接口 > SKILL 默认值
- 按需调用：禁止一次性预读所有 SKILL，根据当前执行到的子任务和步骤逐个加载对应 SKILL
技能体系
分层架构
技能按所在目录划分为 6 层。下表中「目录」一栏即 skills/ 下的物理目录，新增 SKILL 时按其能力归属放入对应目录，并在本表登记。
| 层级 | 目录 | 职责 | SKILL |
|---|
| L0 路由 | skills/routing/ | 判定用户意图属于哪种任务类型（查询/分析/建模/报告/非数据），将请求分发至对应处理链路 | data-intent-router |
| L1 规划 | skills/planning/ | 补充上下文、匹配分析模块和指标，将用户需求转化为结构化的可执行分析计划 | analysis-plan-builder |
| Workflows | skills/workflows/ | 按分析计划编排原子技能与取数能力，完成从数据获取到结论汇总的完整分析流程 | fetch-data（取数）
bi-metric-analysis（指标观测与异常归因）
bi-retention-analysis（留存率分析）
bi-conversion-analysis（转化率分析）
bi-cohort-analysis（同期群分析） |
| Atomic | skills/atomic/ | 执行单一、独立的分析动作（计算、检测、下拆、归因、聚类、报告等） | 指标观测与计算：bi-metric-observation、bi-retention-rate、bi-conversion-rate
异常检测与阈值：bi-anomaly-detection、bi-adaptive-threshold
归因与下钻：bi-dimension-drilldown、bi-attribution-analysis、bi-time-impact-attribution、bi-new-dimension-analysis
统计与画像：bi-event-analysis、bi-funnel-analysis、bi-comparison-analysis、bi-distribution-analysis、bi-clustering、bi-ltv-analysis
报告输出：bi-report-generation |
| Runtime | skills/runtime/ | 横切面强制规范，约束所有层的执行行为（产物落盘、数据复用、异常处理、语义层查询） | runtime-guide、bi-semantic-layer-guide |
| Meta | skills/meta/ | 仓库使用与协作约定，加载其它任何 SKILL 之前必须先读 | skill-hub-guide（本文件） |
典型调用链路
下面给出几种常见任务类型的链路。Runtime 层（runtime-guide、bi-semantic-layer-guide）在所有链路里全程生效，不再在每条链路中重复展开；fetch-data 在任何需要新取数的链路前置生效。
1. BI 业务分析链路（任务类型 = 2a）
由 data-intent-router 判定为业务分析后，由 analysis-plan-builder 给出结构化计划，再根据计划落到具体的 workflow。
1.1 通用指标分析（含异常归因）
用户问题
→ L0 data-intent-router 判定为 BI 业务分析（2a）
→ L1 analysis-plan-builder 生成结构化分析计划，确认指标与角色
→ Workflows fetch-data 按计划取数落盘
→ Workflows bi-metric-analysis 编排以下原子技能：
→ bi-metric-observation
观测北极星指标表现，确认基准数据
→ bi-anomaly-detection
对北极星指标做异常检测
├─ [无外部阈值] → bi-adaptive-threshold 自适应计算阈值
└─ [有域知识包/用户指定阈值] → 直接使用
├─ [发现异常]
│ → bi-dimension-drilldown
│ 按归因维度逐层下拆
│ └─ bi-attribution-analysis 计算贡献度（定位哪个维度异常）
│ → [可选] bi-causal-attribution
│ 从外部文档证据（周报/活动记录/产品发布）中解释"为什么"
│ └─ [可选] bi-time-impact-attribution
│ 量化已找到的事件影响度
│ → [无外部证据时] bi-time-impact-attribution
│ 直接拆解结构变动/趋势变动/事件影响
│ └─ [需要阈值] → bi-adaptive-threshold
└─ [未发现异常] 继续
→ bi-new-dimension-analysis
识别新增维度值并评估表现
→ Atomic bi-report-generation （如需输出报告）生成 HTML 报告
1.2 留存率分析
用户问题（涉及次日/第 N 日留存、访问/使用留存、留存差异等）
→ L0 data-intent-router 判定为 BI 业务分析（2a）—— 留存子类
→ L1 analysis-plan-builder 明确留存锚点、留存指标、对比范围
→ Workflows fetch-data 取数（day0 / dayn 用户数）
→ Workflows bi-retention-analysis 编排：
→ [可选] bi-clustering 按用户特征分群
→ bi-retention-rate 计算各群/整体的留存率
→ [可选] bi-comparison-analysis 跨时间/群体/留存类型对比
→ Atomic bi-report-generation （如需输出报告）
1.3 转化率分析
用户问题（涉及转化率、阶段转化、转化变化归因等）
→ L0 data-intent-router 判定为 BI 业务分析（2a）—— 转化子类
→ L1 analysis-plan-builder 明确转化口径、起止行为、对比范围
→ Workflows fetch-data 取数（分子/分母用户数或事件数）
→ Workflows bi-conversion-analysis 编排：
→ [可选] bi-clustering 按用户/产品特征分群
→ bi-conversion-rate 计算各群/整体的转化率
→ [可选] bi-anomaly-detection 对转化率序列做异常检测
→ [可选] bi-comparison-analysis 跨时间/群体/渠道对比
→ Atomic bi-report-generation （如需输出报告）
1.4 同期群（cohort）分析
用户问题（按起始特征分群后跟踪后续表现）
→ L0 data-intent-router 判定为 BI 业务分析（2a）—— cohort 子类
→ L1 analysis-plan-builder 明确起始特征、跟踪指标、观察窗口
→ Workflows fetch-data 取数（cohort 划分依据 + 后续期表现指标）
→ Workflows bi-cohort-analysis 编排：
→ bi-clustering 按起始特征划分 cohort
→ 后续表现指标计算 按需调用 bi-retention-rate / bi-conversion-rate / bi-metric-observation 等
→ bi-comparison-analysis 跨 cohort 对比
→ Atomic bi-report-generation （如需输出报告）
2. 数据探索链路（任务类型 = 2b）
用户问题
→ L0 data-intent-router 判定为数据探索（2b）
→ L1 analysis-plan-builder 数据探查 + 生成子任务序列
→ Workflows fetch-data 按子任务序列按需取数
→ 按子任务序列调用 Atomic：
bi-distribution-analysis（分布、缺失、异常值）、
bi-event-analysis（事件计数与聚合）、
bi-clustering（密度型子结构发现）等
→ 无固定 Workflows 编排，由 agent 按计划串接
3. 统计建模链路（任务类型 = 2c）
用户问题（聚类、画像、假设检验等）
→ L0 data-intent-router 判定为统计建模（2c）
→ L1 analysis-plan-builder 明确建模目标、特征、评估口径
→ Workflows fetch-data 取建模所需样本数据
→ 按目标调用 Atomic：
bi-clustering（聚类/象限/分层）、
bi-comparison-analysis（显著性/差异检验）等
→ Atomic bi-report-generation （如需输出报告）
4. 定量计算链路（任务类型 = 2d）
用户问题（已知公式的指标计算，如 LTV、漏斗、转化、留存、分布等）
→ L0 data-intent-router 判定为定量计算（2d）
→ Workflows fetch-data 取计算所需数据
→ 直接调用对应 Atomic：
bi-ltv-analysis、bi-funnel-analysis、bi-conversion-rate、
bi-retention-rate、bi-event-analysis、bi-distribution-analysis 之一或多个
→ 返回计算结果（一般无需走 L1 规划）
5. 报告生成链路（任务类型 = 2e）
上下文中已有分析结论
→ L0 data-intent-router 判定为报告生成（2e）
→ Atomic bi-report-generation 将既有结论组织为可视化 HTML 报告
6. 数据查询链路（任务类型 = 1a / 1b）
用户问题
→ L0 data-intent-router 判定为元数据查询（1a）或数据查询（1b）
→ Workflows fetch-data 直接取数或读元数据返回，不经过规划和分析流程
强制约束
必须做
- 每个步骤必须查阅对应 SKILL.md，按其定义的步骤顺序执行
- 产物必须落盘，遵循
runtime-guide 定义的目录和命名规范；取数产物遵循 fetch-data 定义的存储路径
- 同一份数据只获取一次，不重复计算
- 异常如实记录，不隐藏、不替代、不编造
- 语义层可用时，按
bi-semantic-layer-guide 优先查询指标定义与维度信息，再进入业务计算
禁止做
- 禁止跳过 SKILL 定义的步骤（如跳过异常检测直接归因、跳过取数直接编结果）
- 禁止忽略脚本（脚本可用时不得自行实现替代）
- 禁止编造数据（所有数字必须来自数据文件）
- 禁止自行发明分析方法（SKILL 未定义的方法不得使用）
