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

name, description

name	description
qw	Recapitulação rápida de sessão — resumo conciso do trabalho feito, actualização de docs e memória mem0. Uso: /qw ao finalizar tarefa ou sessão curta. Complemento leve ao /worklog.

/qw v1.0 — Quick Wrap-up (Recapitulação Rápida)

⚠️ EXECUÇÃO INLINE OBRIGATÓRIA — NUNCA FORK

Protocolo simples e rápido (máx 2 min) para fechar sesões curtas ou tarefas isoladas. Complemento ao /worklog (pesado).

---

Comandos

Comando	Função
/qw	Recapitulação rápida + mem0
/qw --docs	Actualizar docs (README, CHANGELOG)
/qw --mem	Guardar memória mem0 apenas

---

Protocolo Principal (/qw)

1. Obter hora actual (mcp__mcp-time__current_time)
2. RESUMIR sessão em máx 3 bullets:
   - Ficheiro(s) modificado(s) + linha brevíssima do quê
   - Problema resolvido / Tarefa finalizada
   - Padrão/insight (se relevante)
3. ACTUALIZAR docs (escolher 1):
   a. Se ficheiro novo: adicionar linha ao README (secção "Estrutura" ou similar)
   b. Se ficheiro existente alterado: actualizar CHANGELOG (formato: - YYYY-MM-DD Descrição)
   c. Se nenhum doc relevante: omitir
4. GUARDAR memória mem0:
   - Tipo: semantic (P3) — facto conciso e reutilizável
   - Tags: mínimo 2 (ex: "task", "bugfix" ou "feature", "integracao")
   - Conteúdo: "O que foi feito + resultado" (máx 80 chars)
   - tier: global se cross-projecto, project se específico
5. OUTPUT:
   - Resumo legível
   - Ficheiros afectados
   - Link memória (se criada)

---

Exemplo de Uso

Input:

/qw

Output (gerado automático):

✅ Quick Wrap-up — 2026-07-02 16:45

📝 RESUMO
• qw/SKILL.md criada — skill recapitulação rápida
• docs atualizados — README.md com link nova skill
• memória guardada (mem0) — meta skill gestao/qw

📦 FICHEIROS
 - ~/.claude/plugins/.../gestao/skills/qw/SKILL.md (novo)
 - ~/.claude/plugins/.../gestao/README.md (actualizado)

💾 MEM0
 ID: mem0_xyz... 
 "Criada skill /qw para recapitulação sessões curtas"
 Tags: skill, gestao

---
⏱️ Duração: 45s | Estado: OK

---

Storage

Memória mem0 (gateway.descomplicar.pt/v1/mem0/mcp):

• Protocolos: Wayland v2 (P5/P4/P3, tags, tier)
• Limite: máx 80 chars por entrada
• Dedup: pesquisar com mcp__mem_search_memories antes de gravar (IJFW foi descontinuado e removido — Mem0 é o único store canónico)
• Tier: global para skill/padrão cross-projecto, project para específico

---

Variantes

/qw --docs (Actualizar Docs)

Apenas actualiza README/CHANGELOG sem resumo:

- Procura README ou CHANGELOG na pasta actual (até 2 níveis acima)
- Insere/actualiza entrada
- Omite memória e resumo

/qw --mem (Memória Apenas)

Apenas guarda mem0, sem resumo:

- Pede prompt: "Qual o insight para guardar?"
- Formata e guarda via mem0 MCP
- Output: ID memória apenas

---

Integração com Plugin gestao

Local: ~/.claude/plugins/marketplaces/descomplicar-plugins/gestao/skills/qw/

Ficheiros:

• SKILL.md — este ficheiro
• prompts/ — templates de prompts (se necessário)

Regra CLAUDE.md: Skills gestao executam INLINE (nunca fork). Sem subagentes.

---

Checklist Implementação

• SKILL.md criada
• Skill registada em plugin.json (gestao)
• Prompts adicionados (se necessário)
• Teste manual: /qw
• Teste com --docs flag
• Teste com --mem flag
• Validação mem0 (verificar entrada criada)

---

Versão: 1.0 | Data: 2026-07-02 | Plugin: gestao | Staff: 25 (Claude)