用途
DX Data Navigator 是一个技能(skill),用于通过 DX Data MCP 服务器的 PostgreSQL 数据库查询开发者体验(Developer Experience,DX)数据。它适用于分析开发者生产力指标、团队效能及相关工程数据。
安装方式
可以通过以下命令安装:
gh skill install pskoett/pskoett-skills dx-data-navigator
使用 Agent Skills CLI 的备用方式:
npx skills add pskoett/pskoett-skills/skills/dx-data-navigator
主要能力
该技能通过 mcp__dx-mcp-server__queryData 工具执行 SQL 查询。当不确定表名或列名时,建议先查询 information_schema.columns。其覆盖的数据域包括:
- 核心 DX 指标:调查快照(survey snapshots)中的团队得分、基准与情绪数据。关键表包括
dx_snapshots、dx_snapshot_teams、dx_snapshot_items、dx_snapshot_team_scores。条目类型包含 core4(Effectiveness、Impact、Quality、Speed)、kpi、sentiment、workflow、workflow_averages、csat。 - 团队与用户:组织结构、团队层级、用户档案。关键表有
dx_teams、dx_users、dx_team_hierarchies、dx_groups。 - 拉取请求(PR):周期时间、评审等待时间与吞吐量。关键表有
pull_requests、pull_request_reviews、repos。指标单位均为秒,除以 3600 可换算为小时。 - 部署与事故:部署频率、成功率与事故跟踪(用于 DORA 指标)。关键表有
deployments、incidents、incident_services。 - AI 工具:AI 编码助手采用跟踪(如 GitHub Copilot)。关键表有
ai_tools、ai_tool_daily_metrics、github_copilot_daily_usages、github_users。 - Issue 跟踪:项目管理数据,包括 issue、sprint 与周期时间(如 Jira)。关键表有
jira_issues、jira_projects、jira_sprints等。 - 服务目录:包含服务、团队、域与归属关系的软件目录。关键表有
dx_catalog_entities、dx_catalog_entity_owners、dx_catalog_entity_types。 - 流水线与代码质量:CI/CD 流水线运行与代码质量指标(如 SonarCloud)。关键表有
pipeline_runs、sonarcloud_issues、sonarcloud_projects、sonarcloud_project_metrics。 - Issues:来自源代码控制平台的规范化 issue 数据(如 GitHub Issues)。关键表有
issues、github_issues、github_issue_labels、github_labels。 - 文档:文档与知识库活动(如 Confluence、wiki)。关键表有
confluence_spaces、confluence_pages、confluence_page_versions、confluence_users、confluence_page_labels。
使用方式
通过 mcp__dx-mcp-server__queryData(sql: "SELECT ...") 执行查询。技能资料中提供了多种常见查询模式,包括 DORA 指标(部署频率、变更前置时间、平均恢复时间 MTTR、变更失败率)、基于时间的趋势、历史 DX 调查对比等。此外还提供了团队表选择指导:dx_teams 用于当前组织结构;dx_snapshot_teams 用于 DX 调查快照中的团队(DX 得分);dx_versioned_teams 用于特定日期的历史团队结构。查询 DX 调查得分时通过 dx_snapshot_teams 连接,并使用 GROUP BY 避免重复。
适用场景
适用于查询和分析开发者体验数据,包括团队 DX 得分、开发者生产力指标、PR 与部署指标、DORA 指标、AI 编码助手采用率、Jira sprint 速率、CI/CD 流水线成功率、Confluence 文档活动等。
限制与数据质量说明
资料中列出的已知问题包括:部分团队名称可能包含拼写错误,需通过查询 dx_teams 验证;incident_services 表为空,事故无法关联到具体服务;dx_users 的 AI 采用日期字段大多为 NULL,建议改用 github_copilot_daily_usages;DX 调查得分可能存在重复,需始终使用 GROUP BY 与 MAX() 聚合。