关于 eng-runbook
根据服务简介和 DESIGN.md 生成单页 HTML 工程运行手册的技能。指定版式涵盖服务信息、告警、仪表盘、操作流程、值班安排和事件响应。
主要功能
- 01读取 DESIGN.md 和服务简介
- 02概述服务及其依赖项
- 03创建告警表格
- 04列出仪表盘和链接
- 05包含操作流程和值班信息
- 06添加事件响应清单
适用场景
- 01编写精简的服务运行手册
- 02记录告警响应和操作流程
- 03整理值班安排与事件处理步骤
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mphinance/ alpha-skills --skill eng-runbook安装后在 Claude Code 中输入/eng-runbook确认已加载。
附带文件example.htmlREADME.md
详细介绍
工程运维手册技能
生成一份单页工程运维手册。
工作流
- 阅读 DESIGN.md。
- 根据简介确定服务。
- 布局:
- 页眉:服务名称、负责团队、严重性级别、版本。
- 服务摘要段落 + 依赖项列表。
- 告警表格:告警名称 / 严重性 / 含义 / 首要响应措施。
- 仪表板与链接列表。
- 常见操作流程块(3–4 个),包含代码块(部署、回滚、轮换密钥)。
- 值班轮换表格(周 / 主值班人员 / 次值班人员 / 备份人员)。
- 事件响应清单(5 个编号步骤)。
- 使用一个内联
<style>、语义化 HTML,代码块使用等宽字体。
输出约定
<artifact identifier="runbook-name" type="text/html" title="Service Runbook">
<!doctype html>...</artifact>
评论
支持 Markdown