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,136 @@
|
||||
# /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)
|
||||
@@ -0,0 +1,236 @@
|
||||
---
|
||||
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)
|
||||
Reference in New Issue
Block a user