Files
claude-plugins/gestao/skills/report-5w2h/README.md
T

3.6 KiB
Raw Blame History

/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

  1. PLAN — Spec original, criteria de sucesso, scope
  2. DO — Passos executados, decisões, desvios documentados
  3. CHECK — Resultado vs criteria, gaps, testes
  4. 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)