137 lines
3.6 KiB
Markdown
137 lines
3.6 KiB
Markdown
# /report — 5W2H + PDCA Report
|
||
|
||
Estrutura formal de conclusão de tarefas/etapas com análise 5W2H + PDCA.
|
||
|
||
## Uso Rápido
|
||
|
||
```bash
|
||
/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
|
||
|
||
```bash
|
||
/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)
|