3.6 KiB
3.6 KiB
/report — 5W2H + PDCA Report
Estrutura formal de conclusão de tarefas/etapas com análise 5W2H + PDCA.
Uso Rápido
/report # Report completo (interactivo)
/report --quick # Versão resumida (3 campos)
/report --auto # Auto-detectado de contexto
O Que Faz
| Função | Tempo | Output |
|---|---|---|
| 5W2H | <2 min | Tabela QUÊ/QUEM/QUANDO/ONDE/POR QUÊ/COMO/CUSTO |
| PDCA | <2 min | Ciclo Plan/Do/Check/Act |
| Docs | <1 min | README, CHANGELOG, PROC se relevante |
| Memória | <1 min | Entry mem0 Wayland v2 |
| Desk | <1 min | Comment em discussão #33 se .desk-project |
Exemplo
/report
Output:
# 5W2H Report — Criar skill /qw
| Campo | Resposta |
|-------|----------|
| QUÊ | Skill /qw para recapitulação rápida sesões |
| 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 de sesões curtas
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)
### CHECK
✅ SKILL.md conforme template
✅ README com 3 flags
✅ Prompts documentados
✅ Plugin integrado
⚠️ Teste /qw ainda pendente
### ACT
Próximo: Teste manual /qw
Validar mem0 entries criadas
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])
---
⏱️ Report: 2 min 15s | COMPLETO
Integração CARL
Domínio: TASK-COMPLETION-REPORT
Triggers: "concluído", "finalizado", "pronto", "terminado", "etapa completa"
Auto-disparo: Sim (sem confirmação necessária)
Estrutura 5W2H
| Campo | Descrição | Exemplo |
|---|---|---|
| QUÊ | Deliverable/resultado | "Skill /qw criada" |
| QUEM | Executor (staff_id) | "claude (25)" |
| QUANDO | Timestamp início-fim | "16:00–16:45 (45 min)" |
| ONDE | Ficheiro/pasta/sistema | "~/.claude/plugins/.../gestao/" |
| POR QUÊ | Objectivo/motivação | "Complemento /worklog para sesões curtas" |
| COMO | Método/processo | "Criação skill com SKILL.md + README + prompts" |
| CUSTO | Tempo estimado vs real | "Est: 30 min → Real: 45 min (+50%)" |
Ciclo PDCA
- PLAN — Spec original, criteria de sucesso, scope
- DO — Passos executados, decisões, desvios documentados
- CHECK — Resultado vs criteria, gaps, testes
- ACT — Ajustes necessários, próximas acções, melhorias
Flags
--quick
Report resumido — apenas 3 campos (QUÊ, COMO, RESULTADO).
--auto
Auto-detecta contexto:
- Git: commits e ficheiros alterados
- Desk: task_id e tempo loggado
- .desk-project: extrai dados de projecto
- Timer activo: usa duração real
Output
- Resumo visual: Tabela 5W2H
- Análise: PDCA em markdown
- Docs: README/CHANGELOG/PROC actualizados
- Memória: Entry mem0 Wayland v2 criada
- Desk: Comment em #33 (se .desk-project)
Versão: 1.0 | Data: 2026-07-02 | Autor: Claude (staff_id 25)