Agent Skills
› Datus-ai/Datus-agent
Datus-ai/Datus-agent
GitHubAirflow工作流执行指南，涵盖故障排查、作业更新与删除流程及连接配置规范。
Install All Skills
npx skills add Datus-ai/Datus-agent --all -g -y
Skills in Collection (31)
Airflow工作流执行指南，涵盖故障排查、作业更新与删除流程及连接配置规范。
Airflow任务失败排查
修改或更新调度作业
删除Airflow作业
npx skills add Datus-ai/Datus-agent --skill airflow-workflow -g -y
BI仪表盘验证技能，在生成运行结束时自动检查Dashboard、Chart和Dataset的配置正确性及数据存在性，确保发布质量。
BI仪表盘生成任务完成
需要验证Dashboard配置和数据完整性
npx skills add Datus-ai/Datus-agent --skill bi-validation -g -y
指导Agent从零创建新的Datus技能，包括前期调研、一次性向用户确认关键配置（名称、位置等），以及按照标准Schema编写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 的持久化节点配置，确保作用域精确且符合运行时规范。
需要为工作流添加持久化的子智能体节点
需将现有数据资产（表/指标/SQL）关联到特定 Agent
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生成（含类型映射）、数据转移及迁移后对账，支持全量与增量模式。
需要跨数据库引擎迁移数据
重建目标表以修正跨库类型映射
npx skills add Datus-ai/Datus-agent --skill data-migration -g -y
指导基于严格 OSI YAML 规范构建 Dosi 语义模型，涵盖数据集、字段、关系及指标的编写规则。重点强调使用 DDL 声明作为键和关系的唯一证据，禁止通过查询数据推断主键或外键，确保语义模型的准确性和可验证性。
需要创建或修改 Dosi 语义模型文件
定义数据集与物理表的绑定关系
配置指标或字段的元数据和上下文
npx skills add Datus-ai/Datus-agent --skill dosi-semantic-authoring -g -y
从问答与黄金SQL对中提取最短原子业务事实，生成可复用知识文件。支持通过模拟起草或驱动子智能体盲迭代两种方式发现知识缺口，并持久化至指定目录以增强LLM能力。
用户要求提取业务知识点
提供问题与标准SQL对
npx skills add Datus-ai/Datus-agent --skill extract-knowledge -g -y
根据自然语言业务描述生成 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中创建、更新和检查仪表盘，包括规划布局、创建仪表盘及基于现有数据源表的图表面板，强调直接嵌入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 语义模型
将数据库表转换为可分析的语义层配置
npx skills add Datus-ai/Datus-agent --skill metricflow-semantic-authoring -g -y
分析并优化现有 Datus 技能，基于真实使用数据改进指令、触发描述和脚本，提升技能触发率与执行效果。
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或自然语言转化为业务含义明确的指标表达式。严格限定于语义层编写，不涉及执行引擎语法，需复用现有数据集并调用特定工具进行增删改操作。
需要创建新的业务指标
需要更新现有指标的定义或表达式
需要删除不再使用的指标
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、指标定义及偏好等知识，通过 storage-classify 分类并持久化存储。生成摘要清单供用户确认后执行写入，避免无谓的 token 消耗。
会话结束或需要总结时
用户要求捕获学习到的内容
npx skills add Datus-ai/Datus-agent --skill session-summarize -g -y
该技能用于对生成的内容进行分类并路由到正确的持久化存储。它根据数据类型（如SQL、指标、知识等）将任务委派给专用子代理或直接编辑文件，确保数据被正确索引和保存，同时避免重复生成。
需要决定产出物的持久化位置
处理业务事实或验证后的SQL
分类和路由元数据或会话偏好
npx skills add Datus-ai/Datus-agent --skill storage-classify -g -y
用于在 Apache Superset 中创建、更新和检查仪表板。通过定位数据库、注册数据集、规划布局并依次创建仪表板和图表，实现数据可视化资产的管理与组装。
需要创建新的 Superset 仪表板
需要在 Superset 中构建或更新数据可视化图表
需要管理 Superset 中的数据源和仪表板结构
npx skills add Datus-ai/Datus-agent --skill superset-dashboard -g -y
验证新创建或写入表的列契约，包括列名、数据类型和空属性是否与预期一致。适用于ETL或数据仓库场景下的表结构校验。
需要验证表结构是否符合定义的列契约
数据管道中表写入后需进行元数据一致性检查
npx skills add Datus-ai/Datus-agent --skill table-validation -g -y
用于数据迁移后的轻量级对账校验。在传输完成后自动触发，通过比对工具报告的行列数、执行目标端计数查询及样本读取，验证数据一致性，避免昂贵的源端重扫。
数据传输任务完成
生成TransferTarget交付物
npx skills add Datus-ai/Datus-agent --skill transfer-reconciliation -g -y
基于SQL查询结果生成格式化数据报告，支持多种输出格式。
需要生成数据报表
将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并刷新索引。
用户执行 /build-kb 命令
需要更新或重建项目的向量知识库
npx skills add Datus-ai/Datus-agent --skill build-kb -g -y
根据业务描述生成含趋势和异常信号的合成数据仓库，并加载至活跃数据源。适用于构建演示库、种子数据或从DDL生成样本数据，支持AI查询和商业报告。
用户要求构建演示数据库
需要为数据源播种/生成模拟测试数据
根据DDL生成业务示例数据
npx skills add Datus-ai/Datus-agent --skill gen-datasource -g -y
轻量级项目初始化技能，快速扫描文件与数据库元数据，推断业务目标并分类领域。生成AGENTS.md库存骨架及低成本的文件知识库和记忆存储，跳过昂贵的向量索引构建，实现无确认的一次性低Token成本初始化。
需要快速建立项目工作区上下文
初始化项目时仅需基础地图和知识快照
避免高成本的向量存储生成
npx skills add Datus-ai/Datus-agent --skill init -g -y
提供SQL查询优化技巧与最佳实践，包括分析执行计划、检查缺失索引、将子查询重写为JOIN以及使用EXPLAIN验证改进效果。
需要优化慢查询时
数据库性能问题排查
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
