Agent Skills
› Datus-ai/Datus-agent
Datus-ai/Datus-agent
GitHubAirflow工作流执行指南，涵盖故障排查、任务更新与删除流程。指导Agent通过API检查状态、获取日志、修复SQL或连接问题，并管理任务的暂停、恢复及元数据清理，确保调度作业的正确运行与维护。
Install All Skills
npx skills add Datus-ai/Datus-agent --all -g -y
Skills in Collection (31)
Airflow工作流执行指南，涵盖故障排查、任务更新与删除流程。指导Agent通过API检查状态、获取日志、修复SQL或连接问题，并管理任务的暂停、恢复及元数据清理，确保调度作业的正确运行与维护。
Airflow定时任务执行失败需要排查原因
用户请求修改或更新现有的Airflow SQL作业配置
用户请求删除特定的Airflow调度任务
npx skills add Datus-ai/Datus-agent --skill airflow-workflow -g -y
BI仪表盘验证技能，通过Hook在生成后检查仪表板、图表和数据的配置正确性及数据存在性，确保发布质量。
Dashboard生成任务完成时
需要验证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和指标并路由至内置代理。用于处理仪表板引导、引用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 语义模型文件
根据 DDL 定义数据集中的字段和主键关系
配置 DATUS 扩展元数据
npx skills add Datus-ai/Datus-agent --skill dosi-semantic-authoring -g -y
从问答与标准SQL对中挖掘原子业务事实，通过模拟或驱动子智能体盲测差异，提取缺失的业务规则、过滤条件等知识并持久化，提升LLM回答准确性。
用户要求从SQL对中提取业务知识
需要补充领域特定的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，确保在缺少关键信息时停止或请求澄清。
用户要求创建数据库表
提供 SELECT 语句以生成目标表
npx skills add Datus-ai/Datus-agent --skill gen-table -g -y
用于在Grafana中创建、查看和管理仪表板。提供从确认数据源到规划布局、创建仪表板及图表的标准化工作流，强调基于现有数据表构建面板并遵循特定SQL和布局规则。
用户需要创建或修改Grafana仪表板
用户请求生成BI可视化报表
用户询问如何配置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
该技能用于基于真实使用数据分析和优化现有 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逻辑，严格限定核心语义编写，不涉及执行引擎语法。
需要定义或修改数据指标的业务含义
基于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、指标定义及偏好等关键信息。通过分类并路由至指定存储库进行持久化，确保知识沉淀与复用，支持后续会话的高效检索与应用。
用户要求捕获本次会话所学内容
工作会话结束时的自动总结
npx skills add Datus-ai/Datus-agent --skill session-summarize -g -y
该技能作为路由与策展中心，负责将产生的业务事实、SQL、模型定义等工件分类并路由至对应的持久化存储（如语义模型、记忆、技能或AGENTS.md）。它不直接生成内容，而是确保数据通过正确的子代理机制写入，保障存储的规范性与上下文完整性。
需要决定新产生内容的持久化位置时
收到需归档的业务事实、SQL或模型定义时
npx skills add Datus-ai/Datus-agent --skill storage-classify -g -y
用于在 Apache 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
在数据传输任务结束后自动触发，轻量级验证源与目标行数一致性，并执行目标侧的COUNT(*)校验及样本读取，生成结构化JSON报告，避免昂贵的源端重扫描。
gen_job代理运行完成且包含TransferTarget交付物时
ValidationHook检测到transfer_query_result调用结束时
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等工件，最后刷新KB索引。支持按范围过滤及用户确认后执行。
需要构建或更新项目的向量知识库时
指定特定文件、表或数据源进行知识提取时
npx skills add Datus-ai/Datus-agent --skill build-kb -g -y
根据业务描述和行数预算生成包含趋势、季节性等特征的合成数据仓库，并加载至活动数据源，支持后续查询与报告。
构建演示数据库
创建模拟/测试业务数据
从DDL生成数据
npx skills add Datus-ai/Datus-agent --skill gen-datasource -g -y
轻量级项目初始化技能，通过扫描文件和数据库元数据推断目标与领域，生成AGENTS.md骨架及知识/记忆文件，为下游代理提供低成本项目地图。
需要快速建立项目上下文映射
用户执行 /init 命令进行初始化
npx skills add Datus-ai/Datus-agent --skill init -g -y
提供SQL查询优化技巧与最佳实践，涵盖执行计划分析、缺失索引检查、子查询改写为JOIN及EXPLAIN验证等步骤。
用户询问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
