Skill: bianca1227/bianca1227-sensors-analytics-doc-gen-2 (version 1.0.2)

--- name: sensors-analytics-doc-gen-2 description: "将神策（Sensors Analytics）元数据管理、人群、标签手册转换为飞书使用说明文档。支持元事件、事件属性、虚拟属性、虚拟事件、维度表、物品属性、人群、标签等功能模块。元数据管理模块需要一次性处理6个手册链接并整合。触发词：生成使用说明、创建手册、文档生成，神策手册。" --- # 神策分析手册转飞书文档生成器（升级版） 将神策（Sensors Analytics）官方分析手册转换为飞书使用说明文档。 ## 功能说明 根据用户提供的神策分析手册链接，自动抓取官方文档内容，并按照标准化的文档框架生成飞书文档。 ### 支持的功能模块 #### 元数据管理（一次性6个手册） | 模块 | 说明 | |------|------| | 元事件 | 事件配置管理 | | 事件属性 | 事件级属性配置 | | 虚拟属性 | 虚拟属性配置 | | 虚拟事件 | 虚拟事件配置 | | 维度表 | 维度表配置 | | 物品属性 | 物品属性配置 | #### 人群与标签 | 模块 | 说明 | |------|------| | 用户分群 | 用户群体划分 | | 用户标签 | 用户标签管理 | --- ## 交互流程 ### Step 1: 用户输入手册链接 用户需要提供神策分析手册的链接。 **元数据管理（一次性提供6个链接）：** - 元事件：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_meta` - 事件属性：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_event_attr` - 虚拟属性：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_virtual_attr` - 虚拟事件：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_virtual_event` - 维度表：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_dimension` - 物品属性：`https://manual.sensorsdata.cn/sa/docs/guide_metadata_item_attr` **人群与标签：** - 用户分群：`https://manual.sensorsdata.cn/sa/docs/User_Group_Create` - 用户标签：`https://manual.sensorsdata.cn/sa/docs/guide_tags` ### Step 2: 判断文档类型 根据用户提供的链接，自动判断文档类型： - 如果是元数据管理（6个功能），使用**元数据管理规范** - 如果是人群/标签，使用**原规范** ### Step 3: 显示标准框架规范 在生成文档之前，必须先向用户展示标准框架规范，确认是否需要调整。 #### 元数据管理规范（整合6个手册，略有调整） **标准框架规范：** ##### 一、快速入门 （一）定义说明：核心概念解释（用高亮框突出） （二）实际应用场景：表格化呈现 ##### 二、核心功能详解 （一）基础全局功能：表格结构（功能名称、说明、截图），空白表格预留填充 （二）其他功能模块：全部表格化，使用`<lark-table>`组件，列宽120/350/180 ##### 三、常见问题解答（FAQ） - 分类：使用相关、配置相关、数据相关 ##### 四、文档维护 - 版本记录、使用建议、意见反馈 --- #### 人群与标签规范（原规范，严格复制） **标准框架规范：** ##### 一、快速入门（5分钟上手） （一）定义说明：核心概念解释（用高亮框突出） （二）实际应用场景：表格化呈现 （三）2分钟完成第一个分析/人群/标签： - 横向Mermaid流程图（graph LR） - 操作要点速览 - 截图标记 ##### 二、核心功能详解 （一）基础全局功能：表格结构（功能名称、说明、截图），空白表格预留填充 （二）其他功能模块：全部表格化，使用`<lark-table>`组件，列宽120/350/180 ##### 三、实践应用模板 - 数量：2-3个标准模板 - 结构：使用场景、配置要点、预期产出 ##### 四、常见问题解答（FAQ） - 分类：使用相关、配置相关、数据相关 ##### 五、文档维护 - 版本记录、使用建议、意见反馈 --- **关键注意事项：** 1. **标题与序号规范（必须遵守）** - **文档标题**：使用飞书文档的标题功能，格式为【XX】xxx使用说明 - **正文H1标题**：使用中文数字：一、二、三（如：一、快速入门） - **正文H2标题**：使用数字有序列表：1.1、1.2、1.3（与H1标题联动） - **正文H3标题**：使用数字有序列表：1.1.1、1.1.2、1.1.3 2. **高亮框标准**：信息说明light-orange，截图标记light-yellow 3. **截图标记**：使用📸 emoji标识 4. **截图提示**：高亮块内开头固定语句"截图提示：截图可按需插在表格最后一列"，然后另起一行有序分点罗列截图建议 ### Step 4: 确认框架规范 使用 `question()` 向用户确认： ``` question({ questions: [{ header: "文档框架确认", question: "以下是生成文档的标准框架规范，请确认是否需要调整：\n\n【元数据管理规范】（整合6个手册）\n一、快速入门：定义说明（高亮框）→ 实际应用场景\n二、核心功能详解：基础全局功能 + 其他功能模块（全部表格化，lark-table，列宽120/350/180）\n三、常见问题解答\n四、文档维护\n\n【人群/标签规范】（原规范）\n一、快速入门：定义说明 → 实际应用场景 → 2分钟完成第一个分析\n二、核心功能：基础全局功能 + 其他功能模块\n三、实践应用模板（2-3个）\n四、常见问题解答\n五、文档维护\n\n请确认：", options: [ { label: "直接按此框架生成 (Recommended)", description: "不调整框架，直接生成文档" }, { label: "调整框架规范", description: "修改部分框架内容后再生成" } ] }] }) ``` 如果用户选择"调整框架规范"，则收集用户的具体调整需求，然后重新确认。 ### Step 5: 抓取文档内容 #### 元数据管理（6个链接） 同时抓取6个手册内容，然后整合： ```bash # 批量抓取 web_fetch url="<元事件链接>" maxChars=50000 web_fetch url="<事件属性链接>" maxChars=50000 web_fetch url="<虚拟属性链接>" maxChars=50000 web_fetch url="<虚拟事件链接>" maxChars=50000 web_fetch url="<维度表链接>" maxChars=50000 web_fetch url="<物品属性链接>" maxChars=50000 ``` #### 人群/标签（单/多链接） 按需抓取1-2个手册内容： ```bash web_fetch url="<用户提供的链接>" maxChars=50000 ``` ### Step 6: 生成飞书文档 使用 `feishu_create_doc` 工具创建文档： **元数据管理文档标题：** - 【飞书】元数据管理使用说明 **人群/标签文档标题：** - 【飞书】用户分群使用说明 - 【飞书】用户标签使用说明 --- ## 文档生成标准 ### 元数据管理（整合6个手册） #### 标题格式 - 【飞书】元数据管理使用说明 #### 快速入门 - 1.1 定义说明：使用高亮框突出概念（信息说明light-orange） - 1.2 实际应用场景：表格呈现 #### 核心功能详解 - 1.1 基础全局功能：表格结构（功能名称、说明、截图），空白表格预留填充 ``` | 功能名称 | 说明 | 截图 | |----------|------|------| | | | | | | | | | | | | ``` - 1.2 其他功能模块（6个功能）：全部表格化，使用`<lark-table>`组件，列宽120/350/180 **元事件管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建事件 | 手动创建/批量创建 | 📸 | | 编辑事件 | 显示名/事件名/应埋点平台/标签/触发时机等 | 📸 | | 删除事件 | 无数据上报事件可删除 | 📸 | | 搜索与筛选 | 搜索事件名/显示名，筛选显示状态/标签/平台 | 📸 | | 批量操作 | 批量显示/隐藏/添加标签/修改标签 | 📸 | | 停止/允许接收 | 控制事件数据是否入库 | 📸 | | 数据上报状态查看 | 查看各平台数据上报情况 | 📸 | | 下载埋点方案文档 | 一键下载完整数据采集方案 | 📸 | **事件属性管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建属性 | 手动创建/批量创建 | 📸 | | 编辑属性 | 属性名/显示名/类型等 | 📸 | | 删除属性 | 无数据上报属性可删除 | 📸 | | 属性类型 | 文本/数字/日期/布尔/URL等 | 📸 | | 搜索与筛选 | 搜索属性名/显示名 | 📸 | **虚拟属性管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建虚拟属性 | 基于公式创建 | 📸 | | 编辑虚拟属性 | 修改公式 | 📸 | | 删除虚拟属性 | 删除虚拟属性 | 📸 | | 虚拟属性公式 | 支持多种函数和运算 | 📸 | **虚拟事件管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建虚拟事件 | 基于规则创建 | 📸 | | 编辑虚拟事件 | 修改规则 | 📸 | | 删除虚拟事件 | 删除虚拟事件 | 📸 | | 虚拟事件规则 | 支持多条件组合 | 📸 | **维度表管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建维度表 | 新建维度表 | 📸 | | 编辑维度表 | 修改表结构 | 📸 | | 删除维度表 | 删除维度表 | 📸 | | 字段配置 | 配置字段类型/主键等 | 📸 | | 数据导入 | 导入数据到维度表 | 📸 | **物品属性管理表格：** | 功能名称 | 说明 | 截图 | |----------|------|------| | 创建物品属性 | 创建物品级属性 | 📸 | | 编辑物品属性 | 修改属性配置 | 📸 | | 删除物品属性 | 删除物品属性 | 📸 | | 物品类型配置 | 配置物品类型 | 📸 | > 📸 **截图提示**：截图可按需插在表格最后一列 #### 常见问题解答 - 使用相关 - 配置相关 - 数据相关 #### 文档维护 - 版本记录 - 使用建议 - 意见反馈 --- ### 人群与标签（原规范） #### 标题格式 - 【飞书】用户分群使用说明 - 【飞书】用户标签使用说明 #### 快速入门（5分钟上手） - 1.1 定义说明：使用高亮框突出概念 - 1.2 实际应用场景：表格化呈现 - 1.3 2分钟完成第一个人群/标签： - 横向Mermaid流程图（graph LR） - 操作要点速览 - 截图标记 #### 核心功能详解 - 2.1 基础全局功能：表格结构（功能名称、说明、截图），空白表格预留填充 ``` | 功能名称 | 说明 | 截图 | |----------|------|------| | | | | | | | | | | | | ``` - 2.2 其他功能模块：全部表格化，使用`<lark-table>`组件，列宽120/350/180 #### 实践应用模板 - 数量：2-3个标准模板 - 结构：使用场景、配置要点、预期产出 #### 常见问题解答 - 使用相关 - 配置相关 - 数据相关 #### 文档维护 - 版本记录 - 使用建议 - 意见反馈 --- ## 输出结果 生成文档成功后，向用户返回： 1. ✅ 文档链接 2. ✅ Doc ID 3. ✅ 文档符合的规范说明 4. ✅ 文档结构概览 --- ## 常见问题 ### Q: 元数据管理需要一次性提供6个链接吗？ A: 是的，元数据管理模块需要一次性提供6个手册链接，系统会整合后生成一份统一的文档。 ### Q: 用户提供的链接不是神策官网怎么办？ A: 提示用户需要提供神策官方手册链接，格式为 `https://manual.sensorsdata.cn/sa/docs/...` ### Q: 抓取内容失败怎么办？ A: 可能页面使用了JavaScript渲染，尝试使用其他方式获取内容，或告知用户手动复制文档内容 ### Q: 如何区分使用哪种规范？ A: 根据用户提供的链接判断： - 链接包含 metadata（6个）：使用元数据管理规范（去掉2分钟/去掉实践应用模板） - 链接包含 User_Group 或 tag：使用原规范


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)