KQL 查询精通
帮助编码代理编写高效、可靠且更少出错的 KQL 查询。
内容主要提供查询指导，没有发现恶意代码、凭据窃取或隐蔽外传；但包含 .create、.set、.drop、外部数据和托管身份连接示例，缺少执行前用户确认、权限最小化、敏感数据处理、数据流披露及回滚说明，因此扣分。MIT 许可和微软来源提供有限归属证据，但不能替代安全控制。
文档覆盖语法、性能、错误恢复和大量示例，错误反馈通常具有可诊断性；但静态材料未证明关键路径可运行，部分建议过于绝对，且存在潜在不一致，例如某些窗口函数示例把 serialize 放在使用函数之后、连接基数规则较粗略，因此在静态上限内扣分。
目标用户、KQL/ADX/Fabric/Log Analytics 等场景和触发词描述清楚，覆盖查询编写、调试和审查；但未充分声明不适用边界、版本差异、权限前提或环境限制，触发条件过宽，且未提供中文支持。公共帮助集群依赖主要影响示例验证，不构成核心功能完全不可达，因此未作全面环境扣分。
结构分层较好，包含主文档、专题参考、发现查询、错误恢复和模板，安装方式由仓库 README 提供；但该技能缺少独立版本、变更记录、维护责任、更新路径、FAQ 和依赖/权限说明，且已标注仓库处于持续开发状态，因此扣分。许可证信息清楚。
对常见 KQL 查询错误、资源控制、连接、动态类型、时间序列和模式发现提供了可直接改写的模板，核心任务价值明确；但示例正确性和跨引擎适用性未被静态验证，部分高级内容需要特定集群、表或功能，用户仍需根据实际 schema 和版本复核，因此扣分。
材料给出公开帮助集群、Samples 数据库和声称的真实错误示例，具备有限可复核性；但没有提交的、覆盖该技能关键路径的测试套件或 CI 证据，来源引用也主要是文档内链接和作者陈述，静态审查不支持更高分。
- 执行管理命令、外部数据读取或外部表连接前，应明确确认目标、权限、数据范围和可逆性。
- 不要把帮助集群、Samples 表或特定引擎行为视为所有 KQL 环境都可用；应先检查实际 schema、版本、插件和权限。
- 建议修正并测试窗口函数、连接基数和高级图/向量示例，补充版本、限制、维护和中文使用说明。
它能做什么 & 适用场景
该技能为 Kusto Query Language 提供系统化查询指导，适用于 Azure Data Explorer、Microsoft Fabric Real-Time Intelligence、Azure Monitor Log Analytics 和 Microsoft Sentinel 等服务。内容覆盖管道语法、动态类型转换、连接限制、正则表达式、序列化、内存管理、结果大小控制、时间日期处理及高级函数。它还提供错误信息到修复方案的对照表，帮助代理针对具体错误进行修正。技能适合经常编写、调试或审查 KQL 的开发者和数据分析人员。
指导代理生成、调试和审查 KQL 查询；解释查询平面与管理平面的区别；检查动态字段在分组、排序和连接中的显式类型转换；设计等值连接、预分桶和连接基数检查；修正正则表达式捕获组、窗口函数序列化和日期时间字面量问题；提供内存安全、结果限流、向量列裁剪以及地理、向量、图和时间序列函数示例。示例可连接公开的 Kusto 帮助集群进行验证。
- Azure Data Explorer 用户需要在大型表上编写带时间范围过滤和聚合的查询。
- Log Analytics 或 Sentinel 用户遇到 dynamic 类型、日期时间或字符串比较错误。
- 数据工程师需要在 KQL 中设计连接，并避免范围连接或高基数连接造成查询失控。
- 分析人员需要使用正则表达式、时间序列异常检测、地理计算或图查询。
- 编码代理需要审查一条 KQL 查询，控制扫描数据量、结果大小和内存风险。
优缺点一览
- 覆盖 KQL 中容易导致重试和高成本查询的具体陷阱。
- 提供可直接改写的错误示例、修复示例和自纠错对照表。
- 同时涵盖基础查询、性能安全、正则表达式、时间序列、地理、向量和图函数。
- 技能采用仅含 name 和 description 的标准 SKILL.md 前置元数据。
- 范围专注于 KQL 查询，不提供 Azure 资源配置或 SDK 编程指导。
- 部分高级示例依赖公开帮助集群，运行验证需要网络访问。
- 来源未提供 kql 技能专属的测试覆盖或验收结果。
- README 标注仓库仍在积极开发中，内容可能继续更新。
如何安装
在 Copilot CLI 或兼容的技能安装流程中运行：
npx skills add microsoft/skills
在向导中选择 kql。README 说明技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/；该技能的文件路径为 .github/skills/kql/SKILL.md。README 未提供仅安装 kql 的独立命令。
如何使用
在需要编写、调试或审查 KQL 时明确提及 KQL、Kusto、ADX、Azure Data Explorer、Log Analytics、Sentinel、Fabric Real-Time Intelligence 或相关查询操作。例如："请审查这条 KQL 查询，检查 dynamic 类型、连接基数、时间过滤和结果大小风险。" 若要运行示例，可使用公开帮助集群 https://help.kusto.windows.net 的 Samples 数据库；具体代理客户端的触发命令未在来源中说明。