135 lines
3.4 KiB
Markdown
135 lines
3.4 KiB
Markdown
---
|
|
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)
|