SuperAPI AI 工具集

runbook-writer

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:在 LLD 等上游设计完成后,编写生产就绪的运维手册,涵盖部署流程、回滚策略、监控告警、故障处理与值班内容;也支持在既有基线和授权范围内的有限增量更新。

主要能力:先收集 PRD、HLD、LLD、API Contract、Guardrails、基础设施等上游文档,提取系统边界、依赖、部署要求、回滚约束、SLO、故障场景等运维约束,再据此组织写作。具备独立委派能力且获授权时作为协调者,派发 writer、spec reviewer、quality reviewer 子任务;否则以草稿作者与自检者身份工作。

使用方式:分为基线收集、上下文准备、派发写作、规格符合性审查、质量审查、输出与验证等阶段。规格审查检查覆盖度与是否存在过度设计;质量审查检查每步是否有验证命令、回滚是否可操作、监控是否完整。必填约束必须来自上游文档,缺失时通过提问确认,禁止臆测。默认输出到 docs/runbook/[system-name]-runbook.md,若 Guardrails 指定路径则以其为准。

限制:无独立委派能力时,自检不能替代必要独立评审,交付须标注草稿、未独立评审、未批准。上游信息缺失或冲突时不得擅自定案,应询问责任方或用户;未获批准的草稿不得标示为生产就绪。具体模板、命令与子代理提示词文件在资料中未展开,暂未提供。