claude-plugins/gestao/skills/worklog/SKILL.md

name: worklog description: Registo de trabalho e reflexão unificado. Analisa sessão, regista trabalho, identifica padrões, sugere acções. /reflect é alias (mesmo resultado). Variantes: deep (análise profunda), week (revisão semanal). Usar quando "worklog", "reflect", "reflexão", "registar trabalho", "log", ao parar timer. context: fork

/worklog v4.0 - Registo de Trabalho + Reflexão

Skill unificada: regista trabalho, analisa sessão, sugere acções, guarda memória.

/reflect = alias de /worklog (mesmo resultado).

---

Comandos

Comando	Função
/worklog	Registo + reflexão da sessão
/reflect	Alias de /worklog
/worklog view	Ver últimos registos
/reflect deep	Análise profunda com histórico
/reflect week	Revisão semanal (segundas via /today)

---

Storage

Tipo	Discussão	ID
Logs + Reflexões	Logs	31
Reflexões Profundas	Reflexões	32
Acções	Acções de Melhoria	33

Projecto: #65 (DES Stack Workflow) | Staff: 25 (AikTop)

---

Protocolo Principal (/worklog e /reflect)

1. Obter hora via mcp__mcp-time__current_time
2. Verificar timer activo em ~/.claude-work/active-timer.json
3. ANALISAR sessão:
   - Ficheiros modificados (Edit/Write calls)
   - MCPs usados
   - Erros e soluções
   - Padrões detectados
   - Eficiência (tool calls vs resultado)
3b. VERIFICAR alinhamento com spec (se aplicavel):
   - Detectar ficheiros modificados na sessao
   - Procurar SPEC.md no directorio pai (ate 3 niveis)
   - SE spec approved/in_progress: comparar ficheiros vs scope items
   - SE ficheiro nao mapeia para scope: incluir SCOPE ALERT no worklog
   - SE sem SPEC.md: ignorar silenciosamente
4. VERIFICAR se há algo novo a documentar
   - Se sessão vazia/sem dados → NÃO gerar
5. Gerar comentário HTML (ver formato abaixo)
6. mcp__desk-crm-v3__add_discussion_comment({
     discussion_id: 31,
     content: html,
     staff_id: 25
   })
7. SE acções sugeridas:
   mcp__desk-crm-v3__add_discussion_comment({
     discussion_id: 33,
     content: accoes_html,
     staff_id: 25
   })
7b. TRIGGER improvement-evaluator no dev:
   mcp__ssh-unified__ssh_execute({
     server: "dev",
     command: "curl -s -X POST http://localhost:8095/trigger"
   })
   (falha silenciosa OK — o cron apanha em 30min)
8. SE insight valioso → save_memory Supabase
9. Confirmar

Output:

Worklog registado!

Tarefa: #1446 - Documentação Skills
Duração: 2h 15m
Discussão: #31 (Logs)
Acções: 2 sugeridas (#33)
Memória: Guardada / N/A

---

Formato Comentário HTML (Discussão #31)

<h4>YYYY-MM-DD HH:MM - Título da Sessão</h4>

<p><strong>Projecto:</strong> Nome</p>
<p><strong>Tarefa:</strong> #ID - Nome</p>
<p><strong>Duração:</strong> ~XXh YYm</p>
<p><strong>Resultado:</strong> Concluído | Parcial | Bloqueado</p>

<h4>Trabalho Realizado</h4>
<ul>
  <li>Acção 1</li>
  <li>Acção 2</li>
</ul>

<h4>Ficheiros Modificados</h4>
<ul>
  <li><code>path/file.ext</code> - descrição</li>
</ul>

<h4>Problemas / Soluções</h4>
<ul>
  <li><strong>Problema:</strong> Descrição
      <br><strong>Solução:</strong> Como foi resolvido</li>
</ul>

<h4>Alertas de Scope</h4>
<ul>
  <li><strong>SCOPE ALERT:</strong> <code>path</code> nao mapeado no SPEC</li>
</ul>

<h4>Padrões Detectados</h4>
<ul>
  <li>Padrão identificado e impacto</li>
</ul>

<h4>Acções Sugeridas</h4>
<p><em>Detalhes na discussão #33</em></p>
<ul>
  <li>[Tipo] Descrição breve</li>
</ul>

<h4>Próximos Passos</h4>
<ol>
  <li>Tarefa pendente 1</li>
</ol>

---

Formato Acções (Discussão #33)

Cada acção num comentário separado:

<p>- [ ] [Tipo] Descrição da acção</p>
<p><strong>Origem:</strong> Worklog YYYY-MM-DD HH:MM</p>
<p><strong>Prioridade:</strong> P1/P2/P3</p>
<p><strong>Contexto:</strong> Breve explicação</p>

Tipos: [CLAUDE.md], [Skill], [MCP], [Workflow], [Bug], [Feature]

---

/worklog view

1. mcp__desk-crm-v3__get_project_discussions({ project_id: 65 })
2. Filtrar discussão #31
3. Mostrar últimos 5 comentários

---

/reflect deep (Análise Profunda)

Análise mais detalhada que o worklog normal. Publica em discussão #32 (Reflexões).

1. Ler comentários recentes de #31 (worklogs) e #32 (reflexões)
2. Analisar padrões repetidos
3. Comparar eficiência com sessões anteriores
4. Verificar TaskForces utilizadas (ver Integração TaskForce)
5. Gerar comentário detalhado em #32
6. Acções em #33
7. Memória Supabase

---

/reflect week (Revisão Semanal)

Chamado automaticamente pelo /today às segundas-feiras. Publica em #32.

1. Ler comentários de #31 e #32 da semana
2. Agregar padrões e métricas
3. Gerar resumo semanal
4. Identificar melhorias prioritárias

Formato:

<h4>Semana YYYY-WNN - Revisão</h4>

<h4>Métricas</h4>
<table>
  <tr><td>Sessões registadas</td><td>N</td></tr>
  <tr><td>Reflexões geradas</td><td>M</td></tr>
  <tr><td>Padrões detectados</td><td>P</td></tr>
</table>

<h4>Padrões Frequentes</h4>
<ol><li>Padrão A - Nx detectado</li></ol>

<h4>Melhorias Prioritárias</h4>
<ul>
  <li>[ ] [P1] Descrição</li>
  <li>[ ] [P2] Descrição</li>
</ul>

<h4>Plano Esta Semana</h4>
<ul>
  <li>Implementar: X</li>
  <li>Monitorar: Y</li>
</ul>

---

Integração /time

Quando /time stop é executado:

1. Timer parado
2. Mostrar resumo (tarefa, duração)
3. Perguntar: "Criar worklog? [Sim/Não]"
4. Se sim → Gerar worklog com contexto do timer

---

Auto-Save Memória

Tipo	Exemplo	Guardar?
Solução técnica nova	Fix para erro MCP	Sim
Configuração sistema	Novo MCP configurado	Sim
Workaround descoberto	Bypass para bug	Sim
Padrão novo	"X funciona melhor que Y"	Sim
Decisão arquitectural	Escolha de abordagem	Sim
Trabalho rotineiro	Updates, limpeza	Não

---

Checklist de Reflexão

Perguntas ao analisar sessão:

• O sistema respondeu bem aos pedidos?
• Houve confusão ou mal-entendidos?
• Alguma tarefa repetitiva deveria ser skill?
• Faltou informação que deveria estar em memória?
• Alguma regra CLAUDE.md foi violada?
• Os MCPs funcionaram correctamente?
• Context health: CLAUDE.md global <200 linhas? MEMORY.md <80 linhas? (Ref: DEV-CTX-001)

---

Auto-Alerts Data-Driven

Alerta	Threshold	Acção
Degradação performance	>15% vs baseline (7d)	Investigar causa
Error rate alto	>10% (30d)	Analisar erros
KB offline	3 timeouts	Verificar MCP

Formato alerta: Inclui componente, tipo, threshold, valor actual, investigação e acções sugeridas.

---

Integração TaskForce (para /reflect deep)

1. LER ~/.claude/sdks/_registry.json
2. COMPARAR com skills/agents usados na sessão
3. SE match: adicionar secção "SDKs Utilizados" com tempo e baseline

---

Auto-Trigger

Trigger	Acção
>10 tool calls	Gerar worklog background
Parar timer	Oferecer criar worklog
Mudança de projecto	Fechar sessão anterior
Mesmo erro 2+ vezes	Analisar causa
Segunda-feira via /today	Revisão semanal

---

Anti-Patterns

• NUNCA criar worklog sem dados de sessão
• NUNCA usar Markdown em comentários (usar HTML)
• NUNCA guardar memória para trabalho rotineiro
• NUNCA duplicar reflexão e worklog (são o mesmo)

---

Changelog

v4.2.0 (2026-03-12)

• Integração improvement-evaluator: passo 7b trigger automático ao dev (POST :8095/trigger)
• Acções publicadas em #33 são avaliadas imediatamente pelo agente cron no dev

v4.0.0 (2026-02-06)

• Fusão de /worklog e /reflect numa skill unificada
• /reflect torna-se alias de /worklog
• Discussão #31 recebe tudo (worklog + reflexão)
• Discussão #32 reservada para /reflect deep e /reflect week
• Checklist de reflexão integrado
• Auto-alerts data-driven integrados
• Integração TaskForce mantida para /reflect deep

v3.0.0 (2026-02-05)

• Integração completa com /time
• Auto-trigger ao parar timer
• Formato HTML alinhado com Regra #27

---

Skill v4.2.0 | 2026-03-12 | Descomplicar(R)