bouob/sysadmin-skills
GitHub: bouob/sysadmin-skills
基于 ITIL v5 和 SRE 实践的 Claude Code 运维技能插件,提供事件响应、变更管理、问题分析和无责复盘等结构化工作流。
Stars: 0 | Forks: 0
# sysadmin-skills
[繁體中文](README.zh-TW.md)
符合 ITIL v5 标准的 IT 运维技能,面向系统管理员 —— 涵盖事件响应、带 CAB 审查的变更管理、AI 治理、SRE 风格的复盘以及问题管理。
## 技能
### 工作流技能(用户可调用)
| 技能 | 描述 |
|---|---|
| `/incident` | 完整的事件响应生命周期:检测、分类、调查、解决、沟通、关闭。支持 SRE 错误预算上下文和 AIOps 检测到的事件。 |
| `/change-request` | ITIL 变更请求 (RFC),包含风险评估、回滚计划、CAB 审查清单、AI/ML 变更指南以及 GitOps 模式。 |
| `/statuspage` | 针对事件和维护的状态页更新(兼容 Atlassian Statuspage / Instatus)。 |
| `/problem` | 问题管理:根本原因分析(5 Whys / 鱼骨图 / 帕累托图)、已知错误数据库登记以及永久修复跟踪。 |
| `/postmortem` | 遵循 Google SRE 文化的无责任事后复盘。重点关注系统性促成因素、表现良好的方面以及 SMART 行动项。 |
| `/ai-change` | 包含 ITIL v5 AI 治理(6C 模型)、偏差/公平性评估、可解释性要求以及 AI 特定回滚的 AI/ML 系统变更请求。 |
### 方法论技能(自动加载)
| 技能 | 描述 |
|---|---|
| `itil` | ITIL (版本 5) 框架参考:优先级矩阵、事件管理、变更使能、AI 治理(6C 模型)和 SRE 集成。 |
| `comms` | 利益相关者沟通模板,提供基于严重程度的语气指南。 |
| `done-ops` | 运维验证门 —— 用证据说话。包括 SLO 合规性检查。 |
## 安装
```
# 来自 marketplace
/plugin marketplace add bouob/sysadmin-skills
# Local development
claude --plugin-dir ./sysadmin-skills
```
## 使用方法
```
/incident Email service is not sending outbound messages since 09:15
/change-request Upgrade Exchange Server 2019 to 2022
/statuspage VPN service experiencing intermittent connectivity issues
/problem VPN drops every Monday morning — 4th occurrence this month
/postmortem Payment service P1 outage resolved — blameless review needed
/ai-change Upgrade customer service chatbot from Claude 3.5 to Claude Sonnet 4.6
```
方法论技能(`itil`、`comms`、`done-ops`)由工作流技能自动加载 —— 无需直接调用。
## 输出
所有技能都会生成本地 Markdown 文件:
| 技能 | 输出目录 | 文件名模式 |
|---|---|---|
| `/incident` | `./incidents/` | `incident-YYYY-MM-DD-slug.md` |
| `/change-request` | `./changes/` | `change-request-YYYY-MM-DD-slug.md` |
| `/statuspage` | `./statuspage/` | `statuspage-YYYY-MM-DD-slug.md` |
| `/problem` | `./problems/` | `problem-YYYY-MM-DD-slug.md` |
| `/postmortem` | `./postmortems/` | `postmortem-YYYY-MM-DD-slug.md` |
| `/ai-change` | `./changes/ai/` | `ai-change-YYYY-MM-DD-slug.md` |
如果项目中存在 `docs/{type}/` 目录,技能将优先使用该目录。
## 架构
三层架构:
- **工作流技能** —— 用户可调用的分步流程
- **方法论技能** —— 自动加载的领域知识(ITIL v5、SRE、沟通模式)
- **参考文件** —— 按需加载的深度内容(每个技能的 `references/`)
参考文件遵循渐进式披露原则:SKILL.md 保持精简,详细内容存放在 `references/` 中,仅在需要时加载。
### 共享参考文件(在 `itil/references/` 中)
| 文件 | 共享者 |
|---|---|
| `itil-v5-overview.md` | 所有技能 —— ITIL v5 更改、术语 |
| `ai-governance-6c.md` | `/change-request`、`/ai-change`、`/incident` |
| `sre-integration.md` | `/incident`、`/postmortem`、`/change-request` |
| `sustainability.md` | `/change-request`、`/ai-change` |
| `incident-management.md` | `/incident` —— 完整流程、AIOps、SLO 集成 |
| `change-enablement.md` | `/change-request` —— 完整流程、AI/ML、GitOps 模式 |
| `priority-matrix.md` | `/incident` —— P1-P4 和 SEV1-SEV4 及示例 |
## ITIL v5 对齐
此插件与 2026 年 2 月发布的 **ITIL (版本 5)** 保持一致:
- 保留了所有 34 项 ITIL 4 实践 —— 现有工作流 100% 兼容
- AI 治理(6C 模型)已集成到变更和事件管理中
- SRE 实践(错误预算、无责任复盘)与 ITIL 流程实现了桥接
- 在变更风险评估中增加了可持续性维度
ITIL 4 用户:无需更改工作流。新功能是增量添加的。
## 许可证
MIT
标签:AIOps, AI治理, CAB审查, Claude插件, GitOps, ITIL, ITIL 4, ITIL v5, IT服务管理, IT运维, Socks5代理, SRE, 事后总结, 偏差过滤, 变更管理, 沟通模板, 状态页沟通, 系统管理员, 问题管理, 防御加固, 风险控制