标签查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @org-hgjhao84/tagfx 安装到当前 AI 助手中。
技能介绍
要解决的具体问题
在标签体系复杂的分析场景里,工程师常遇到几个棘手情况:随手说的“活跃用户标签”可能对应多个语义相近的精确标签,手动翻查标签列表和详情费时又容易错;想确认某个标签的规则是否生效、数据类型是什么,却要先找工具查接口,结果还容易把“规则可用”和“已有有效结果”混为一谈;更麻烦的是,明确了要查标签,却不知道当前能力和分群查询、标签维护等场景的边界,导致误用或反复排查。
核心能力与工作方式
这个技能只专注“标签查询”这一场景,核心是查找、筛选、消歧标签对象和查看已确认标签的详情,不做更复杂的操作。
处理流程有明确原则:
- 先判断用户意图——是找标签(比如系统里有哪些标签、口语名对应哪个精确对象),还是看已确认标签的详情(比如标签的定义、状态、规则可用性);
- 标签名称不唯一时,先查找候选,不会直接查详情,也不会自行选择候选,必须让用户确认后再进行下一步;
- 确认唯一标签后,查看其
name、display_name、data_type等关键信息,输出可复用的精确名称和数据类型; - 按场景加载对应参考文档:找标签时加载查找指南,看详情时加载检查指南,不会一次性加载所有内容。
适用边界与注意点
有几个必须明确的边界:
- 不处理事件、属性、分群等其他对象的查询,这些会交给对应的skill;
- 不支持标签的创建、更新、删除,也不触发标签重算;
- 如果
sensors tag get返回空,会直接告知不存,不会反复排查或跨项目查找兜底。
虽然不会像传感器评估那样反复重算,但返回的关键元数据为后续分析链路提供了可靠输入——只要标签名称准确,后续的数据传递和分析逻辑都能保持一致性。对于需要构建标签分析流程的工程师来说,它能帮你在正确、边界清晰的输入层快速完成标签定位和信息确认。
使用场景
- 在编写数据管道配置文档时,需确认口语化名称对应的精确标签对象,避免因标签歧义导致管道配置错误。
- 向团队解释现有标签的用途时,需查询标签的规则摘要和当前状态,以明确回答“这个标签具体是做什么的”。
- 整理最新完整的标签清单时,需按已知名称快速筛选出所有匹配的候选标签,减少手动查找的工作量。
- 在排查数据接入问题时,需确认已明确名称的标签的数据类型和规则可用性,验证数据接入结构的合理性。
适合人员
- 数据平台工程师,需要为管道配置确认标签标识,避免标签歧义导致的功能异常。
- 数据治理专员,需要核对现有标签的元数据,确保团队对标签定义的认知一致。
- SQL分析师,需要为临时查询准备精确的标签名称,保证查询语句的有效性。
- 业务分析师,需要查看标签规则摘要,向业务方解释标签的业务含义。