Agent skill

ops-safety

当用户执行系统级命令(sysctl、iptables、systemctl、Docker 配置、数据库 DDL)或进行服务器运维操作时触发。提供运维安全规范。

Stars 424
Forks 44

Install this agent skill to your Project

npx add-skill https://github.com/doccker/cc-use-exp/tree/main/.claude/skills/ops-safety

SKILL.md

运维安全规则

防止因不完整的操作导致系统故障。


1. 系统级命令规则

在给出任何系统级命令(sysctl、firewalld、iptables、内核参数、systemctl 等)之前,必须先说明:

项目 说明
影响范围 这个命令会影响什么(网络、Docker、服务等)
风险等级 高/中/低
回滚方案 完整的回滚步骤,包括所有依赖服务的重启
需要重启的服务 明确列出

命令说明模板

## 命令说明

**命令**: sudo sysctl -p /etc/sysctl.d/99-xxx.conf

**影响范围**:
- 内核网络参数
- 可能影响 Docker 容器网络
- 可能影响 Cloudflare 连接

**风险等级**: 高

**回滚方案**:
1. sudo rm -f /etc/sysctl.d/99-xxx.conf
2. sudo sysctl --system
3. sudo systemctl restart docker
4. docker-compose up -d
5. curl -I http://127.0.0.1:80  # 验证

**是否确认执行?**

2. 回滚方案要求

回滚方案必须包含以下步骤,缺一不可:

步骤 说明 示例
1. 恢复配置 删除或还原配置文件 rm -f /etc/sysctl.d/99-xxx.conf
2. 重载配置 重新加载系统配置 sysctl --system
3. 重启服务 重启所有受影响的服务 systemctl restart docker
4. 恢复应用 重启依赖的应用 docker-compose up -d
5. 验证恢复 确认服务正常 curl -I http://127.0.0.1:80

3. 问题排查原则

不扩散问题

如果 A 配置导致问题:

  • ✅ 先彻底恢复 A
  • ❌ 不要去改 B、C、D

最小改动原则

  • 只修改必要的配置
  • 一次只改一个变量
  • 改完验证后再进行下一步

不动正常配置

  • 用户明确说某配置正常,不要建议修改
  • 不要"顺手"优化其他配置

4. 特定场景规则

Cloudflare + 服务器

当用户使用 Cloudflare 代理时:

禁止操作 原因
随意修改内核网络参数 可能导致 Cloudflare 连接异常
随意修改 DNS 记录 影响 CDN 解析
随意修改 SSL/TLS 设置 可能导致证书验证失败

Docker 相关

修改以下配置后,必须提示重启 Docker:

  • 内核网络参数(sysctl)
  • iptables / firewalld 规则
  • Docker daemon 配置

数据库操作

执行以下操作前必须提示备份:

  • 表结构修改(ALTER TABLE)
  • 批量数据更新(UPDATE/DELETE 无 WHERE 或影响大量数据)
  • 数据库迁移

5. 禁止行为

禁止 说明
❌ 问题未解决时改其他配置 不要扩散问题
❌ 不完整的回滚方案 必须包含服务重启步骤
❌ 无风险说明的系统命令 必须先说明再执行
❌ 未经确认执行高风险命令 必须等用户确认
❌ 同时修改多个配置 一次一个,验证后再下一个

6. 风险等级定义

等级 定义 示例
可能导致服务中断、数据丢失 内核参数、防火墙、数据库DDL
可能影响部分功能 应用配置、环境变量
影响范围小,易回滚 日志级别、非核心配置

Expand your agent's capabilities with these related and highly-rated skills.

doccker/cc-use-exp

ops-safety

运维安全规范。当用户执行系统级命令(sysctl、iptables、systemctl、Docker 配置、数据库 DDL) 或进行服务器运维操作时触发。 包含命令风险说明模板、回滚方案要求、问题排查原则、Docker/Cloudflare/数据库场景规则等。

424 44
Explore
doccker/cc-use-exp

ruanzhu

当用户执行 /ruanzhu 命令或请求生成软著源代码文档时触发。提供软著源代码 DOCX 生成规范。 覆盖项目信息检测、语言扫描规则、页数控制、DOCX 格式规范等。

424 44
Explore
doccker/cc-use-exp

ui-ux-pro-max

专业级 UI/UX 设计规范,需要高质量界面设计时手动触发或描述"设计感/专业UI"时自动触发。 覆盖视觉层次、配色体系、排版节奏、交互微动效、响应式适配等。 日常前端开发由 frontend-dev skill 覆盖。

424 44
Explore
doccker/cc-use-exp

bash-style

Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件, 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。

424 44
Explore
doccker/cc-use-exp

redis-safety

Redis 安全与性能规范。当用户操作 Redis 相关代码(go-redis、Jedis、redis-py、ioredis)时触发。 包含禁止 KEYS 命令、SCAN 替代、大 key 控制、Pipeline 批量、TTL 规范等。

424 44
Explore
doccker/cc-use-exp

python-dev

Python 开发规范。当用户操作 .py、pyproject.toml、requirements.txt、setup.py 文件, 或涉及 FastAPI、Django、Flask、pytest、asyncio 开发时触发。 包含 PEP 8 风格、类型注解、异常处理、测试规范、异步编程、性能优化等。

424 44
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results