用途
puzzle-iaa-analytics 用于 IAA 益智/休闲游戏上线后的数据复盘，主要目标包括：
- 上线后版本复盘：识别留存、变现和关卡体验方面的核心问题。
- 为下一版本提供数据驱动的优先级建议。
适用对象为纯 IAA（广告变现）益智/休闲游戏。若用户意图是原始即席分析、单指标查询或非游戏分析，则不应使用本技能，而应直接使用 ae-analysis。
主要能力
该技能编排一条多步骤分析流水线，覆盖以下分析单元（§1-§17）：
- 核心指标：留存衰减（D2/D3/D7 及衰减比）、游玩时长（D1/D2/D3-7 人均）、人均通关关卡数。
- 变现：广告位拆解（类型 × 场景）。
- 关卡：首关通过率、每 10 关阶段 IPU、单关广告触发原因、关卡留存曲线、关卡通过率曲线。
- 路径：注册 → 前 10 关事件漏斗、流失用户末次会话行为追踪。
- 分群：广告品类分群对比、内容消费分群对比。
- 数据驱动：广告频次-留存曲线与拐点检测、通关关卡数-留存曲线与拐点检测、稳定用户行为基线、核心用户识别（4 类 × IPU 贡献）。
使用方式
技能按步骤执行，步骤概览如下：
- 01 数据校验（无依赖，输出 data_inventory.json）
- 02 核心诊断（依赖 Step 01，指标 §1 §2 §3 §4，输出 core_diagnostics.md）
- 03 关卡深入（依赖 Step 01，指标 §5 §6 §7 §8 §9，输出 level_analysis.md）
- 04 用户路径漏斗（依赖 Step 01，指标 §10 §11，输出 user_path_analysis.md）
- 05 用户分群（依赖 Step 02，指标 §12 §13，输出 segmentation_report.md）
- 06 数据驱动区间（依赖 Step 02，指标 §14 §15 §16 §17，输出 interval_analysis.md）
- 07 综合报告（依赖 Steps 02-06，输出 final_report.md）
- 08 发布（依赖 Step 07，输出飞书文档链接）
关键约定：
- Step 01 是唯一的交互窗口，也是强制关卡。所有配置最终值必须由用户输入编号显式确认；精确匹配候选必须经用户复核，不得以“默认配置”自动接受；零模糊匹配结果必须上报，由用户决定手动录入或显式跳过。data_inventory.json 与 project_mapping.md 的回写需等待 1.8 汇总确认。Step 01 未确认则不得进入 Steps 02-06。
- 所有数据操作统一使用 ae-cli，即席分析使用 ae-cli analysis adhoc run（统一入口），不设单独的 builder 步骤。不得猜测命令名、标志、JSON 载荷、project_id、事件名、属性名或参数格式。
- references/config/project_mapping.md 是业务概念与数据库字段之间的唯一桥梁。{{event.xxx}} 与 {{prop.xxx}} 是业务概念占位符，不是实际数据库字段名；切换项目时只需修改该文件。
- SKILL.md 与 references 正文不得引用 references/adapters/，工具知识仅存在于适配器层。
- 工作目录：所有中间文件写入 {{workspace_dir}}（默认 /tmp/puzzle-iaa-analytics/），不依赖步骤间的 LLM 记忆。
- 状态码：STEP_SUCCESS（继续）、STEP_EMPTY（写空占位并继续）、STEP_ERROR（写错误占位并继续）、STEP_FATAL（立即终止技能）。
- 降级策略：Steps 02-06 中至少 4/7 成功才能进入 Step 07 综合；单个查询失败不阻塞整体流程，在最终报告中标记为“数据缺失”；Step 01 失败 → STEP_FATAL。
- 并行性：Steps 02、03、04 相互独立，完全并行执行；Steps 05、06 依赖 Step 02 结果；Step 07 依赖 Steps 02-06；各步骤内的子分析也相互独立，可一批并行触发。
- 语言约定：面向用户的输出为中文；确认选项必须双语，格式为 [N] English name — Chinese meaning。
- 指标引用约定：各分析步骤引用 metric_definitions.md 中的指标 ID（如“执行 §1 留存衰减”），六要素分析单元模板确保指标是可独立验证的数学公式。
适用场景
- 纯 IAA 益智/休闲游戏上线后版本复盘。
- 需要从留存、变现、关卡体验多维度定位核心问题。
- 需要为下一版本制定数据驱动的优化优先级。
限制
- 不适用于原始即席分析、单指标查询或非游戏分析（应使用 ae-analysis）。
- Step 01 未确认前不得执行 Steps 02-06。
- 不得跳过步骤或编造数据。
- 不得猜测命令名、标志、JSON 载荷、project_id、事件名、属性名或参数格式。
- 具体收费、价格、平台支持等信息暂未提供。