claude-howto 实战用 Claude Code DevOps Automation 插件一站式编排部署、回滚与故障响应【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howtoclaude-howto 仓库中的devops-automation插件是 Claude Code 插件体系的高阶示例它把部署、健康监控、回滚与故障响应四种运维能力打包进一个可一键安装的插件。本文以该插件在仓库中的完整实现命令、子代理、脚本、Hook、MCP 配置为骨架讲解如何在真实项目中落地「AI 驱动的 DevOps 自动化」读完后你可以直接复用这套模板搭建自己的发布与应急响应流水线。插件定位把运维流程变成 Claude Code 的能力devops-automation位于仓库 07-plugins/devops-automation/ 目录它并非一个独立的 CLI 工具而是Claude Code 的插件Plugin——按照 07-plugins/README.md 的定义插件是「将斜杠命令、子代理、MCP 服务器与 Hook 打包成可一键安装的集合」是 Claude Code 最高层的扩展机制。插件安装后运维人员可以用自然语言 斜杠命令的方式完成原本需要多套脚本、多次人工确认的发布流程。该插件在 README.md 中声明的核心特性为✅ 自动化部署Automated deployments✅ 回滚流程Rollback procedures✅ 系统健康监控System health monitoring✅ 故障响应工作流Incident response workflows✅ Kubernetes 集成Kubernetes integration这些能力由四类组件协同提供下文逐一展开。安装与前置条件环境要求插件 README 明确列出了运行前提对应 README.md 的 Requirements 一节要求说明Claude Code 2.1插件机制需要该版本以上的客户端支持Kubernetes CLIkubectl部署、回滚、状态检查均通过 kubectl 与集群交互集群访问权限需要配置好对目标集群staging / production的访问凭证一键安装/plugin install devops-automation安装完成后插件即注册其全部斜杠命令、子代理、Hook 与 MCP 配置。如果你使用的是 v2.1.157 版本的 Claude Code将插件放入.claude/skills目录即可自动加载无需 marketplace见 07-plugins/README.md。配置 Kubernetes 访问插件本身不保存集群凭证而是复用本机 kubectl 的配置。在启动 Claude Code 前设置export KUBECONFIG~/.kube/config~/.kube/config中应包含 staging 与 production 环境的 context 信息。插件脚本通过kubectl apply -f k8s/env/、kubectl rollout等命令操作对应命名空间因此 kubeconfig 中的默认 context 或命名空间划分需要提前就绪。插件组件全景一个打包的 DevOps 工具链按照 README.md 的 Whats Included 一节插件由五类组件构成仓库目录结构与之一一对应07-plugins/devops-automation/ ├── agents/ # 3 个子代理 │ ├── deployment-specialist.md │ ├── incident-commander.md │ └── alert-analyzer.md ├── commands/ # 4 个斜杠命令Skill 形式 │ ├── deploy.md │ ├── rollback.md │ ├── status.md │ └── incident.md ├── hooks/ # 2 个部署 Hook │ ├── pre-deploy.js │ └── post-deploy.js ├── mcp/ # Kubernetes MCP 配置 │ └── kubernetes-config.json ├── scripts/ # 3 个运维脚本 │ ├── deploy.sh │ ├── rollback.sh │ └── health-check.sh └── README.md斜杠命令Slash Commands命令作用/deploy部署到生产或预发环境/rollback回滚到上一个版本/status检查系统健康状态/incident处理生产故障子代理Subagents子代理职责deployment-specialist部署操作发布、回滚、健康检查、数据库迁移incident-commander故障协调严重级别评估、团队协作、状态更新、复盘alert-analyzer系统健康分析告警关联、趋势分析、根因定位、指标可视化MCP 服务器Kubernetes 集成通过 MCP 协议让 Claude 直接读取集群资源状态用于部署进度监控与状态报告。脚本deploy.sh部署自动化rollback.sh回滚自动化health-check.sh健康检查工具Hookpre-deploy.js部署前校验验证 kubectl 可用、集群连接正常post-deploy.js部署后任务等待 Pod 就绪、执行冒烟测试从架构上看/deploy、/rollback等命令充当「入口」脚本承担「执行」子代理提供「判断与编排」Hook 负责「阶段闸门」MCP 负责「实时观测」——这正是 Claude Code 插件把声明式命令与命令式脚本结合的标准范式。四大斜杠命令实战以下命令定义对应 commands/ 目录下的四个 Markdown 文件每个文件都带 YAML frontmattername/description作为命令的元数据被 Claude Code 注册。部署到预发环境/deploy staging部署到生产环境/deploy production/deploy命令见 commands/deploy.md触发完整的部署工作流运行部署前检查构建应用运行测试部署到目标环境运行健康检查通过 Slack 通知团队回滚到上一版本/rollback production/rollback命令见 commands/rollback.md执行识别上一个部署版本验证回滚目标健康执行回滚流程运行健康检查通知团队检查系统状态/status/status命令见 commands/status.md对全链路做健康巡检查询 Kubernetes Pod 状态检查数据库连接监控 API 响应时间审查错误率检查资源利用率输出整体健康报告处理生产故障/incident/incident命令见 commands/incident.md执行结构化应急流程创建故障记录评估严重级别与影响范围通知值班团队收集诊断信息协调应急响应记录解决方案安排事后复盘post-mortem源码级解析三个运维脚本是如何工作的命令负责编排真正执行部署、回滚与健康检查的是 scripts/ 下的三个 Bash 脚本。它们被子代理通过 Bash 工具调用理解其内部逻辑有助于你定制自己的流水线。deploy.sh完整的发布流水线scripts/deploy.sh 是一个典型的set -e严格模式脚本任何一步失败立即终止执行顺序为#!/bin/bash set -e # 加载环境默认 staging ENV${1:-staging} # 1. 部署前检查lint 单元测试 npm run lint npm test # 2. 构建 npm run build # 3. 应用 Kubernetes 清单 kubectl apply -f k8s/$ENV/ # 4. 健康检查等待 10 秒后探测 sleep 10 curl -f http://api.$ENV.example.com/health关键设计点ENV${1:-staging}让脚本既支持显式传参deploy.sh production也有安全默认值部署前强制linttest把质量闸门前置到流水线内kubectl apply -f k8s/$ENV/采用声明式清单不同环境用独立目录k8s/staging/、k8s/production/隔离最后用curl -f对健康端点做冒烟验证-f让 HTTP 错误码直接导致脚本非零退出。rollback.sh声明式回滚scripts/rollback.sh 利用 Kubernetes 原生的 rollout 机制而非自行维护版本快照ENV${1:-staging} # 查看历史版本诊断用 kubectl rollout history deployment/app -n $ENV # 回滚到上一个版本 kubectl rollout undo deployment/app -n $ENV # 等待回滚完成 kubectl rollout status deployment/app -n $ENV # 健康检查 sleep 5 curl -f http://api.$ENV.example.com/health这套实现的优点是幂等且安全kubectl rollout undo由集群负责恢复上一次的 ReplicaSet 配置rollout status阻塞直到 Pod 就绪失败时set -e会中断后续流程避免在回滚未完成时误报成功。health-check.sh多维健康巡检scripts/health-check.sh 从三个维度输出健康报告ENV${1:-production} # API 层curl 探测健康端点 curl -sf http://api.$ENV.example.com/health # 数据库层pg_isready 检查连接 pg_isready -h db.$ENV.example.com # 集群层统计 Running 状态 Pod 占比 kubectl get pods -n $ENV --no-headers该脚本的默认环境是production与 deploy 的默认 staging 形成对照输出格式为逐项✅ Healthy / ❌ Unhealthy的清单便于 Claude 直接读取并汇总为可读的状态报告——这也是/status命令底层的数据来源。子代理把「专家判断」注入流水线三个子代理定义在 agents/ 下均以 frontmatter 声明name、description和可用工具集子代理工具集专长领域deployment-specialistRead, Write, Bash, Grep蓝绿部署、金丝雀发布、回滚流程、健康检查、数据库迁移incident-commanderRead, Write, Bash, Grep严重级别评估、团队协调、状态更新、解决跟踪、复盘组织alert-analyzerRead, Grep, Bash告警关联、趋势分析、根因识别、指标可视化、主动问题检测值得注意的工程细节职责分离incident-commander管协调评估、跟踪、复盘alert-analyzer管分析告警关联、根因deployment-specialist管执行发布、回滚——三者组合恰好覆盖「感知 → 判断 → 处置」的运维闭环权限收敛三个子代理都只声明了只读类工具Read/Grep加 Bash没有声明文件系统之外的敏感能力符合插件子代理运行在受限沙箱中的安全模型07-plugins/README.md 明确禁止插件子代理注册hooks、mcpServers、permissionMode等特权配置。端到端工作流一次/deploy production的完整旅程插件 README 给出了一个完整的示例工作流对应 README.md 的 Example Workflow 一节结合上文源码我们可以还原每一步的底层实现User: /deploy production Claude: 1. Runs pre-deploy hook (validates kubectl, cluster connection) 2. Delegates to deployment-specialist subagent 3. Runs deploy.sh script 4. Monitors deployment progress via Kubernetes MCP 5. Runs post-deploy hook (waits for pods, smoke tests) 6. Provides deployment summary Result: ✅ Deployment complete Version: v2.1.0 Pods: 3/3 ready ⏱️ Time: 2m 34s六个步骤与插件组件的对应关系为pre-deploy hookhooks/pre-deploy.js在部署前校验 kubectl 是否安装、kubeconfig 中的集群连接是否可达——相当于流水线的「闸门」不通过则不进入发布委托子代理Claude 将任务移交给deployment-specialist由其根据环境决定部署策略蓝绿、金丝雀或直接滚动执行脚本子代理通过 Bash 调用 scripts/deploy.sh依次完成 lint、test、build、kubectl applyMCP 监控Claude 通过mcp/kubernetes-config.json配置的 Kubernetes MCP 服务器实时读取 Pod、Deployment 状态替代人工kubectl get pods轮询post-deploy hookhooks/post-deploy.js等待所有 Pod 进入 Ready 状态并执行冒烟测试对应脚本中的curl -f健康探测总结汇报Claude 汇总版本号、Pod 就绪比例与耗时输出结构化的部署摘要。这个流程的工程价值在于所有易错、重复、需要严格顺序的步骤都由脚本和 Hook 确定性执行而 Claude 与子代理只负责编排、判断与汇报既保留了自动化的可靠性又提供了自然语言交互的灵活性。从模板到落地复用与定制建议devops-automation在仓库中是一个可直接参照的完整模板。要在自己的项目中复用它可按以下路径定制替换部署目标将 scripts/deploy.sh 中kubectl apply -f k8s/$ENV/指向你自己的清单目录把api.$ENV.example.com/health换成真实健康端点调整质量闸门npm run lint/npm test可替换为你技术栈对应的检查命令如pytest、go test、pnpm typecheck接入真实集群确保~/.kube/config中 context 与脚本使用的命名空间-n $ENV一致Kubernetes MCP 配置参见 mcp/kubernetes-config.json扩展监控面在 scripts/health-check.sh 中增加缓存、消息队列等中间件的探测项/status的输出会随之自动丰富。如果你对插件机制本身manifest 结构、marketplace 分发、LSP 支持、生命周期管理等感兴趣可继续阅读 07-plugins/README.md仓库还提供了文档自动生成、PR 审查等其他领域插件见 07-plugins/可以作为多领域插件设计的对照样本。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考