Avaliador de Portfólio Tecnológico
O que este skill produz
A partir de arquivos de entrada por pessoa, gera dois tipos de entregas:
-
relatorio-avaliacao-semestral.md— Relatório executivo do portfólio completo com semáforo, ranking, análise por responsável, padrões recorrentes, radar de maturidade e backlog institucional. -
ficha-[nome-sobrenome].mdpara cada membro — Documento em primeira pessoa com suas pontuações, pontos fortes, áreas de melhoria, citações da sessão e plano de desenvolvimento para o próximo semestre.
Formato de entrada
Antes de começar, verifique se o usuário forneceu informações para cada pessoa. O formato mínimo esperado por pessoa:
# [Nome Sobrenome] — Média: [XX] ([Nível])
## Período: [1º/2º Semestre AAAA]
| # | Produto | R | A | E | I | C | Observações |
|---|---|---|---|---|---|---|---|
| 1 | Nome do produto | 25 | 20 | NA | 15 | 10 | Descrição do resultado alcançado |
| 2 | Outro produto | 25 | NA | 20 | NA | NA | Descrição do resultado |
## Evidência oral (Sessão de Avanços)
Citações textuais ou paráfrases do que a pessoa disse durante a apresentação.
## Nota como responsável: [XX] ([Nível])
[Narrativa de avaliação do responsável — opcional, você pode gerá-la]
Colunas de critérios:
R= Resultado (peso base 25)A= Arquitetura (peso base 25)E= Padrões (peso base 20)I= Inovação (peso base 15)C= Colaboração (peso base 15)
Valores possíveis na tabela:
- Número ≤ peso base: conquista efetiva (igual ao base = completo; menor = parcial)
0: critério se aplica mas não foi alcançadoNA: critério não se aplica a este produto (excluído do cálculo)
Se os arquivos não tiverem tudo, pergunte ao usuário o que está faltando antes de prosseguir. Leia referencias/modelo-entrada.md para ver o formato completo com exemplos.
Fluxo de trabalho
Passo 1 — Ler e validar entradas
Leia todos os arquivos fornecidos. Para cada pessoa, verifique:
- Lista de produtos com tabela de critérios
- Pelo menos observações básicas por produto
- Evidência oral (se não existir, você pode omitir essa seção nas fichas ou pedi-la ao usuário)
Se houver ambiguidade nos valores da tabela (por exemplo, uma coluna deslocada), pergunte antes de calcular.
Passo 2 — Calcular pontuações por produto
Leia referencias/metodologia.md antes de calcular. O resumo:
Score = Σ(valor_criterio) / Σ(peso_base_criterio_aplicavel) × 100
Exemplo: produto com R=25, A=20, E=NA, I=NA, C=0 → Numerador: 25 + 20 + 0 = 45 → Denominador: 25 + 25 + 15 = 65 (R+A+C, porque E e I são NA) → Score: 45/65 × 100 = 69.2 → 69 (Aceitável 🟠)
Escala de níveis:
| Faixa | Nível | Semáforo |
|---|---|---|
| 97–100 | Excepcional | 🟢 |
| 92–96 | Excelente | 🟢 |
| 85–91 | Muito Bom | 🟢 |
| 75–84 | Bom | 🟡 |
| 65–74 | Aceitável | 🟠 |
| 50–64 | Precisa Melhorar | 🔴 |
| 0–49 | Crítico | 🔴 |
Passo 3 — Calcular médias e nota como responsável
Média do portfólio individual: média aritmética de todas as pontuações dos produtos do responsável.
Nota como responsável: pode ajustar ±5 pontos da média considerando:
- Padrão de colaboração e transferência de conhecimento (se for baixo, reduz)
- Risco de concentração de conhecimento (se for alto, pode reduzir)
- Execução diante de bloqueios (se escalou a tempo, mantém; se não, pode reduzir)
- Qualidade da reflexão e maturidade profissional (se for alta, pode aumentar)
Se você não tiver critério suficiente para ajustar, use a média diretamente.
Passo 4 — Gerar o relatório executivo
Produza relatorio-avaliacao-semestral.md. Leia referencias/estrutura-relatorio.md para a estrutura completa com modelos de cada seção.
O relatório tem estas seções em ordem:
- Resumo Executivo
- Índice de Carga por Responsável
- Metodologia de Avaliação
- Avaliação por Responsável
- Análise do Portfólio
- Radar de Maturidade do Portfólio
- Semáforo Consolidado
- Ranking
- Padrões e Recomendações
- Backlog Institucional
- Modalidade de Trabalho
- Compromissos e Plano Próximo Semestre
Passo 5 — Gerar fichas individuais
Produza ficha-[nome-sobrenome].md para cada pessoa. Leia referencias/estrutura-ficha.md para o modelo com exemplos.
Características principais das fichas:
- Tom: primeira pessoa, direto ("seu portfólio", "o que você precisa trabalhar")
- Pontos fortes: reconhecimento genuíno, com evidência específica
- Áreas de melhoria: nomeie o padrão, não apenas o sintoma
- Plano de desenvolvimento: compromissos com métrica e prazo, não genéricos
- Citações: use as citações textuais da evidência oral quando estiverem disponíveis
Passo 6 — Verificar consistência antes de entregar
- Se o total de produtos no resumo executivo coincide com a soma por responsável
- Se a distribuição de semáforos no resumo coincide com o semáforo consolidado
- Se as médias individuais coincidem com os dados do índice de carga
- Se produtos compartilhados entre responsáveis aparecem em ambas as tabelas
Notas para o avaliador
A pontuação é avaliativa, não automática. Os valores na tabela de critérios são o julgamento do avaliador sobre a conquista em cada dimensão. A fórmula mecaniza o cálculo, mas a entrada vem de uma avaliação especializada. Se o usuário fornecer os valores, aplique a fórmula. Se ele pedir que você avalie, baseie seu julgamento nas observações e evidências disponíveis.
NA ≠ 0. NA significa que o critério não se aplica (não penaliza). 0 significa que se aplica mas não foi alcançado (penaliza). A diferença muda significativamente a pontuação.
As fichas não são relatórios de RH. São documentos de desenvolvimento profissional. O plano de cada ficha deve ter compromissos específicos e mensuráveis, não frases genéricas. Evite "melhorar a comunicação" — escreva "estabelecer revisão quinzenal de avanços com o líder antes de julho de 2026".
Produtos críticos puxam a média para baixo. Um responsável com muitos produtos pode ter uma boa média geral e ainda assim ter um produto crítico que requer ação. O semáforo individual por produto é mais importante do que a média para identificar riscos.