service-health-check

用途

Service Health Check Skill 用于获取任意服务的整体健康概览，数据来源为 Port 的服务目录（Port's catalog）。

适用时机：

部署某个服务之前
值班轮换交接期间
调查服务问题时
规划容量或变更时

主要能力与健康检查流程

步骤 1：基本信息

使用 get_entity 查询服务实体，包含 tier、team、owner、on_call、depends_on、repository、scorecard_status 等属性。

get_entity(blueprint="service", identifier="service-name", include=[
  "tier", "team", "owner", "on_call", 
  "depends_on", "repository", "scorecard_status"
])

步骤 2：记分卡状态

检查生产就绪情况，查看记分卡属性：has_readme、has_runbook、has_monitoring、has_slo、security_scan_passed。

get_entity(blueprint="service", identifier="service-name")
# Look at scorecard properties:
# - has_readme
# - has_runbook
# - has_monitoring
# - has_slo
# - security_scan_passed

步骤 3：近期故障事件

查询该服务近 30 天（created_at >30d）的 incident 实体，按严重级别统计数量并计算 MTTR。

list_entities(blueprint="incident", query={
  primary_service: "service-name",
  created_at: ">30d"
})

按严重级别计数并计算 MTTR。

步骤 4：近期部署

查询该服务近 7 天（deployed_at >7d）的 deployment 实体。

list_entities(blueprint="deployment", query={
  service: "service-name",
  deployed_at: ">7d"
})

步骤 5：依赖健康状态

对每个依赖服务，使用 get_entity 查询，并递归检查其健康状态。

get_entity(blueprint="service", identifier="dep-service")

输出格式

输出包含 Overview（层级、团队、负责人、值班人）、Scorecard（通过项数、各检查项状态）、Incidents（按严重级别的数量与 MTTR）、Recent Deployments（日期、版本、状态）、Dependencies（服务、健康状态、层级）以及 Recommendations（建议）。示例：

# Service Health: [service-name]

## Overview
| Property | Value |
|----------|-------|
| Tier | Tier1-Critical |
| Team | payments-team |
| Owner | alice@company.com |
| On-Call | bob@company.com |

## 📊 Scorecard: 4/5 Passing
| Check | Status |
|-------|--------|
| Has README | ✅ |
| Has Runbook | ✅ |
| Has Monitoring | ✅ |
| Has SLO | ✅ |
| Security Scan | ❌ Last scan failed |

## 🚨 Incidents (Last 30 Days)
| Severity | Count | MTTR |
|----------|-------|------|
| Sev1 | 0 | - |
| Sev2 | 1 | 45min |
| Sev3 | 2 | 2h |

## 🚀 Recent Deployments
| Date | Version | Status |
|------|---------|------|
| 2026-05-04 | v2.3.5 | ✅ Success |
| 2026-05-02 | v2.3.4 | ✅ Success |

## 🔗 Dependencies
| Service | Health | Tier |
|---------|--------|------|
| user-api | 🟢 Healthy | Tier1 |
| db-primary | 🟢 Healthy | Tier1 |
| cache-redis | 🟡 Degraded | Tier2 |

## Recommendations
1. Fix failing security scan
2. Monitor cache-redis degradation

质量检查清单

已检索全部记分卡数据
已计算故障事件指标
已检查所有依赖项
已提供可执行的建议

限制

资料未提供该技能的具体安装方式、支持的运行环境与平台、是否收费等信息，暂未提供。