技能 linux-troubleshooting
🖥️

linux-troubleshooting

安全 ⚙️ 外部命令

Diagnosticar e Resolver Problemas do Sistema Linux

Administradores Linux enfrentam falhas complexas do sistema que requerem diagnóstico estruturado. Este fluxo de trabalho fornece uma abordagem de sete fases para identificar sistematicamente as causas raiz e implementar correções verificadas.

支持: Claude Codex Code(CC)
🥉 73 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“linux-troubleshooting”。 Servidor está rodando lentamente. Comece a solução de problemas.

预期结果:

  • Fase 1 - Avaliação Inicial Completa:
  • - Tempo de atividade do sistema: 45 dias
  • - SO: Ubuntu 22.04 LTS
  • - Atualização recente de kernel detectada em dmesg
  • Fase 2 - Análise de Recursos:
  • - CPU: 95% de uso pelo processo java (PID 4521)
  • - Memória: 7,8GB/8GB usados, alta atividade de swap
  • - Disco: /var em 92% da capacidade
  • Ação recomendada: Investigar vazamento de memória do processo Java e liberar espaço em disco em /var/log

正在使用“linux-troubleshooting”。 Serviço nginx falhou ao iniciar após mudança de configuração

预期结果:

  • Resultados da Fase 6 - Solução de Problemas de Serviços:
  • - systemctl status nginx: Falhou com código de saída 1
  • - journalctl -u nginx: 'nginx: [emerg] diretiva desconhecida' na linha 47
  • - Teste de configuração: nginx -t mostra erro de sintaxe em /etc/nginx/sites-enabled/default
  • Causa raiz: Diretiva inválida introduzida em edição recente de configuração
  • Correção: Restaurar configuração anterior do backup e recarregar nginx

安全审计

安全
v1 • 2/25/2026

All 47 static analysis findings are false positives. The SKILL.md file is documentation-only (markdown) containing workflow instructions and example commands. The detected 'backtick execution' patterns are markdown code fence markers (```bash), not Ruby/shell backticks. The 'hardcoded URL' and 'reconnaissance' patterns are documented examples for users, not executable code. No actual security risks detected.

1
已扫描文件
222
分析行数
2
发现项
1
审计总数
低风险问题 (1)
Documentation Contains Shell Command Examples
The skill documentation includes example shell commands for system diagnostics (uptime, top, df, journalctl, etc.). These are intended for user execution via other skills, not direct code execution by this skill.
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
83
规范符合性

你能构建什么

Resposta a Interrupção de Servidor de Produção

Siga o fluxo de trabalho de sete fases para diagnosticar por que um servidor de produção ficou sem resposta, identificar a causa raiz (esgotamento de recursos, falha de serviço ou problema de rede) e implementar uma correção verificada.

Investigação de Degradação de Desempenho

Use fases de análise de recursos e investigação de processos para identificar quais processos estão consumindo CPU ou memória excessiva, depois trabalhe com a skill server-management para resolver o problema.

Diagnóstico de Falha de Serviço

Aplique a fase de solução de problemas de serviços para diagnosticar por que serviços systemd falham ao iniciar, revise logs com a skill error-detective e implemente correções de configuração.

试试这些提示

Verificação Básica de Saúde do Sistema
Use o fluxo de trabalho linux-troubleshooting para verificar a saúde do sistema. Comece com a Fase 1 (Avaliação Inicial) e Fase 2 (Análise de Recursos). Execute uptime, verifique o uso de CPU e memória com top e free, e reporte o espaço em disco com df -h.
Serviço Não Inicia
Um serviço crítico está falhando ao iniciar. Siga a Fase 6 (Solução de Problemas de Serviços) para verificar systemctl status, revisar logs com journalctl -u service -f e identificar problemas de configuração. Depois use a Fase 4 (Análise de Logs) para procurar erros relacionados em /var/log/.
Problemas de Conectividade de Rede
Usuários não conseguem acessar nosso servidor web. Execute a Fase 5 (Diagnósticos de Rede) para verificar interfaces de rede com ip addr, verificar portas em escuta com ss -tulpn, testar conectividade com curl e verificar resolução DNS com dig. Correlacione descobertas com regras de firewall.
Resposta Completa a Incidentes
Servidor de produção está enfrentando problemas críticos. Execute o fluxo de trabalho completo linux-troubleshooting de sete fases: (1) Avaliação Inicial, (2) Análise de Recursos, (3) Investigação de Processos, (4) Análise de Logs, (5) Diagnósticos de Rede, (6) Solução de Problemas de Serviços, (7) Resolução. Documente descobertas em cada fase e implemente correções verificadas.

最佳实践

  • Sempre documente descobertas em cada fase antes de prosseguir para a próxima
  • Verifique correções executando novamente comandos de diagnóstico para confirmar a resolução
  • Crie planos de prevenção após a resolução para evitar problemas recorrentes

避免

  • Pular fases e ir direto para reinícios sem diagnosticar a causa raiz
  • Implementar correções sem primeiro verificar a causa raiz identificada
  • Falhar em monitorar a estabilidade do sistema após aplicar a resolução

常见问题

Quais skills preciso usar este fluxo de trabalho?
Este fluxo de trabalho coordena com bash-linux para execução de comandos, performance-engineer para análise de recursos, server-management para gerenciamento de processos e serviços, error-detective para análise de logs e network-engineer para diagnósticos de rede. Cada fase especifica quais skills invocar.
Este fluxo de trabalho pode corrigir problemas automaticamente?
Não, este é um guia de fluxo de trabalho estruturado. Ele fornece etapas sistemáticas de diagnóstico e coordena com outras skills para executar comandos. Todas as correções requerem aprovação do usuário antes da implementação.
E se eu precisar apenas verificar uma área específica?
Você pode executar fases individuais independentemente. Por exemplo, execute apenas a Fase 5 para problemas de rede ou Fase 4 para análise de logs. O fluxo de trabalho é modular e cada fase é independente.
Como documento o processo de solução de problemas?
A Fase 1 inclui coletar descobertas iniciais e a Fase 7 inclui criar documentação de resolução. Cada fase tem uma etapa 'Documentar descobertas'. O fluxo de trabalho incentiva manter um registro de solução de problemas durante todo o processo.
Quais permissões preciso para executar esses diagnósticos?
A maioria dos comandos de diagnóstico (top, df, ss) funciona com permissões de usuário padrão. Alguns comandos como journalctl -xe, strace e gerenciamento de serviços requerem acesso sudo/root. Certifique-se de que sua sessão Claude Code tenha permissões apropriadas do sistema.
Posso usar este fluxo de trabalho para ambientes em contêineres?
Sim, mas alguns comandos podem se comportar de forma diferente dentro de contêineres. Comandos como systemctl podem não funcionar em contêineres sem systemd. Adapte o fluxo de trabalho usando alternativas específicas de contêiner (docker top, docker logs) quando aplicável.

开发者详情

文件结构

📄 SKILL.md