用途:为运维场景创建 Runbook 文档,覆盖服务部署、常见运维任务和事件响应。ADR(架构决策记录)不在本技能范围内,应使用 tech-writing 技能配合 templates/decision-record.md 模板,该模板包含 Y-statement、Nygard ADR、MADR、RFC 四级阶梯并按决策规模选择层级;下方保留的精简 ADR 模板仅用于维持既有链接可解析。
主要能力:提供 ADR 与 Runbook 两类模板。ADR 模板字段包括编号与标题、状态(Proposed/Accepted/Deprecated/Superseded by ADR-X)、日期,以及 Context、Decision、Options Considered、Consequences 四节;存放于 docs/adr/ADR-NNN-description.md,要求保持不可变,通过取代而非编辑来更新。Runbook 模板字段包括服务名、Owner(团队)、On-Call(联系方式),以及 Prerequisites、Common Operations、Troubleshooting、Alerts & Escalation 四节;存放于 docs/runbooks/service-name.md。
使用方式:按模板结构填写内容;Runbook 中的命令需在记录前先行测试,确保可直接复制粘贴执行,并明确升级路径。ADR 需写清问题、评估过的选项与后果。
适用场景:服务部署、日常运维操作、故障排查与事件响应文档。
限制:本技能不用于 ADR、技术规格、需求、LLD 和技术分析,这些应改用 tech-writing 技能。资料未提供安装命令、收费方式或平台支持信息。