runbook – 运维手册与故障处理 Skill

Skill 详细介绍

runbook 是 Anthropic 官方 knowledge-work-plugins 仓库中的一个 Skill，主要用于帮助用户编写、整理和执行运维操作手册（runbook）。由于当前环境无法访问该仓库的原始文件，以下内容基于该 Skill 的名称、所属仓库定位以及 Anthropic 官方 Skill 体系的一般特征进行说明。具体功能细节请以该 Skill 当前官方说明为准。

它是什么

Runbook 通常指一套标准化的操作流程文档，描述在特定场景下（如故障排查、系统部署、日常运维、应急响应）应该按什么步骤执行哪些操作。这个 Skill 的核心用途是让 AI Agent 能够协助用户：

• 编写结构化的操作手册和流程文档
• 将零散的操作步骤整理成可复用的 runbook
• 按照已有 runbook 指导用户逐步执行操作
• 对现有 runbook 进行检查、补充和优化

它不是什么

• 不是一个独立运行的软件或 CLI 工具
• 不是自动化运维平台（如 Ansible、Terraform）
• 不是监控或告警系统
• 不是替代人工决策的自动化执行引擎

所属仓库背景

该 Skill 属于 Anthropic 官方的 knowledge-work-plugins 仓库，这一仓库的定位是提供面向知识工作场景的 Skill 集合。与 anthropics/skills 仓库中偏开发工具类的 Skill 不同，knowledge-work-plugins 更侧重于文档、流程、知识管理等办公与协作场景。

核心能力（基于 Skill 类型推断）

• 根据用户描述的场景，生成结构化的 runbook 文档
• 按照既定格式输出操作步骤、前置条件、验证方法、回滚方案
• 帮助用户审查现有 runbook 的完整性和可执行性
• 在对话中引导用户按 runbook 步骤操作

适合的用户

• SRE / 运维工程师，需要编写和维护操作手册
• 开发团队，需要标准化部署、发布、回滚流程
• 技术支持团队，需要整理故障处理步骤
• 任何需要将操作流程文档化的知识工作者

不适合的需求

• 需要真正自动执行运维命令的场景（应使用专门的自动化工具）
• 需要实时监控和告警的场景
• 需要复杂工作流编排的场景

Skill 安全评估

总体判断

该 Skill 来自 Anthropic 官方仓库，来源可信度较高。从 Skill 类型来看，runbook 类 Skill 主要以生成和整理文档为主，本身不涉及高风险操作。但具体安全表现取决于 Skill 的实际实现方式，建议在使用前查看官方 SKILL.md 确认其权限需求。

来源可信度

• 所属组织：Anthropic（官方）
• 仓库：knowledge-work-plugins
• 官方仓库的 Skill 通常经过基本审查，但具体到每个 Skill 的行为仍需以实际代码和说明为准

可能涉及的权限

根据 runbook 类 Skill 的一般特征，可能涉及：

• 文件读取：读取用户提供的现有 runbook、文档或配置，属于正常用途
• 文件写入：生成或更新 runbook 文档，属于正常用途
• Shell 权限：如果 Skill 包含按 runbook 执行命令的功能，则可能调用 Shell。这一权限需要特别关注，因为 runbook 内容可能包含破坏性命令（如删除、重启服务）
• 网络访问：一般 runbook 类 Skill 不需要联网，除非需要查询外部文档

主要风险点

1. 误执行风险：如果 Skill 能够直接执行 runbook 中的命令，且用户未仔细审查，可能执行错误的运维操作。建议在执行前人工确认每一步。
2. Prompt Injection：如果 Skill 读取的外部文档中嵌入了恶意指令，可能诱导 Agent 执行非预期操作。建议只对自己信任的文档使用。
3. 敏感信息泄露：runbook 中可能包含服务器地址、账号、内部流程等敏感信息，使用云端模型时需注意数据流向。

降低风险的建议

• 如果只需要 Skill 帮助生成或整理文档，可以关闭 Agent 的自动执行 Shell 权限，由用户手动执行命令
• 不要让 Skill 直接操作生产环境，先在测试环境验证流程
• 对 runbook 中的破坏性命令（drop、delete、rm、restart 等）保持警惕
• 避免将包含真实凭证的文档直接传给 Skill

没有任何 Skill 可以保证 100% 安全。最终判断应基于你对该 Skill 官方说明的阅读以及对自身使用场景的评估。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Anthropic 官方 knowledge-work-plugins 仓库，与 Claude Code 的适配度最高，建议优先在 Claude Code 中使用。官方没有公布完整的第三方 Agent 兼容列表。

从 Agent Skill 的通用工作方式来看，在支持 Skills 机制或类似自定义指令加载机制的环境中，通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。不同 Agent 的 Skill 加载方式、目录结构和兼容程度可能不同，具体以对应 Agent 当前版本的说明为准。

二、运行环境 / 依赖

由于当前无法确认该 Skill 的具体实现，以下为一般性说明：

具体版本要求请以该 Skill 当前官方说明为准。

三、权限

• 文件读取：建议开启，用于读取现有文档和 runbook
• 文件写入：建议开启，用于生成和更新 runbook 文档
• Shell 执行：可选。如果只用于文档生成，建议关闭；如果 Skill 需要验证命令，再按需开启
• 网络访问：可选，取决于是否需要查询外部资料

四、账号 / API Key

Skill 本身通常不需要额外的账号或 API Key。你使用的 AI Agent（如 Claude Code）本身的账号和认证是前提条件。如果 Skill 后续生成的 runbook 涉及特定平台（如云服务、监控系统），执行这些操作时可能需要相应平台的凭证，但这属于 runbook 内容层面，与 Skill 本身无关。

最小使用条件

1. 一个支持 Skill 机制的 AI Agent（首选 Claude Code）
2. 能够加载 anthropics/knowledge-work-plugins#runbook 的 Skill 管理环境
3. 如涉及文档读写，需要开启相应的文件权限

Skill 安装、使用与卸载教程

一、安装

你可以直接复制本页面提供的 Skill 安装指令，粘贴到对应的 Agent 或终端中执行。

如果你不确定自己的 Agent 如何安装 Skill，可以直接询问当前 Agent：

如何安装 anthropics/knowledge-work-plugins#runbook？

如何在 Claude Code 中安装 anthropics/knowledge-work-plugins#runbook？

如何在 Cursor 中安装 anthropics/knowledge-work-plugins#runbook？

让 Agent 根据自己的 Skill 加载与管理机制，给出针对当前环境的安装步骤。不同 Agent 的 Skill 目录位置和安装方式不同，由 Agent 自行判断通常比套用通用命令更可靠。

由于该 Skill 所属仓库为 Anthropic 官方知识工作类插件集合，安装时通常需要确认仓库来源为 anthropics/knowledge-work-plugins，避免从第三方镜像或 Fork 安装。

二、安装后如何使用

安装完成后，该 Skill 通常会在 Agent 处理相关任务时自动触发，或通过用户的显式指令调用。适合交给它的典型任务包括编写操作手册、整理故障处理流程、审查现有 runbook 等。

向 Agent 描述需求时，建议直接说明场景、目标和约束。以下为自然语言使用示例：

使用 runbook，帮我为数据库主从切换写一份运维操作手册，包含前置检查、切换步骤、验证方法和回滚方案。

使用 runbook，把我们团队零散的部署步骤整理成标准化的操作流程文档。

使用 runbook，检查这份现有的故障处理文档，看看有没有遗漏的关键步骤或风险点。

如果 Agent 支持自动加载 Skill，你也可以直接描述任务，让 Agent 自行决定是否调用该 Skill。

三、卸载

卸载方式取决于你使用的 Agent 和 Skill 管理器：

• 通过对应 Agent 或 Skill 管理器提供的删除 / 移除功能操作
• 直接删除对应的 Skill 目录或文件
• 如果不确定如何卸载，直接询问当前 Agent：“如何卸载 anthropics/knowledge-work-plugins#runbook？”

不同 Agent 的 Skill 安装位置和管理方式可能不同，如果没有统一的卸载命令，询问当前 Agent 通常是更稳妥的方式。

常见问题

1. 安装后 Agent 没有识别这个 Skill，怎么排查？

先确认 Skill 文件是否放在了当前 Agent 规定的 Skill 目录下；再确认 Agent 是否需要重启或重新加载 Skill 列表；最后确认 Skill 的元数据（名称、描述、触发条件）是否完整。如果仍然不识别，直接问当前 Agent 该 Skill 未被加载的可能原因。

2. 可以同时安装到多个 Agent 中使用吗？

通常可以。Skill 本质上是指令 + 资源的组合，只要目标 Agent 支持相同的 Skill 机制，就可以分别安装。但不同 Agent 的加载方式、权限模型可能不同，行为也可能有差异。建议在多个 Agent 中分别验证其表现。

3. Skill 更新后是否需要重新安装？

取决于你是如何安装的。如果是从仓库直接拉取或以链接方式引用，更新仓库后通常重新加载即可；如果是复制文件到本地，则需要重新同步。具体以对应 Agent 的 Skill 更新机制为准。

4. 中国大陆使用是否有网络要求？

该 Skill 来自 Anthropic 官方仓库，安装过程中如果需要访问 GitHub 拉取内容，可能受网络环境影响。Skill 本身在本地使用阶段通常不需要额外联网，但前提是你所使用的 Agent 能够正常工作。

5. 这个 Skill 会不会自动修改我的项目文件？

这取决于 Skill 的实现和当前 Agent 的权限设置。如果 Skill 只用于生成文档，通常只会写入你指定的输出文件。建议在使用前确认 Agent 的文件写入权限范围，避免在重要目录中直接运行。

6. 可以关闭 Shell 权限只用来生成文档吗？

通常可以。如果你只使用该 Skill 编写或整理 runbook 文档，不涉及命令执行，关闭 Shell 权限不会影响主要功能。这样可以降低误执行 runbook 中命令的风险。

7. 它和通用文档生成能力有什么区别？

通用 Agent 本身也能写流程文档，但这个 Skill 提供了针对 runbook 场景的专门结构和方法论（如标准化的前置条件、步骤、验证、回滚结构），输出的一致性通常更好。如果你经常需要写运维流程文档，使用专门的 Skill 可以减少每次重新描述格式的成本。