用途:为微服务或内部平台服务生成一份完整的服务目录条目,让公司内任何工程师都能了解该服务做什么、如何依赖、可靠性特征以及出问题时找谁。
主要能力:按固定结构输出条目,包括服务身份(名称、仓库、负责团队、技术负责人、值班轮换、Slack 频道、支持层级、状态、语言运行时、部署平台、环境);用通俗语言描述服务用途与边界;架构上下文与上下游依赖表;SLA(可用性、延迟 SLO、错误预算、支持层级、维护窗口);API 契约(认证、Base URL、关键端点、版本策略、错误响应格式与错误码);发布的事件;数据分类(敏感度、存储位置、保留期、加密);运维手册与监控面板;已知限制;入门步骤与客户端库。
使用方式:技能会先要求提供必要输入,包括服务名称、团队与负责人、架构概览、SLA 要求、关键 API、处理的数据;若未提供则主动询问。随后按模板填充并输出。
适用场景:新服务上线需登记目录、已有服务补全文档、跨团队共享服务需要明确依赖与支持路径时。
限制:资料未提供具体安装命令、运行环境或调用方式;输出质量取决于输入信息的完整与准确,技能本身强调不得写空泛的 SLO、不得留 TODO 链接、不得省略已知限制。