SuperAPI AI 工具集

runbooks

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:runbooks 用于在运维任务或事故中,为其他响应者提供可安全执行的逐步操作流程,尤其适合需要回滚、失败关闭或共存安全回退的场景。它把运维知识转化为可执行程序,而非长篇理论文档。

主要能力:定义触发条件与负责人,包括激活手册的告警或症状、启动人、适用严重级别及何时升级;记录前置条件与安全边界,如执行前必须满足的条件、需保留的路径、不安全时应失败关闭、优先回滚还是部分手动修复,以及阈值或策略来源;编写带编号的响应步骤,包含明确决策点、命令/仪表盘/检查项、预期观察结果、回滚/回退/升级分支条件,以及通信阈值或预期恢复窗口等具体来源或数值;添加验证与沟通,说明如何确认缓解生效、哪些指标或日志证明恢复、通知谁及频率、需为事后跟进保留哪些证据;保持手册可执行,验证非作者也能遵循,并在事故、演练失败或重大发布变更后更新。

输出:operational-runbook 与 escalation-checklist。

使用方式:作为生命周期技能链的一部分,输入来自 incident-playbook、monitoring-config 和 ci-cd-pipeline。公开安装面为 skills/.curated,规范编写源为 skills/07-operations/runbooks/SKILL.md,该包导出以兼容 npx skills add/update。

适用场景:需要具体逐步程序且另一响应者可安全执行的运维任务或事故,特别是涉及回滚、失败关闭和共存安全回退的棕地系统。

限制:资料未提供具体命令、阈值数值、平台或收费信息;打包稳定性与能力就绪度均为 beta。质量门要求触发与负责人明确、决策点与分支条件明确、包含回滚或失败关闭路径、包含恢复验证与沟通步骤,且另一响应者无需即兴发挥即可执行。反模式包括叙事代替程序、仅作者掌握的知识、无回滚或安全停止分支、过时环境细节、缺少沟通检查点、魔法阈值。