ealmeida
faef9b47dc
Dify foi removido 06-03-2026. Skills brainstorm/discover ainda referenciam-no no corpo. Bump v1.2 + nota top-of-file. Reescrita workflow para próxima sessão. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
132 lines
3.4 KiB
Markdown
132 lines
3.4 KiB
Markdown
---
|
|
name: review-corrections
|
|
description: >
|
|
Analisa correcções feitas pelo utilizador nas últimas sessões e gera sugestões
|
|
de regras para CLAUDE.md. Lê ~/.claude-work/corrections.jsonl, agrupa por padrão,
|
|
e propõe melhorias concretas. Usar semanalmente (via /schedule) ou quando há >5
|
|
correcções acumuladas. Faz parte do loop de auto-melhoria (Eixo 3, Stack Q2 2026).
|
|
---
|
|
|
|
# /review-corrections — Análise de Correcções e Auto-melhoria
|
|
|
|
Analisa padrões de correcção do utilizador para melhorar o CLAUDE.md autonomamente.
|
|
|
|
---
|
|
|
|
## Workflow
|
|
|
|
### Passo 1 — Ler ficheiro de correcções
|
|
|
|
```bash
|
|
cat ~/.claude-work/corrections.jsonl
|
|
```
|
|
|
|
Cada linha é um JSON:
|
|
```json
|
|
{"ts":"2026-04-06T14:30:00","type":"correction","prompt":"não assim, usa grep","session":"abc","cwd":"/Hub/"}
|
|
```
|
|
|
|
### Passo 2 — Agrupar por padrão
|
|
|
|
Categorias de correcção:
|
|
|
|
| Padrão | Keywords | Acção sugerida |
|
|
|--------|---------|----------------|
|
|
| **Ferramenta errada** | "usa grep", "não uses bash", "usa read" | Regra de preferência de ferramenta |
|
|
| **Língua/formato** | "em português", "sem emojis", "com acentos" | Regra de output |
|
|
| **Abordagem** | "não assim", "de outra forma", "mais simples" | Regra de heurística |
|
|
| **Scope** | "não faças isso", "não toques em", "só X" | Regra de limites |
|
|
| **Verificação** | "verifica primeiro", "não inventar", "confirma" | Regra anti-alucinação |
|
|
|
|
### Passo 3 — Gerar sugestões de regras
|
|
|
|
Para cada padrão com ≥2 ocorrências, propor regra no formato:
|
|
|
|
```markdown
|
|
**Regra candidata:**
|
|
> [Padrão detectado N vezes] → Sugestão: "Nunca [X], sempre [Y]"
|
|
|
|
**Evidência:**
|
|
- "prompt1" (data)
|
|
- "prompt2" (data)
|
|
|
|
**Proposta CLAUDE.md:**
|
|
| NN | [Texto da regra concisa] |
|
|
```
|
|
|
|
### Passo 4 — Apresentar ao utilizador
|
|
|
|
```markdown
|
|
## Revisão de Correcções — [data]
|
|
|
|
**Total analisado:** N correcções em M sessões
|
|
**Padrões encontrados:** P
|
|
|
|
### Regras candidatas (aprovação necessária)
|
|
|
|
[lista de propostas]
|
|
|
|
### Limpar ficheiro?
|
|
[ ] Sim — arquivar em ~/.claude-work/corrections-archive-YYYY-MM.jsonl
|
|
[ ] Não — manter para próxima revisão
|
|
```
|
|
|
|
### Passo 5 — Aplicar regras aprovadas
|
|
|
|
Se o utilizador aprovar uma regra:
|
|
1. Abrir `~/.claude/CLAUDE.md`
|
|
2. Adicionar na tabela de REGRAS CORE com número sequencial
|
|
3. Confirmar: "Regra #NN adicionada."
|
|
|
|
Se o utilizador recusar:
|
|
- Arquivar correcção com tag `rejected`
|
|
- Não propor de novo
|
|
|
|
---
|
|
|
|
## Quando usar
|
|
|
|
- **Semanal** (via `/schedule` às segundas-feiras com `/today`)
|
|
- **Manual** quando corrections.jsonl tem >5 entradas
|
|
- **Após incidente** (mesmo erro 2+ vezes consecutivos)
|
|
|
|
---
|
|
|
|
## Integração auto-trigger
|
|
|
|
O hook `capture-corrections.sh` regista automaticamente em `~/.claude-work/corrections.jsonl`.
|
|
Esta skill consome esse ficheiro e fecha o loop de auto-melhoria.
|
|
|
|
**Loop completo:**
|
|
```
|
|
Correcção utilizador
|
|
→ capture-corrections.sh (regista)
|
|
→ /review-corrections (analisa)
|
|
→ CLAUDE.md (actualiza)
|
|
→ Comportamento melhora
|
|
```
|
|
|
|
---
|
|
|
|
## Anti-patterns
|
|
|
|
- Nunca aplicar regras sem aprovação explícita do utilizador
|
|
- Nunca propor regras com <2 ocorrências (pode ser caso isolado)
|
|
- Nunca eliminar regras existentes — apenas adicionar ou reformular
|
|
|
|
---
|
|
|
|
*Skill v1.0.0 | 06-04-2026 | Descomplicar®*
|
|
|
|
---
|
|
|
|
## Healing Log
|
|
|
|
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
|
|
|
```jsonl
|
|
{"date":"","issue":"","fix":"","source":"user|auto"}
|
|
```
|
|
|
|
*Adicionar nova linha após cada erro corrigido.*
|