SuperAPI AI 工具集

runbook-generator

部署与运维

查看项目

更新于 10-15 17:28

技能介绍

用途:分析代码库并生成生产级运维手册,覆盖部署、事件响应、数据库维护、扩缩容与监控;同时可检测已有手册是否陈旧。

主要能力:栈检测(识别 CI/CD、数据库、托管与编排,提取连接串、部署命令与基础设施细节);按类型生成模板,含编号步骤、可复制命令、每步 VERIFY 校验、时间估算、破坏性操作的回滚流程、含联系人及严重级别路由的升级路径;维护方面提供基于配置文件修改日期的陈旧检测、季度评审与预演验证框架。

使用方式:先确认手册类型、实际栈、升级联系人与严重级别路由,信息不足应追问,最多问最影响输出的 2-3 项;若用户要求直接起草,则在产物顶部列出假设。工具命令: python scripts/runbook_scaffolder.py -i service.json --type deployment -o runbook.md python scripts/runbook_validator.py --dir docs/runbooks --strict python scripts/staleness_checker.py docs/runbooks --threshold 90 --json 参考文件按需加载:runbook-templates.md、staleness-and-maintenance.md、quality-and-troubleshooting.md。

适用场景:代码库尚无手册需建立;手册过时或不完整;新工程师加入 on-call;准备事件响应演练;事后用经验更新手册。

限制:仅生成文档,不自动执行步骤或做编排;不涉及基础设施置备、Terraform/Pulumi 代码生成;不搭建可观测性栈;不覆盖安全事件响应与漏洞修复;具体收费、价格与平台细节资料未提供。