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

name, description, author, version, quality_score, user_invocable, category, tags, desk_task, desk_project, desk_discussion_logs, desk_discussion_reflexoes, desk_discussion_accoes, allowed-tools, mcps, dependencies, auto_trigger

name	description	author	version	quality_score	user_invocable	category	tags	desk_task	desk_project	desk_discussion_logs	desk_discussion_reflexoes	desk_discussion_accoes	allowed-tools	mcps	dependencies	auto_trigger
worklog	Registo de trabalho + reflexão unificado v4.0. Analisa sessão, regista trabalho, identifica padrões, sugere acções. /reflect é alias (mesmo resultado). Variantes: /reflect deep (análise profunda), /reflect week (revisão semanal). Auto-trigger >10 tool calls. Auto-alerts degradação >15%, error rate >10%. Use when "worklog", "reflect", "reflexão", "registar trabalho", "log", "análise", "melhoria", "insight", ao parar timer.	Descomplicar® Crescimento Digital	4.1.0	95	true	productivity	log trabalho reflexao auto-melhoria produtividade time-tracking memory pdca alerts	1554	65	31	32	33	Read, Write, Bash, mcp__desk-crm-v3, mcp__mcp-time, mcp__memory-supabase, mcp__ssh-unified	desk-crm-v3, mcp-time, memory-supabase, ssh-unified	skills mcps sdk metrics desk-crm-v3 memory-supabase	enabled threshold_tool_calls background alerts true 10 true performance_degradation 15 error_rate 10 kb_offline 3

/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
   })
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.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.1.0 | 2026-03-04 | Descomplicar(R)