# oc-expert-skills

**Repository Path**: OpenCloudOS/oc-expert-skills

## Basic Information

- **Project Name**: oc-expert-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 2
- **Created**: 2026-04-16
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCloudOS Expert Skills

OpenCloudOS 全栈运维诊断技能，帮助运维人员快速定位和解决系统问题。

## 📋 能力列表（References）

原 24 个独立 Skills 已归一为单一 Skill，各能力以 `references/` 文档形式按需加载。

### 磁盘与存储（5 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| disk-space | [disk-space.md](references/disk-space.md) | 磁盘空间分析 |
| disk-partition | [disk-partition.md](references/disk-partition.md) | 磁盘分区管理 |
| disk-filesystem | [disk-filesystem.md](references/disk-filesystem.md) | 文件系统管理 |
| disk-lvm | [disk-lvm.md](references/disk-lvm.md) | LVM 逻辑卷管理 |
| disk-health | [disk-health.md](references/disk-health.md) | 磁盘健康检测 |

### 网络诊断（2 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| network-check | [network-check.md](references/network-check.md) | 网络连通性诊断 |
| network-latency | [network-latency.md](references/network-latency.md) | 丢包与延迟排查 |

### 性能分析（7 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| cpu-flamegraph | [cpu-flamegraph.md](references/cpu-flamegraph.md) | CPU 火焰图分析 |
| syscall-hotspot | [syscall-hotspot.md](references/syscall-hotspot.md) | 系统调用热点 |
| sched-latency | [sched-latency.md](references/sched-latency.md) | 调度延迟分析 |
| irq-balance | [irq-balance.md](references/irq-balance.md) | 中断均衡分析 |
| fs-latency | [fs-latency.md](references/fs-latency.md) | 文件系统 I/O 延迟 |
| file-io-trace | [file-io-trace.md](references/file-io-trace.md) | 进程 I/O 追踪 |
| memory-leak | [memory-leak.md](references/memory-leak.md) | 内存泄漏诊断 |

### 内存诊断（1 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| oom-killer | [oom-killer.md](references/oom-killer.md) | OOM 事件分析 |

### 系统管理（5 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| system-log | [system-log.md](references/system-log.md) | 系统日志分析 |
| service-status | [service-status.md](references/service-status.md) | 服务状态管理 |
| time-sync | [time-sync.md](references/time-sync.md) | 时间同步管理 |
| package-version | [package-version.md](references/package-version.md) | 软件包版本查询 |
| repo-source | [repo-source.md](references/repo-source.md) | 软件源配置 |

### 安全合规（2 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| security-baseline | [security-baseline.md](references/security-baseline.md) | 等保安全基线检查 |
| oc-cve-query | [oc-cve-query.md](references/oc-cve-query.md) | CVE 漏洞查询 |

### 故障恢复（1 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| kdump-check | [kdump-check.md](references/kdump-check.md) | kdump 配置与排查 |

### 文档查询（1 项）

| 能力 | 文档 | 说明 |
|------|------|------|
| oc-docs | [oc-docs.md](references/oc-docs.md) | OpenCloudOS 文档查询 |

## 🏗️ 项目结构

```
oc-expert-skills/
├── README.md                    # 项目说明
├── CONTRIBUTING.md              # 贡献指南
├── LICENSE                      # GPL-2.0-only 许可证
├── SKILL.md                     # 主 Skill 文件（能力索引 + 路由逻辑）
├── references/                  # 详细诊断文档（48 个，按需加载）
│   ├── disk-space.md
│   ├── cpu-flamegraph.md
│   ├── network-check.md
│   └── ...
├── scripts/                     # 诊断脚本（15 个）
│   ├── collect_and_analyze.sh
│   ├── cve_xml_server.py
│   ├── opencloudos_api_server.py
│   └── ...
├── tests/                       # 测试用例
│   └── test.sh
└── docs/                        # 开发文档
    ├── developer-handbook.md
    ├── skill-development-guide.md
    ├── best-practices.md
    └── architecture.md
```

### 渐进式加载设计

```
Layer 0: 安全规则 + 版本差异表（始终加载）
         ↓
Layer 1: 能力索引 + 关键词匹配（~200 行，始终加载）
         ↓
Layer 2: references/ 详细文档（按需加载）
```

## 🔧 使用方式

### 方式一：克隆项目直接使用（推荐）

```bash
# 1. 克隆项目
git clone https://gitee.com/OpenCloudOS/oc-expert-skills.git
cd oc-expert-skills

# 2. 用 CodeBuddy 打开项目目录
# SKILL.md 会自动被识别和加载
```

### 方式二：安装为用户级 Skill（全局可用）

```bash
# 用户级 skills 目录
mkdir -p ~/.codebuddy/skills/oc-expert

# 复制主文件
cp SKILL.md ~/.codebuddy/skills/oc-expert/

# 复制引用文档和脚本
cp -r references/ ~/.codebuddy/skills/oc-expert/
cp -r scripts/ ~/.codebuddy/skills/oc-expert/
```

### 验证安装

在 CodeBuddy 中验证：

1. 打开 CodeBuddy 的 **Craft 模式**
2. 描述问题，如 *"帮我查看磁盘空间使用情况"*
3. CodeBuddy 会自动匹配并加载对应能力进行诊断

## 🚀 开发指南

### 添加新能力

1. 在 `references/` 目录创建新的文档文件（如 `references/<capability-name>.md`）
2. 在 `SKILL.md` 的能力索引表和文档路径映射中添加新条目
3. 如需脚本支持，在 `scripts/` 目录添加脚本
4. 运行测试：`bash tests/test.sh`

### 文档规范

- [开发者手册](docs/developer-handbook.md) - **推荐首先阅读**
- [Skill 开发指南](docs/skill-development-guide.md)
- [最佳实践](docs/best-practices.md)
- [架构设计](docs/architecture.md)

## 📚 参考资料

### OpenCloudOS 官方文档

- [OpenCloudOS 产品文档](https://docs.opencloudos.org/release/oc_intro/)

### OpenCloudOS 版本说明

| 版本 | 包管理器 | 说明 |
|-----|---------|------|
| OpenCloudOS 7 | yum | 长期支持版本 |
| OpenCloudOS 8 | dnf | 长期支持版本 |
| OpenCloudOS 9 | dnf | 独立版本 |

## 🔄 CI/CD

本项目使用 [Gitee Go](https://gitee.com/help/articles/4295) 进行持续集成：

- 提交 PR 时自动运行格式验证
- 自动运行测试用例
- 配置文件：`.gitee/pipelines/skill-validation.yml`

## 🤝 贡献

欢迎贡献！请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献流程。

### 贡献步骤

1. Fork 本仓库
2. 创建功能分支：`git checkout -b feature/add-new-capability`
3. 开发并测试
4. 提交变更：`git commit -m 'feat: 添加 xxx 诊断能力'`
5. 推送分支：`git push origin feature/add-new-capability`
6. 创建 Pull Request

## 📄 许可证

本项目采用 [GPL-2.0-only 许可证](LICENSE)。