Agent Skills
› Datus-ai/Datus-agent
Datus-ai/Datus-agent
GitHubAirflow调度作业执行指南，涵盖故障排查、作业更新、删除及连接配置。指导Agent通过API操作Airflow，处理SQL错误、连接超时等问题，并规范Job生命周期管理流程。
Install All Skills
npx skills add Datus-ai/Datus-agent --all -g -y
Skills in Collection (30)
Airflow调度作业执行指南，涵盖故障排查、作业更新、删除及连接配置。指导Agent通过API操作Airflow，处理SQL错误、连接超时等问题，并规范Job生命周期管理流程。
Airflow任务失败需要诊断
修改或更新Airflow调度作业
删除Airflow作业
查询Airflow作业状态
npx skills add Datus-ai/Datus-agent --skill airflow-workflow -g -y
BI发布后验证技能，检查仪表盘、图表配置及数据存在性。遍历目标资源，校验图表类型、指标等配置正确性，并在支持时验证数据返回无误，最终输出通过或失败报告。
生成仪表盘任务结束后的自动验证
需要检查BI报表配置和数据完整性的场景
npx skills add Datus-ai/Datus-agent --skill bi-validation -g -y
指导如何从零创建 Datus 技能，包括研究上下文、确认需求及编写 SKILL.md。
create a skill
make a skill for
turn this into a skill
new skill
npx skills add Datus-ai/Datus-agent --skill create-skill -g -y
用于在 Datus 配置中创建或更新自定义子智能体，通过编辑 agent.yml 配置 agentic_nodes。需严格校验节点名称、工具及数据范围（表/指标/SQL），确保引用有效且符合规范。
需要创建新的专用子智能体
需要更新现有子智能体的数据范围或工具配置
npx skills add Datus-ai/Datus-agent --skill create-subagent -g -y
通过BI插件初始化仪表板SQL和指标上下文，将导出的查询路由至内置智能体处理。用于解决用户关于初始化、导入或构建仪表板参考上下文的请求。
用户要求初始化仪表板上下文
用户请求导入或提取仪表板SQL
npx skills add Datus-ai/Datus-agent --skill dashboard-bootstrap -g -y
指导跨数据库引擎的数据迁移，涵盖源/目标检查、DDL生成、数据转移及轻量级对账。适用于异构数据库间的数据同步与表结构重建。
需要迁移数据到不同数据库引擎
执行跨库类型映射与DDL生成
进行数据转移后的校验
npx skills add Datus-ai/Datus-agent --skill data-migration -g -y
指导使用Dosi原生OSI数据集、关系、指标和结构化窗口的YAML语义建模规范。涵盖模型复用语义、键值声明、关系定义及DATUS扩展配置，确保语义模型的准确性和可验证性。
创建或更新Dosi语义模型文件
编写OSI格式的YAML配置
定义数据集字段与主键约束
配置业务指标与时间维度
npx skills add Datus-ai/Datus-agent --skill dosi-semantic-authoring -g -y
从SQL问答对中提取原子业务事实，通过对比候选SQL与黄金SQL的差异发现知识缺口，并将关键规则持久化为简短文档，用于增强LLM的数据查询能力。
用户提供问题与黄金SQL对
从对话历史中恢复用户确认的问答记录
需要提取或更新领域业务知识库
npx skills add Datus-ai/Datus-agent --skill extract-knowledge -g -y
根据自然语言业务描述或SQL，引导用户生成MetricFlow指标。支持单条及批量模式，通过检查表结构、参考SQL和业务意图，推断并创建语义模型YAML中的度量与维度配置。
用户希望将业务概念转化为可计算的指标定义
用户提供SQL查询或自然语言描述需要生成MetricFlow metric yaml
npx skills add Datus-ai/Datus-agent --skill gen-metrics -g -y
根据SQL查询或自然语言描述生成数据库建表语句(CTAS/CREATE TABLE)，支持交互式确认与自动化工作流，具备输入解析、DDL生成及取消处理机制。
用户要求创建数据库表
提供SQL进行CTAS操作
用自然语言描述表结构
npx skills add Datus-ai/Datus-agent --skill gen-table -g -y
用于在Grafana中创建、更新和检查仪表板。通过规划布局，调用API创建仪表板和图表面板，支持直接嵌入SQL查询现有数据源，确保正确的读取流程和面板分组。
用户请求创建或修改Grafana仪表板
需要生成包含特定图表类型的可视化看板
询问Grafana仪表板的结构或面板配置
npx skills add Datus-ai/Datus-agent --skill grafana-dashboard -g -y
审计项目持久化存储库，检查数据分类准确性，识别重复、错误或过时条目。生成修复计划并等待确认后执行重组，确保数据结构整洁合规。
需要整理或优化项目知识库结构时
发现数据存储存在混乱、重复或分类错误时
npx skills add Datus-ai/Datus-agent --skill memory-organization -g -y
指导生成MetricFlow语义模型YAML，涵盖源数据检查、字段分类规则（度量/维度/标识符）及时间维度校验，确保模型符合规范并发布至知识库。
需要为数据库表创建MetricFlow语义模型
验证或修复MetricFlow YAML配置
根据DDL和SQL使用模式分类字段
npx skills add Datus-ai/Datus-agent --skill metricflow-semantic-authoring -g -y
该技能用于基于真实使用数据分析和优化现有 Datus 技能。通过加载技能、检索会话记录及分析工具调用模式，识别失败点与无效指令，生成改进建议并重构 SKILL.md，同时优化触发描述以提升准确率。
optimize skill
improve skill
edit skill
fix skill
skill not triggering
npx skills add Datus-ai/Datus-agent --skill optimize-skill -g -y
用于在OSI语义模型中创建、更新或删除指标，定义业务含义与表达式。严格限定于核心语义层，不编写执行引擎语法，复用现有数据集并调用特定工具进行增量变更。
需要新增或修改数据指标定义
根据SQL或自然语言生成OSI指标规范
删除不再需要的指标
npx skills add Datus-ai/Datus-agent --skill osi-metrics-authoring -g -y
定义OSI核心语义模型的编写规范，指导Agent根据字段结构区分维度、键和度量源角色。强调仅生成OSI核心文档，禁止涉及MetricFlow等执行引擎配置，确保数据模型与业务语义的正确映射及验证。
需要创建或修改OSI语义模型文件时
询问如何正确声明字段的维度、键或度量角色时
遇到OSI模型结构校验错误或需要规范化字段定义时
npx skills add Datus-ai/Datus-agent --skill osi-semantic-authoring -g -y
调度器验证技能，通过只读静态检查验证作业计划、配置及最近运行状态。不触发测试，仅报告结果，确保调度正确性并及时发现运行错误。
用户需要验证定时任务调度的正确性
检查已配置调度作业的运行历史与状态
npx skills add Datus-ai/Datus-agent --skill scheduler-validation -g -y
在编写语义模型YAML前，通过分析历史SQL和列分布数据生成证据，辅助确定模型结构、关系及字段属性。
用户明确要求分析历史SQL
需要进行数据统计或分布分析
挖掘历史SQL以构建语义模型
npx skills add Datus-ai/Datus-agent --skill semantic-sql-history-profiler -g -y
会话总结技能，用于在工作会话结束时或用户要求时，从对话中提炼并持久化有价值的业务规则、SQL、指标定义及偏好等知识，通过分类路由存储。
工作会话结束
用户明确要求捕获学习到的内容
npx skills add Datus-ai/Datus-agent --skill session-summarize -g -y
该 Skill 用于对生成的内容进行分类并路由至正确的持久化存储。它作为路由器，将语义模型、SQL、知识等分发至专用子代理或工具，确保数据存入合适位置，自身不执行写入操作。
需要决定生成内容的持久化位置
将特定类型的内容路由到对应处理流程
npx skills add Datus-ai/Datus-agent --skill storage-classify -g -y
用于在 Apache Superset 中创建、更新和管理仪表盘。通过定位数据库、注册数据集、规划布局、创建仪表盘及图表，实现数据可视化资产的全流程构建与管理。
用户请求创建新的 Superset 仪表盘
需要为特定数据源生成可视化图表或仪表板
npx skills add Datus-ai/Datus-agent --skill superset-dashboard -g -y
验证新表列契约，确保列名、类型和可空性符合预期。专注于结构校验，排除对象存在性和数据内容断言。
表创建或写入后
需要验证列定义与预期一致时
npx skills add Datus-ai/Datus-agent --skill table-validation -g -y
在数据迁移任务后自动执行轻量级校验，对比源与目标行数一致性，并验证目标表可查询性，生成结构化报告。
transfer_query_result 运行结束后
存在 TransferTarget 交付物时
npx skills add Datus-ai/Datus-agent --skill transfer-reconciliation -g -y
根据 SQL 查询结果生成格式化数据报告。通过 db_tools 执行查询后，调用脚本以指定格式输出报告。
需要生成数据报告
将 SQL 查询结果转换为特定格式
npx skills add Datus-ai/Datus-agent --skill report-generator -g -y
提供基于db_tools的SQL数据分析标准化工作流，涵盖模式发现、数据探索、查询构建及结果解读，辅助完成结构化数据洞察任务。
需要分析数据库表结构
执行SQL进行数据探索
根据问题构造并运行分析查询
npx skills add Datus-ai/Datus-agent --skill sql-analysis -g -y
负责构建项目向量知识库，扫描指定范围的文件和数据库元数据，并行探索内容并分类，经用户确认后生成语义模型、指标和SQL参考，写入LanceDB存储并更新索引。
需要构建或刷新项目的向量知识库
根据特定文件、表或业务域生成语义模型和SQL参考
npx skills add Datus-ai/Datus-agent --skill build-kb -g -y
轻量级项目初始化技能，通过扫描文件树和数据库元数据，推断项目目标与业务域，生成AGENTS.md骨架及知识/记忆存储，为下游代理提供低成本项目地图。
用户请求初始化项目工作区
需要快速构建项目上下文映射
npx skills add Datus-ai/Datus-agent --skill init -g -y
提供SQL查询优化技巧与最佳实践，包括分析执行计划、检查缺失索引、将子查询重写为JOIN以及使用EXPLAIN验证改进效果。
用户询问SQL性能问题
需要优化现有SQL查询
请求数据库性能调优建议
npx skills add Datus-ai/Datus-agent --skill sql-optimization -g -y
提供受限访问的内部数据库管理工具，支持数据库健康检查、表统计信息刷新及索引重建等操作。
需要执行数据库维护任务
进行数据库性能优化或修复
npx skills add Datus-ai/Datus-agent --skill admin-tools -g -y
用于分析数据质量、分布及异常。通过运行脚本对指定数据表进行配置文件的生成与检查，帮助识别潜在的数据问题。
需要检查数据表质量
分析数据分布特征
排查数据异常
npx skills add Datus-ai/Datus-agent --skill data-profiler -g -y
