fix(gestao): corrige YAML frontmatter invalido em qw/worklog, remove ijfw_memory_recall morto, recupera report-5w2h perdido, bump 1.6.1
This commit is contained in:
Claude Code AI
@@ -0,0 +1,82 @@
|
||||
# Prompt Base — /qw Quick Wrap-up
|
||||
|
||||
## Sistema
|
||||
|
||||
Tu és a instância Claude Code, execução INLINE. Tarefa: gerar recapitulação rápida de sessão.
|
||||
|
||||
**Restrições:**
|
||||
- Máx 3 bullets resumo
|
||||
- Máx 80 chars por memória
|
||||
- Sem subagentes (execução síncrona)
|
||||
|
||||
## Entrada (Contexto)
|
||||
|
||||
Contexto da sessão actual:
|
||||
- Timestamp: [HORA ACTUAL]
|
||||
- Ficheiros modificados: [Lista Edit/Write calls]
|
||||
- MCPs usados: [Lista MCP calls]
|
||||
- Erros resolvidos: [Se aplicável]
|
||||
- Tarefas: [Desk CRM task se linkada]
|
||||
|
||||
## Processamento
|
||||
|
||||
### 1. Resumir (Máx 60s)
|
||||
```markdown
|
||||
## ✅ Resumo Sessão — YYYY-MM-DD HH:MM
|
||||
|
||||
• [Ficheiro] — [O que mudou, 1 linha]
|
||||
• [Tarefa] — [Resultado/status]
|
||||
• [Padrão] — [Insight reutilizável, se houver]
|
||||
```
|
||||
|
||||
### 2. Actualizar Docs (Máx 30s)
|
||||
```
|
||||
Se ficheiro NOVO:
|
||||
README.md secção "Estrutura" → adicionar linha
|
||||
|
||||
Se ficheiro ALTERADO:
|
||||
CHANGELOG.md → linha em ## [Unreleased]:
|
||||
- YYYY-MM-DD Descrição concisa
|
||||
```
|
||||
|
||||
### 3. Memória mem0 (Máx 30s)
|
||||
```
|
||||
- Protocolо Wayland v2 (P3 — fact)
|
||||
- Sujeito | predicado | objecto
|
||||
- Tags: mínimo 2 (task, feature, bugfix, integration, etc)
|
||||
- Tier: global / project
|
||||
- Exemplo:
|
||||
"Skill /qw criada | propósito | recapitulação sessões curtas"
|
||||
```
|
||||
|
||||
## Output Final
|
||||
|
||||
```
|
||||
✅ Quick Wrap-up — [TIMESTAMP]
|
||||
|
||||
📝 RESUMO
|
||||
[3 bullets aqui]
|
||||
|
||||
📦 FICHEIROS ALTERADOS
|
||||
[Lista]
|
||||
|
||||
💾 MEM0
|
||||
ID: [mem0_id]
|
||||
Conteúdo: [entrada]
|
||||
|
||||
⏱️ Duração: [segundos]s | Estado: OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Flags
|
||||
|
||||
### `--docs`
|
||||
Apenas actualizar docs (README, CHANGELOG). Omitir resumo.
|
||||
|
||||
### `--mem`
|
||||
Apenas guardar memória. Pedir prompt input: "Insight para guardar?"
|
||||
|
||||
---
|
||||
|
||||
Versão: 1.0 | 2026-07-02
|
||||
@@ -0,0 +1,202 @@
|
||||
# Exemplos de Uso — /qw
|
||||
|
||||
## Exemplo 1: Criar Ficheiro Novo
|
||||
|
||||
**Contexto:** Acabaste de criar `novo-modulo.js` com 150 linhas.
|
||||
|
||||
```bash
|
||||
/qw
|
||||
```
|
||||
|
||||
**Processamento automático:**
|
||||
1. Detecta novo ficheiro: `novo-modulo.js`
|
||||
2. Actualiza `README.md` secção "Estrutura" com: `- novo-modulo.js — módulo XYZ`
|
||||
3. Cria memória mem0:
|
||||
- Subject: "novo-modulo.js"
|
||||
- Predicate: "criado para"
|
||||
- Object: "funcionalidade XYZ"
|
||||
- Tags: "feature", "javascript"
|
||||
- Tier: "project"
|
||||
|
||||
**Output:**
|
||||
```
|
||||
✅ Quick Wrap-up — 2026-07-02 14:23
|
||||
|
||||
📝 RESUMO
|
||||
• novo-modulo.js criado — 150 linhas, export default class XYZ
|
||||
• README actualizado — secção Estrutura
|
||||
• Memória guardada — mem0 (feature/javascript)
|
||||
|
||||
📦 FICHEIROS
|
||||
+ novo-modulo.js
|
||||
~ README.md
|
||||
|
||||
💾 MEM0 ID: mem0_abc123...
|
||||
|
||||
⏱️ 38s | OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplo 2: Bugfix + Docs
|
||||
|
||||
**Contexto:** Corrigiste bug em `auth.js` linha 45 (return typo).
|
||||
|
||||
```bash
|
||||
/qw
|
||||
```
|
||||
|
||||
**Processamento:**
|
||||
1. Detecta ficheiro alterado: `auth.js`
|
||||
2. Actualiza `CHANGELOG.md` em `## [Unreleased]`:
|
||||
```
|
||||
- 2026-07-02 [auth] Corrigido typo return em validação token
|
||||
```
|
||||
3. Memória mem0:
|
||||
- Subject: "auth.js"
|
||||
- Predicate: "bugfix"
|
||||
- Object: "return typo validação token (linha 45)"
|
||||
- Tags: "bugfix", "javascript"
|
||||
|
||||
**Output:**
|
||||
```
|
||||
✅ Quick Wrap-up — 2026-07-02 14:25
|
||||
|
||||
📝 RESUMO
|
||||
• auth.js corrigido — typo return em validação token (linha 45)
|
||||
• CHANGELOG actualizado — entrada [Unreleased]
|
||||
• Memória guardada — mem0 (bugfix/javascript)
|
||||
|
||||
📦 FICHEIROS
|
||||
~ auth.js
|
||||
|
||||
💾 MEM0 ID: mem0_def456...
|
||||
|
||||
⏱️ 22s | OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplo 3: Usar Flag --docs
|
||||
|
||||
**Contexto:** Já refiste 3 ficheiros mas esqueceste de actualizar README.
|
||||
|
||||
```bash
|
||||
/qw --docs
|
||||
```
|
||||
|
||||
**Processamento:**
|
||||
1. Detecta ficheiros alterados
|
||||
2. Apenas actualiza README/CHANGELOG
|
||||
3. Omite resumo e memória
|
||||
4. Output minimalista
|
||||
|
||||
**Output:**
|
||||
```
|
||||
✅ Docs Updated — 2026-07-02 14:27
|
||||
|
||||
📦 FICHEIROS
|
||||
~ README.md
|
||||
~ CHANGELOG.md
|
||||
|
||||
⏱️ 8s | OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplo 4: Usar Flag --mem
|
||||
|
||||
**Contexto:** Descobriste um padrão interessante durante a sessão.
|
||||
|
||||
```bash
|
||||
/qw --mem
|
||||
```
|
||||
|
||||
**Processamento:**
|
||||
1. Pede input: "Qual o insight para guardar?"
|
||||
2. Utilizador responde: "Usar useCallback para memoização em loops React"
|
||||
3. Formata e guarda em mem0
|
||||
4. Output: apenas ID memória
|
||||
|
||||
**Output:**
|
||||
```
|
||||
💾 MEM0 Saved
|
||||
|
||||
ID: mem0_ghi789...
|
||||
Entrada: "useCallback | memoização | loops React evita re-renders"
|
||||
Tags: react, performance, padrão
|
||||
Tier: global
|
||||
|
||||
⏱️ 15s | OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplo 5: Integração com Desk CRM
|
||||
|
||||
**Contexto:** Estás a trabalhar na tarefa #2401 do Desk.
|
||||
|
||||
```bash
|
||||
/qw
|
||||
```
|
||||
|
||||
**Processamento automático (se `.desk-project` detectado):**
|
||||
1. Lê `.desk-project` → tarefa_id = 2401
|
||||
2. Gera resumo com link à tarefa
|
||||
3. Memória mem0 inclui ref task_id
|
||||
|
||||
**Output:**
|
||||
```
|
||||
✅ Quick Wrap-up — 2026-07-02 14:30
|
||||
|
||||
📝 RESUMO
|
||||
• Tarefa #2401 — implementação API endpoint /users
|
||||
• Documentação atualizada — docs/api.md com endpoint spec
|
||||
• Memória guardada — mem0 com ref task #2401
|
||||
|
||||
📦 FICHEIROS
|
||||
+ src/api/endpoints/users.js
|
||||
~ docs/api.md
|
||||
|
||||
💾 MEM0 ID: mem0_jkl012... [task_id: 2401]
|
||||
|
||||
⏱️ 35s | OK
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplo 6: Nenhum Ficheiro Alterado
|
||||
|
||||
**Contexto:** Tiveste uma sessão de investigação/leitura apenas (sem edições).
|
||||
|
||||
```bash
|
||||
/qw
|
||||
```
|
||||
|
||||
**Processamento:**
|
||||
1. Detecta: sem Edit/Write calls
|
||||
2. Omite output (nada para registar)
|
||||
3. Log silencioso: `[QW] Nada para registar — sessão leitura`
|
||||
|
||||
**Output:**
|
||||
```
|
||||
ℹ️ Quick Wrap-up
|
||||
|
||||
Nenhum ficheiro alterado nesta sessão. Omitido.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checklist Implementação (Para Testar)
|
||||
|
||||
- [ ] Criar novo ficheiro, rodar `/qw`, verificar README/CHANGELOG
|
||||
- [ ] Editar ficheiro existente, rodar `/qw`, verificar CHANGELOG
|
||||
- [ ] Testar `/qw --docs` (só docs)
|
||||
- [ ] Testar `/qw --mem` (só memória, com input)
|
||||
- [ ] Verificar mem0 entries criadas em gateway.descomplicar.pt
|
||||
- [ ] Testar em projecto com `.desk-project` (task link)
|
||||
- [ ] Testar sem alterações (nada para registar)
|
||||
|
||||
---
|
||||
|
||||
**Versão:** 1.0 | 2026-07-02
|
||||
Reference in New Issue
Block a user