用途:查询 Spotify Portal 中某个服务的元数据与运行信息,包括负责人、团队、值班联系人、Slack 频道、运行手册、构建、部署、运行时、事故和文档。
主要能力:通过 Portal CLI 获取服务信息。owner 工作流返回负责人、值班、Slack、运行手册等;service status 返回构建、部署、运行时、事故;service docs 返回服务文档。结果包含规范实体引用,便于后续查询。
使用方式:先运行帮助命令确认可用参数,例如 npx @spotify/portal-cli owner --help。按服务名查询:npx @spotify/portal-cli owner <service-name> --json。若用户提供实体引用,解析其 kind、namespace、name 并传入对应 owner 参数。查询状态:npx @spotify/portal-cli service status <entity-ref> --json。查询文档:npx @spotify/portal-cli service docs <entity-ref> --json。完整简报可依次运行上述工作流。运行 service 工作流前先执行 npx @spotify/portal-cli service --help,因为可用动作取决于所选 Portal 实例注册的内容。
适用场景:需要快速了解某服务的归属、联系方式和运行状况,或汇总服务简报时。
限制:不可用的工作流和维度应视为不可用,而非健康。需保留新鲜度证据和来源链接。回答应简洁并包含规范实体引用。具体可用命令与输出字段以实际 Portal 实例为准,资料未提供更多细节。