AgentSkillsCN

repo-health

分析仓库的总体概况,提取结构化模型与相关证据,为后续分析提供指导。

SKILL.md
--- frontmatter
name: repo-health
description: Analisa o perfil do repositório e extrai um modelo estruturado com evidências para orientar outras análises.

Skill: Repo Health

Quando usar

Execute esta skill quando estiver começando a análise de um repositório e precisar:

  • Determinar tipo de projeto (app, lib, monorepo)
  • Identificar stack tecnológica
  • Construir um modelo de contexto reutilizável por outras skills

Escopo da skill

Inclui:

  • Modelagem da estrutura de arquivos
  • Identificação de linguagens/frameworks
  • Detectar presença de configurações importantes (package.json, configs)

Não inclui:

  • Análises de qualidade profundas (essas são outras skills)

Entradas esperadas

  • Árvore completa de arquivos do repositório
  • Conteúdo de:
    • package.json
    • Possíveis configs (.eslintrc, tsconfig.json, vite.config.js)

Como analisar

  1. Percorrer todos os diretórios principais.
  2. Identificar:
    • Linguagens dominantes
    • Scripts importantes (lint, test, build)
    • Estruturas comuns (src/, apps/, packages/)
  3. Classificar o repo (monorepo vs simples)
  4. Construir mapa de “pontos de interesse” para outras skills

Saída esperada

Resultado deve incluir:

  • Tipo de projeto
  • Lista de linguagens + frameworks
  • Scripts principais
  • Mapa de pastas relevantes

Regras obrigatórias

  • Deve usar conteúdo real (arquivo + corpo)
  • Não deve fazer suposições sem evidência
  • Deve retornar JSON/natureza de dados legível por outros agentes

Limitações

  • Não detecta qualidade de código
  • Não faz recomendações por si só