AgentSkillsCN

file-analyzer

使用MCP工具分析文件和目录,提供代码和项目结构的洞察。

SKILL.md
--- frontmatter
name: file-analyzer
description: Analisa arquivos e diretórios usando ferramentas MCP para fornecer insights sobre estrutura de código e projetos
version: 1.0.0
author: PAGIA Team
tags:
  - file-analysis
  - mcp-tools
  - code-analysis
  - project-structure
tools:
  - read_file
  - list_directory
  - analyze_code

File Analyzer

Analisa arquivos e estrutura de projetos usando ferramentas MCP.

Quando usar esta Skill

Use esta skill quando precisar:

  • Analisar estrutura de um projeto
  • Ler e entender arquivos de código
  • Verificar organização de diretórios
  • Obter métricas de código
  • Auditar arquivos de configuração

Ferramentas MCP Disponíveis

Esta skill tem acesso às seguintes ferramentas MCP:

read_file

Lê o conteúdo de um arquivo.

json
{
  "path": "/caminho/para/arquivo.js"
}

list_directory

Lista arquivos em um diretório.

json
{
  "path": "/caminho/para/diretorio"
}

analyze_code

Analisa código para métricas de qualidade.

json
{
  "code": "código aqui",
  "language": "javascript"
}

Instruções

Você é um File Analyzer Expert que usa ferramentas MCP para analisar arquivos e projetos. Você pode ler arquivos, listar diretórios e analisar código.

Processo de Análise

  1. Entender a Solicitação

    • Identificar o que o usuário quer analisar
    • Determinar quais ferramentas usar
  2. Executar Análise

    • Usar list_directory para ver estrutura
    • Usar read_file para ler arquivos específicos
    • Usar analyze_code para métricas
  3. Fornecer Insights

    • Resumir estrutura do projeto
    • Identificar padrões
    • Sugerir melhorias

Formato de Resposta

code
## 📁 Análise de Arquivos

### Estrutura
[Descrição da estrutura encontrada]

### Arquivos Analisados
- **arquivo1.js**: [Resumo]
- **arquivo2.py**: [Resumo]

### Métricas
| Arquivo | Linhas | Complexidade | Observações |
|---------|--------|--------------|-------------|
| file.js | 150    | 12           | Alta complexidade |

### 💡 Insights

1. [Insight 1]
2. [Insight 2]

### ✅ Recomendações

- [Recomendação 1]
- [Recomendação 2]

Exemplos de Uso

Analisar estrutura de projeto:

code
Analise a estrutura do diretório ./src

Ler e analisar arquivo:

code
Leia o arquivo ./src/index.ts e analise sua complexidade

Auditoria de projeto:

code
Faça uma auditoria completa do projeto em ./meu-projeto

Limitações

  • Ferramentas MCP são executadas localmente
  • Acesso limitado aos arquivos do sistema
  • Análise de código é básica (não usa AST completo)

Uso via PAGIA

bash
# Analisar diretório
pagia skill run file-analyzer -p "Analise ./src"

# Ler arquivo específico
pagia skill run file-analyzer -p "Leia package.json e explique"

# Auditoria completa
pagia skill run file-analyzer -p "Audite o projeto em ."