237 lines
5.8 KiB
Markdown
237 lines
5.8 KiB
Markdown
---
|
||
name: report
|
||
description: Report 5W2H+PDCA ao terminar tarefa/etapa — estrutura formal de conclusão com análise de resultados, documentação e memória. Integrado no domínio TASK-COMPLETION-REPORT do CARL.
|
||
---
|
||
|
||
# /report v1.0 — 5W2H + PDCA Report
|
||
|
||
**⚠️ EXECUÇÃO INLINE OBRIGATÓRIA — NUNCA FORK**
|
||
|
||
Protocolo formal ao terminar tarefa/etapa. Estrutura: 5W2H (QUÊ/QUEM/QUANDO/ONDE/POR QUÊ/COMO/CUSTO) + PDCA (Plan/Do/Check/Act).
|
||
|
||
---
|
||
|
||
## Comandos
|
||
|
||
| Comando | Função |
|
||
|---------|--------|
|
||
| `/report` | Report completo 5W2H+PDCA (interactivo) |
|
||
| `/report --quick` | Versão resumida (3 campos) |
|
||
| `/report --auto` | Auto-detectado de contexto (git, ficheiros, etc) |
|
||
|
||
---
|
||
|
||
## Protocolo Principal (/report)
|
||
|
||
```
|
||
1. RECOLHER 5W2H (interactivo ou auto-detectado):
|
||
QUÊ → O que foi entregue/resultado (deliverable)
|
||
QUEM → Executor (staff_id 25 ou outro)
|
||
QUANDO → Timestamp início/fim
|
||
ONDE → Ficheiro/pasta/sistema/Desk task
|
||
POR QUÊ → Objectivo/motivação original
|
||
COMO → Método/processo aplicado
|
||
CUSTO → Tempo estimado vs. real (em minutos)
|
||
|
||
2. RECOLHER PDCA (estruturado):
|
||
PLAN → Spec original, success criteria, scope
|
||
DO → Passos executados, decisões, desvios documentados
|
||
CHECK → Resultado vs. criteria, gaps detectados, testes
|
||
ACT → Ajustes necessários, próximas acções, melhorias
|
||
|
||
3. DOCUMENTAR:
|
||
a. Se novo ficheiro/sistema → README secção "Estrutura"
|
||
b. Se processo → criar PROC-*.md em Hub/06-Operacoes/Procedimentos/
|
||
c. CHANGELOG.md → linha em ## [Unreleased] com resumo
|
||
d. Se SEM docs relevantes → omitir
|
||
|
||
4. GUARDAR MEM0 (Wayland v2):
|
||
- subject | predicate | object (máx 80 chars)
|
||
- tags: mínimo 2 (task, feature, bugfix, etc)
|
||
- tier: project ou global
|
||
- Dedup: pesquisar com mcp__mem_search_memories antes (IJFW descontinuado — Mem0 é o store canónico)
|
||
|
||
5. GUARDAR EM DESK (se .desk-project detectado):
|
||
- Discussão #33 (Acções de Melhoria)
|
||
- Format: <h4>5W2H Report — [tarefa/etapa]</h4><p>...</p>
|
||
- HTML estruturado com tabela 5W2H + PDCA
|
||
- staff_id: 25
|
||
|
||
6. OUTPUT:
|
||
- Resumo visual com tabela 5W2H
|
||
- PDCA análise em markdown
|
||
- Link memória/Desk se criado
|
||
- Timestamp execução
|
||
```
|
||
|
||
---
|
||
|
||
## Exemplo: Report Completo
|
||
|
||
**Input:**
|
||
```
|
||
/report
|
||
```
|
||
|
||
**Processamento (interactivo):**
|
||
```
|
||
5W2H REPORT — Qual a tarefa/etapa?
|
||
> Criar skill /qw
|
||
|
||
QUÊ (Deliverable)?
|
||
> Skill /qw com recapitulação rápida + mem0
|
||
|
||
QUEM (executor)?
|
||
> claude (staff_id 25)
|
||
|
||
QUANDO (inicio/fim)?
|
||
> Auto-detectado: 16:00 - 16:45 (45 min)
|
||
|
||
ONDE (ficheiro/sistema)?
|
||
> ~/.claude/plugins/.../gestao/skills/qw/
|
||
|
||
POR QUÊ (objectivo)?
|
||
> Complemento leve ao /worklog para sesões curtas
|
||
|
||
COMO (método)?
|
||
> Criação skill (SKILL.md + README + prompts)
|
||
|
||
CUSTO (estimado vs real)?
|
||
> Estimado: 30 min, Real: 45 min
|
||
```
|
||
|
||
**Output:**
|
||
|
||
```markdown
|
||
# 5W2H Report — Criar skill /qw
|
||
|
||
| Campo | Resposta |
|
||
|-------|----------|
|
||
| QUÊ | Skill /qw para recapitulação rápida |
|
||
| QUEM | claude (staff_id 25) |
|
||
| QUANDO | 2026-07-02 16:00–16:45 (45 min) |
|
||
| ONDE | ~/.claude/plugins/.../gestao/skills/qw/ |
|
||
| POR QUÊ | Complemento /worklog para sesões curtas |
|
||
| COMO | Criação skill (SKILL.md + README + prompts) |
|
||
| CUSTO | Est: 30 min → Real: 45 min (+50% desvio) |
|
||
|
||
## PDCA
|
||
|
||
### PLAN
|
||
- Objectivo: Skill recapitulação rápida
|
||
- Criteria: <2 min execução, mem0 integrado, docs actualizados
|
||
- Scope: SKILL.md, README, 2 prompts
|
||
|
||
### DO
|
||
- Criado SKILL.md com protocolo (v1.0)
|
||
- Criado README.md com guia + exemplos
|
||
- Criado prompts/base.md e examples.md (6 exemplos)
|
||
- Plugin gestao actualizado (v1.5.0)
|
||
- Desvio: Tempo +50% (escopo expandiu com docs extras)
|
||
|
||
### CHECK
|
||
- ✅ SKILL.md conforme template
|
||
- ✅ README com 3 flags
|
||
- ✅ Prompts documentados
|
||
- ✅ Plugin integrado
|
||
- ⚠️ Teste /qw ainda pendente (não validado)
|
||
|
||
### ACT
|
||
- Próximo: Teste manual /qw
|
||
- Validar mem0 entries
|
||
- Considerar symlink OpenCode
|
||
- Documentar tempo real em CHANGELOG
|
||
|
||
---
|
||
|
||
## MEM0
|
||
|
||
ID: mem0_xyz123
|
||
Entry: "Skill /qw criada | propósito | recapitulação rápida sesões"
|
||
Tags: skill, gestao, mem0, recapitulacao
|
||
Tier: global
|
||
|
||
---
|
||
|
||
## DOCS UPDATED
|
||
|
||
✅ plugin.json (v1.4.0 → 1.5.0)
|
||
✅ CHANGELOG.md (entrada [1.5.0])
|
||
✅ SKILL.md criado
|
||
✅ README.md criado
|
||
|
||
---
|
||
|
||
⏱️ Report duração: 2 min 15s | Estado: COMPLETO
|
||
```
|
||
|
||
---
|
||
|
||
## Flags
|
||
|
||
### `--quick`
|
||
Apenas 3 campos obrigatórios:
|
||
```
|
||
QUÊ (deliverable)?
|
||
COMO (método)?
|
||
RESULTADO (sucesso)?
|
||
```
|
||
|
||
### `--auto`
|
||
Auto-detecta contexto:
|
||
- Git: commits, ficheiros alterados
|
||
- Desk: task_id, tempo loggado
|
||
- .desk-project: extrai dados
|
||
- Timestamp: agora vs. timer activo
|
||
|
||
---
|
||
|
||
## Integração CARL
|
||
|
||
Domínio: **TASK-COMPLETION-REPORT**
|
||
Triggers: "concluído", "finalizado", "pronto", "terminado", "etapa completa"
|
||
Auto-disparo: Sem confirmação (injecção automática)
|
||
Output: Desk #33 ou mem0 conforme contexto
|
||
|
||
---
|
||
|
||
## Estrutura 5W2H Obrigatória
|
||
|
||
| Sigla | Campo | Obrigatório | Max |
|
||
|-------|-------|-------------|-----|
|
||
| W | QUÊ (What) | Sim | 120 chars |
|
||
| W | QUEM (Who) | Sim | 50 chars |
|
||
| W | QUANDO (When) | Sim | timestamp |
|
||
| W | ONDE (Where) | Sim | path/sistema |
|
||
| W | POR QUÊ (Why) | Sim | 100 chars |
|
||
| H | COMO (How) | Sim | 150 chars |
|
||
| H | CUSTO (How much) | Sim | tempo (min) |
|
||
|
||
---
|
||
|
||
## PDCA Obrigatória
|
||
|
||
| Fase | Campo | Detalhe |
|
||
|------|-------|---------|
|
||
| **P** | PLAN | Spec original, criteria, scope |
|
||
| **D** | DO | Passos, decisões, desvios |
|
||
| **C** | CHECK | Resultado vs criteria, gaps |
|
||
| **A** | ACT | Ajustes, próximas acções |
|
||
|
||
---
|
||
|
||
## Checklist Implementação
|
||
|
||
- [x] SKILL.md criada
|
||
- [ ] Skill registada em plugin.json
|
||
- [ ] CARL domínio TASK-COMPLETION-REPORT activado
|
||
- [ ] Teste manual: `/report`
|
||
- [ ] Teste flag: `--quick`
|
||
- [ ] Teste flag: `--auto`
|
||
- [ ] Validar Desk #33 entry
|
||
- [ ] Validar mem0 entry
|
||
|
||
---
|
||
|
||
**Versão:** 1.0 | **Data:** 2026-07-02 | **Plugin:** gestao | **Staff:** 25 (Claude)
|