用途:本技能为数据分析维护语义层技能。语义层是一个显式产物,用户之后可检视和引用,用来记录未来的分析应如何解释数据,例如哪个指标定义是规范的、哪个仪表板或表是最佳可信来源、回答前需检查哪些注意事项。数据任务的路由由 Data Analytics 索引技能负责;若用户希望立即用数据做事(回答指标问题、构建报告、检查数据集等),应走 index,而非本技能。本技能仅在用户要求保存数据上下文,或创建、更新、检查、修复语义层时使用。
主要能力:按运行时路由选择采集与持久化方式。采集可用结构化表单或对话式;持久化默认按情况选择三类目标之一:ChatGPT 个人 Skills(在 chatgpt_web 且运行暴露个人 Skills 安装面时安装并回传链接)、本地 Codex(写入 $CODEX_HOME/skills/<area>-semantic-layer,若不可用且使用默认主目录则用 ~/.codex/skills/<area>-semantic-layer)、便携包(无持久化目标时返回便携包或来源计划,并说明未安装及阻塞原因)。如需 ChatGPT 网页与本地 Codex 同时可用,可将同一规范包装入两处。
使用方式:每个连贯的产品、业务、指标、来源或报告区域创建一个语义层,除非用户明确要求更宽的共享层;区域可从上下文推断,仅当答案会改变爬取、目标或结果技能时才询问。爬取前先建立数据源清单,说明已检查、缺失与低置信来源;直接创建或草稿写入 references/source-inventory.md,仅规划则返回聊天。优先使用持久的来源证据,如转换代码、测试、维护中的指标文档、已验证仪表板;来源冲突时保持冲突可见而非默默选择。生成技能保持紧凑,详细定义、表、查询模式、注意事项与证据放入 references/semantic-layer/skill-template.md 的引用中,保留出处,不复制原始敏感数据、凭据、行级示例或长私密消息。创建或更新后,读取 references/semantic-layer/weekly-polling-automation.md,且当存在稳定目标路径与可用 references/source-inventory.md 时,总是提供每周刷新选项;每周刷新可选,未经明确同意不得创建,若无法提供则说明缺失前提。
适用场景:需要保存数据上下文、建立可引用的指标口径与来源、修复语义层时。限制:不可用于普通数据工作;不得编造未提供的功能、收费、价格、平台或效果;未提供的细节(如具体表单动作、更多运行时能力)暂未提供。
输出约定:报告创建、更新、检查或修复内容,来源覆盖度,用户相关注意事项或阻塞,以及可引用的确切路径或已安装技能链接;创建或更新结果需含每周刷新邀约或缺失前提,并告知可迭代;常规验证细节留在支持产物中。若为普通数据工作,说明应通过 index 路由。