Agent Skills
› Datus-ai/Datus-agent
Datus-ai/Datus-agent
GitHubAirflow工作流执行指南，涵盖故障排查、作业更新与删除流程，提供状态检查、日志分析、SQL修复及连接配置等标准化操作步骤。
Install All Skills
npx skills add Datus-ai/Datus-agent --all -g -y
Skills in Collection (31)
Airflow工作流执行指南，涵盖故障排查、作业更新与删除流程，提供状态检查、日志分析、SQL修复及连接配置等标准化操作步骤。
Airflow任务运行失败需要排查原因
需要修改或更新现有的Airflow调度作业
需要安全地删除不再需要的Airflow作业
npx skills add Datus-ai/Datus-agent --skill airflow-workflow -g -y
BI验证技能，通过ValidationHook在仪表盘生成后检查图表配置、数据集连接及数据存在性。遍历目标资源，验证指标、维度等配置正确性及数据返回结果，确保发布标准达标并输出报告。
仪表盘生成任务结束
需要验证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。需验证名称、解析数据源上下文及知识库范围，确保配置符合运行时契约。
需要创建新的持久化子代理节点
需要修改现有子代理的配置或作用域
npx skills add Datus-ai/Datus-agent --skill create-subagent -g -y
通过BI插件引导仪表盘SQL和指标上下文，路由至内置Agent处理。用于初始化、导入或提取仪表板参考SQL及语义模型，确保数据源匹配与合规导出。
用户请求初始化或构建仪表板上下文
用户请求从仪表板导入或提取参考SQL
用户请求从仪表板获取语义模型或指标
npx skills add Datus-ai/Datus-agent --skill dashboard-bootstrap -g -y
用于不同数据库引擎间的数据迁移技能，涵盖源表检查、目标DDL生成（含类型映射）、数据转移及迁移后对账的全生命周期。
跨数据库引擎迁移数据
重建目标表以修正类型映射
迁移后数据对账
npx skills add Datus-ai/Datus-agent --skill data-migration -g -y
指导 Dosi 语义建模，涵盖 OSI 数据集、关系和指标的规范编写。提供源表字段声明、主键识别、多对多关系定义及度量表达式构建的严格规则，确保模型符合 DATUS 扩展合同与原生验证标准。
需要创建或修改 Dosi 语义模型文件
定义数据集中的字段、度量或表间关系
查询如何正确声明主键和外键约束
遵循 DATUS 能力组合与扩展规范
npx skills add Datus-ai/Datus-agent --skill dosi-semantic-authoring -g -y
从问答与黄金SQL对中挖掘原子业务事实，生成短小可复用的知识文件。支持lite模拟或deep盲测驱动子智能体，严格隔离敏感数据，自动更新知识库索引。
用户请求提取业务逻辑或SQL规则
需要构建或更新领域知识库
npx skills add Datus-ai/Datus-agent --skill extract-knowledge -g -y
根据自然语言业务描述或SQL，引导用户完成MetricFlow指标的定义与生成。通过解析表结构、参考SQL及业务意图，自动识别度量、维度和约束，输出语义模型YAML配置。
需要根据业务描述生成数据指标
需要将现有SQL转换为MetricFlow语义模型
需要批量处理多个指标的元数据定义
npx skills add Datus-ai/Datus-agent --skill gen-metrics -g -y
根据SQL或自然语言描述生成数据库表结构。支持CTAS和CREATE TABLE模式，自动解析源表结构并生成DDL，提供交互式确认机制。
用户需要创建新的数据库表
用户提供SQL语句要求转为表结构
用户用自然语言描述表需求
npx skills add Datus-ai/Datus-agent --skill gen-table -g -y
用于在Grafana中创建、查看和管理仪表盘及面板。通过确认数据源、规划布局、生成仪表盘ID并编写SQL构建图表，实现可视化监控面板的自动化组装与验证。
用户请求创建Grafana仪表盘
需要配置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结构和字段分类
将配置好的语义模型发布至知识库
npx skills add Datus-ai/Datus-agent --skill metricflow-semantic-authoring -g -y
用于分析和优化现有 Agent Skill，通过加载技能、检索使用会话、分析工具调用模式，生成改进建议并重构 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逻辑，严格限定核心语义编写，不涉及执行引擎语法。
需要定义或修改数据指标的业务含义
基于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
用于验证调度作业的计划正确性、配置及运行状态。通过只读检查 cron 表达式、作业配置及最近一次运行日志，判断任务是否通过或失败，不触发实际测试运行。
用户需要验证定时任务的配置和计划是否正确
系统自动执行调度器运行后的静态验证环节
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、指标定义等有价值信息，分类后持久化存储。通过生成摘要清单供用户确认，避免无谓的token消耗。
工作会话结束
用户要求捕获已学内容
npx skills add Datus-ai/Datus-agent --skill session-summarize -g -y
负责分类并路由持久化内容至指定存储，协调子代理完成数据写入。
需要保存业务事实、SQL或模型定义时
多类型内容需分发至不同存储时
npx skills add Datus-ai/Datus-agent --skill storage-classify -g -y
用于在 Apache Superset 中创建、更新和管理仪表盘。涵盖定位数据库、注册数据集、规划布局、创建仪表盘及图表的完整工作流，支持物理和虚拟数据集。
需要创建或修改 Superset 仪表盘
需要在 BI 数据库中注册新数据集并构建可视化图表
npx skills add Datus-ai/Datus-agent --skill superset-dashboard -g -y
验证新创建表的列契约，包括列名、类型和空值约束是否与预期一致。该技能专注于Schema结构校验，明确排除对象存在性、行数及数据内容断言。支持多表会话循环检查并输出详细结果。
新建或写入表后需验证Schema
需要检查列集合、数据类型及Nullability一致性
npx skills add Datus-ai/Datus-agent --skill table-validation -g -y
在数据迁移任务结束后自动触发，通过对比工具报告的行数及执行目标端轻量级校验（如COUNT(*)），验证数据传输的一致性，避免昂贵的源端重扫描。
数据迁移任务完成
生成TransferTarget交付物
npx skills add Datus-ai/Datus-agent --skill transfer-reconciliation -g -y
根据SQL查询结果生成格式化数据报告。通过db_tools执行查询，并调用脚本以指定格式（如JSON）输出报告。
用户请求从数据库提取数据并生成报表
需要将SQL查询结果转换为特定格式文件
npx skills add Datus-ai/Datus-agent --skill report-generator -g -y
提供基于db_tools的SQL数据分析引导工作流，涵盖模式发现、数据探索、查询构建及结果解读，旨在结构化地辅助用户完成数据库分析任务。
需要分析数据库表结构
执行SQL查询进行数据探索
根据业务问题构建分析查询
解读SQL查询结果
npx skills add Datus-ai/Datus-agent --skill sql-analysis -g -y
构建项目向量知识库，扫描文件与数据库元数据，分类业务域并生成语义模型、指标及参考SQL，写入LanceDB存储并刷新索引。
用户执行 /build-kb 命令
需要更新或初始化向量知识库索引
npx skills add Datus-ai/Datus-agent --skill build-kb -g -y
根据业务描述生成包含趋势、异常等特征的合成数据仓库，并加载至DuckDB供查询。用于构建演示库、种子数据或测试样本。
用户要求构建演示数据库
需要为数据源播种示例数据
创建模拟/测试业务数据
基于DDL生成数据
npx skills add Datus-ai/Datus-agent --skill gen-datasource -g -y
轻量级项目初始化技能，仅读取SQL元数据、文档和数据库Schema，生成包含已确认事实的项目地图和知识文件，推断内容作为待确认问题返回。
需要快速建立下游Agent可用的项目上下文映射
初始化数据项目 workspace
npx skills add Datus-ai/Datus-agent --skill init -g -y
提供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
