Agent Skills
› Datus-ai/Datus-agent
Datus-ai/Datus-agent
GitHubAirflow定时任务执行指南，涵盖故障排查、作业更新与删除流程，指导Agent通过API操作调度器及连接配置。
Install All Skills
npx skills add Datus-ai/Datus-agent --all -g -y
Skills in Collection (30)
Airflow定时任务执行指南，涵盖故障排查、作业更新与删除流程，指导Agent通过API操作调度器及连接配置。
排查Airflow作业失败原因
修改或更新现有Airflow作业配置
删除已存在的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 编写规范。
创建新技能
搭建技能目录结构
将工作流固化为可复用技能
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和指标，路由至专用Agent处理，实现查询上下文初始化与数据源解析。
用户请求初始化仪表板上下文
需要导入或提取仪表板中的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语义模型、数据集、指标及结构化窗口的YAML标准化编写，支持OSI核心契约与DATUS扩展定义。
编写或更新Dosi语义模型YAML文件
定义数据集字段与物理表映射
创建带有时间维度的业务指标
配置窗口计算逻辑（如滚动、累计）
npx skills add Datus-ai/Datus-agent --skill dosi-semantic-authoring -g -y
从问题与黄金SQL对中挖掘最短原子业务事实，通过模拟或驱动子代理生成候选SQL并对比差异，提取缺失的业务规则、过滤条件等知识，持久化至知识库以增强LLM准确性。
用户要求从SQL对中提取业务知识
需要补充数据库领域常识
npx skills add Datus-ai/Datus-agent --skill extract-knowledge -g -y
通过自然语言业务描述生成 MetricFlow 指标，支持单条及批量处理。需读取 SQL 证据、理解意图、探测输入模式，并基于表结构和参考 SQL 提出指标候选方案。
用户希望将自然语言业务需求转化为 MetricFlow 指标定义
需要基于现有 SQL 或表结构自动生成指标配置
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仪表盘配置
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语义模型
根据数据库表结构生成YAML配置
验证语义模型的字段分类规则
npx skills add Datus-ai/Datus-agent --skill metricflow-semantic-authoring -g -y
分析现有技能的使用会话数据，诊断工具调用模式与执行瓶颈，生成优化建议并重构 SKILL.md 指令与描述，提升触发准确率与执行效果。
用户要求优化或改进现有技能
技能触发率低或执行失败需要修复
npx skills add Datus-ai/Datus-agent --skill optimize-skill -g -y
用于在OSI语义模型中创建、更新或删除指标，定义业务含义、表达式及上下文，严格遵循核心语义规范，不涉及执行引擎语法。
需要新增或修改OSI指标定义
根据SQL或自然语言生成指标元数据
删除不再需要的OSI指标
npx skills add Datus-ai/Datus-agent --skill osi-metrics-authoring -g -y
定义OSI核心语义模型编写规范，明确字段角色（维度、键、度量）的声明规则及结构约束，指导生成符合标准的语义文档。
编写或定义OSI核心语义模型
确定数据字段的语义角色
生成符合OSI规范的YAML/JSON schema
npx skills add Datus-ai/Datus-agent --skill osi-semantic-authoring -g -y
基于ValidationHook对调度作业进行只读静态验证，检查Cron表达式、配置及最近运行状态，不触发测试。
用户需要验证调度作业的配置正确性
检查调度作业的最新运行日志和状态
npx skills add Datus-ai/Datus-agent --skill scheduler-validation -g -y
在编写语义模型YAML前，通过分析历史SQL和列分布数据来挖掘证据。该工作流用于生成统计信息、数据分布分析及SQL挖掘，为模型形状决策提供依据，包括关系推断、键验证及字段描述优化。
用户显式请求进行性能分析、统计数据收集、数据分布分析或历史SQL挖掘
需要在编写语义模型YAML之前获取数据特征证据
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
验证新创建表的列契约，包括列名集合、数据类型和空值约束是否符合预期。仅关注元数据校验，不包含数据内容断言或对象存在性检查。
表结构写入后需要验证列定义
ETL任务中CTAS生成的表需确认Schema一致性
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查询结果生成格式化数据报告的工具，支持通过脚本指定输出格式（如JSON）。
需要导出SQL查询结果为结构化报告
将数据库数据转换为JSON等特定格式
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。通过解析范围、并行探索数据并分类路由至存储，最终更新索引。
用户调用 /build-kb 命令
需要重建或更新项目的向量知识库
npx skills add Datus-ai/Datus-agent --skill build-kb -g -y
轻量级项目初始化技能，通过扫描文件树和数据库元数据，推断项目目标与业务领域，生成AGENTS.md骨架及低成本知识存储，为下游Agent提供项目地图。
用户发起新项目初始化请求
需要快速构建项目上下文映射
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
