fix(gestao): corrige YAML frontmatter invalido em qw/worklog, remove ijfw_memory_recall morto, recupera report-5w2h perdido, bump 1.6.1

2026-07-04 14:21:39 +01:00
parent 2439e3b41c
commit 49502c59da
8 changed files with 958 additions and 136 deletions
@@ -0,0 +1,134 @@
+---
+name: qw
+description: "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:** verificar `ijfw_memory_recall` antes de guardar
+- **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
+
+- [x] 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)