用途:eng-runbook 是一个工程 Runbook 生成技能,目标是产出一份单页工程运维手册(Service Runbook),供团队在告警、值班和事故处理时快速查阅。
主要能力:按固定结构组织内容,包括:页头(服务名、负责团队、严重级别、版本);服务摘要段落与依赖列表;告警表(告警名/严重级别/含义/首要响应);仪表盘与链接列表;常用操作块(3–4 个,含可复制命令,如部署、回滚、轮换密钥);值班轮换表(周/主/备/后备);事故响应清单(5 个编号步骤)。输出为语义化 HTML,使用一个内联 <style>,代码块用等宽字体。
使用方式:工作流为先读取 DESIGN.md,再从需求简述中识别服务,然后按上述布局生成内容。输出契约要求以 artifact 形式给出,标识符为 runbook-name,类型 text/html,标题为 Service Runbook,内容以 <!doctype html> 开头。
适用场景:需要为某个服务快速建立或更新运维手册、统一告警响应流程、明确值班职责与事故处理步骤的工程团队。
限制:资料未提供具体安装命令、依赖环境、收费方式或平台支持信息;生成内容依赖 DESIGN.md 与需求简述的输入质量,具体命令需按实际服务填写。