| name | revisao-semanal |
| description | Gera um relatório semanal em formato release notes do que foi trabalhado no vault (git log + diffs), com 4 lentes de insight (conhecimento, dificuldades/retrabalho, alertas, conselhos & próximos passos). Grava em `00-Meta/revisoes/<ano>/YYYY-Www.md`. Aciona com "/revisao-semanal", "revisão da semana", "resumo do que trabalhei essa semana", "release notes da semana", ou disparada por cron de sábado. Report-only — NUNCA escreve em arquivos de conteúdo (ex: entradas.md). Portável: nada hardcoded por vault; lê a identidade do grimório em runtime. |
Skill: revisao-semanal
Gera um relatório semanal em formato release notes do que foi trabalhado no vault na última janela, derivando o changelog do git log e aplicando quatro lentes de insight. O relatório é a entrada da reflexão do usuário, não a reflexão — então extrai o máximo de insight útil sozinho. Report-only: escreve apenas o relatório; nunca toca em arquivos de conteúdo.
Quando usar
- Usuário invoca
/revisao-semanal.
- Usuário diz "revisão da semana", "resumo do que trabalhei", "release notes da semana".
- Disparada pelo cron de sábado (
claude -p "/revisao-semanal").
Quando NÃO usar
- Auditoria estrutural (links quebrados, órfãs, frontmatter) → isso é o
health-audit.py / /verificar-wikilinks, não esta skill.
- Quando o usuário quer promover trabalho pro pipeline → use
/promover-glosa, /sintetizar-glosas (esta skill só sugere, não executa).
Argumentos
Sem argumentos. A janela é resolvida automaticamente.
Fluxo de execução
-
Resolver a janela (resiliente a gaps):
- Listar relatórios existentes:
ls 00-Meta/revisoes/*/*.md 2>/dev/null.
- Se houver, pegar o mais recente e ler
periodo_fim do frontmatter → since = periodo_fim.
- Se não houver nenhum,
since = 7 dias atrás (date -d '7 days ago' +%F) e marcar no corpo que é a primeira revisão.
until = hoje (date +%F).- Label da semana = semana ISO da data-fim:
date -d <until> +%G-W%V → ex. 2026-W23.
-
Coletar o sinal objetivo (git):
git log --since="$since" --until="$until" --pretty=format:'%h|%ad|%s' --date=short
git log --since="$since" --until="$until" --numstat --pretty=format:'%H'
git log --since="$since" --until="$until" --diff-filter=A --name-only --pretty=format:
git log --since="$since" --until="$until" --diff-filter=D --name-only --pretty=format:
git log --since="$since" --until="$until" --diff-filter=R --name-status --pretty=format:
- Agregar linhas +/− por arquivo (numstat) → churn.
- Ignorar mensagens
vault backup: <timestamp> como narrativa; derivar o changelog dos arquivos alterados.
-
Classificar arquivos por zona/sinal:
02-Glosas/** → o que o usuário leu/fichou.03-Dominios/** (TODOS os domínios, nenhum privilegiado) → o que produziu/integrou.- Notas diárias → ler
.obsidian/daily-notes.json (folder, format; default raiz + YYYY-MM-DD); se ausente mas daily-notes estiver em .obsidian/core-plugins.json, assumir raiz+YYYY-MM-DD; checar também .obsidian/plugins/periodic-notes/data.json. Arquivos casando = trabalho do dia-a-dia.
04-Sendas/** → só referência; entra no changelog se mudou, não conta como aprendizado.00-Meta/**, docs/** → meta-trabalho; só changelog.
-
Ler conteúdo das notas de maior churn (não todas) via git diff ou Read, para alimentar as lentes de insight com substância real.
-
Aplicar as 4 lentes:
- 💡 Insights de conhecimento: temas recorrentes e conexões entre domínios nas notas tocadas; sínteses possíveis (ex: "3 notas tocaram RAG → candidata a
/sintetizar-glosas").
- 🧗 Dificuldades & retrabalho: churn alto, commits
fix/revert, trabalho recuperado de stash → onde houve atrito.
- ⚠️ Alertas & dívidas: notas criadas mas curtas/sem conclusão, headings vazios, TODOs no diff, notas sem título. Não repetir auditoria estrutural — foco em incompletude de conteúdo.
- 🎯 Conselhos & próximos passos: des-ancorado de domínio. Ler
index.md (manifesto do grimório) como "norte" = cultivar evergreen via glosas→domínios. Avaliar: glosas maduras pra /promover-glosa//sintetizar-glosas; domínios que ganharam massa; lacunas; o que ler/produzir a seguir. Só no relatório.
-
Escrever o relatório em 00-Meta/revisoes/<ano>/YYYY-Www.md (criar <ano>/ com mkdir -p). Usar o nome do vault (do # título em index.md, ou o basename do diretório-raiz) no header do release. As 4 lentes são SEMPRE renderizadas; se uma não tiver achado, escrever "nada digno de nota".
-
Reportar ao usuário (no chat, quando interativo) o path do relatório e o TL;DR.
Formato do relatório
Frontmatter:
---
title: "Revisão Semanal — 2026-W23"
type: revisao
publish: false
semana: 2026-W23
periodo_inicio: 2026-06-01
periodo_fim: 2026-06-07
created: 2026-06-07
tags:
- meta
- revisao-semanal
---
Sempre publish: false — relatórios de revisão são privados e não vão pro site público (Quartz publica quando publish é true ou ausente).
Corpo:
# <Vault> — Release 2026.W23 (01–07 jun)
> [!abstract] TL;DR
> 1–2 frases: foco da semana + achado mais importante.
## 📦 Changelog
### ✨ Adicionado
### 📝 Refinado
### 🗑 Arquivado/Movido
_Rodapé: N commits · M arquivos · +X/−Y linhas_
## 💡 Insights de conhecimento
## 🧗 Dificuldades & retrabalho
## ⚠️ Alertas & dívidas
## 🎯 Conselhos & próximos passos
Edge cases
| Caso | Comportamento |
|---|
| Janela vazia (sem commits) | Relatório curto: "sem atividade registrada nesta janela" |
| Sem relatório anterior | Janela de 7 dias + nota "primeira revisão" |
| Re-run no mesmo período | Sobrescrever o arquivo da semana (idempotente) |
| Run headless falha (auth/claude) | Falha visível no .cron.log; relatório só é escrito no passo final, então nada é corrompido |
| Lente sem achado | Renderizar a seção com "nada digno de nota" |
Convenções
- Report-only: NUNCA escreve em
01-Pergaminhos/entradas.md nem em qualquer arquivo de conteúdo. Conselhos vivem só no relatório.
publish: false em todo relatório — conteúdo meta privado, fora do site.- Nenhum domínio privilegiado: a análise gravita em torno de glosas + domínios + notas diárias trabalhados.
- Ruído do git:
vault backup: <timestamp> não vira narrativa.
- Portável: nada hardcoded por vault; a identidade vem de
index.md e a pasta de daily notes vem da config do Obsidian em runtime.
