feat: adiciona 12 plugins Descomplicar ao marketplace

Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:41:24 +00:00
parent bcce928beb
commit 2cb3210962
209 changed files with 50869 additions and 0 deletions
--- a/gestao/skills/worklog/SKILL.md
+++ b/gestao/skills/worklog/SKILL.md
@@ -0,0 +1,338 @@
+---
+name: worklog
+description: >
+  Registo de trabalho + reflexão unificado v4.0. Analisa sessão, regista trabalho, identifica padrões, sugere acções.
+  /reflect é alias (mesmo resultado). Variantes: /reflect deep (análise profunda), /reflect week (revisão semanal).
+  Auto-trigger >10 tool calls. Auto-alerts degradação >15%, error rate >10%.
+  Use when "worklog", "reflect", "reflexão", "registar trabalho", "log", "análise", "melhoria", "insight", ao parar timer.
+author: Descomplicar® Crescimento Digital
+version: 4.0.0
+quality_score: 95
+user_invocable: true
+category: productivity
+tags: [log, trabalho, reflexao, auto-melhoria, produtividade, time-tracking, memory, pdca, alerts]
+desk_task: 1554
+desk_project: 65
+desk_discussion_logs: 31
+desk_discussion_reflexoes: 32
+desk_discussion_accoes: 33
+allowed-tools: Read, Write, Bash, mcp__desk-crm-v3, mcp__mcp-time, mcp__memory-supabase, mcp__ssh-unified
+mcps: desk-crm-v3, mcp-time, memory-supabase, ssh-unified
+dependencies:
+  skills: [sdk, metrics]
+  mcps: [desk-crm-v3, memory-supabase]
+auto_trigger:
+  enabled: true
+  threshold_tool_calls: 10
+  background: true
+  alerts:
+    - performance_degradation: 15
+    - error_rate: 10
+    - kb_offline: 3
+---
+
+# /worklog v4.0 - Registo de Trabalho + Reflexão
+
+Skill unificada: regista trabalho, analisa sessão, sugere acções, guarda memória.
+
+**`/reflect` = alias de `/worklog`** (mesmo resultado).
+
+---
+
+## Comandos
+
+| Comando | Função |
+|---------|--------|
+| `/worklog` | Registo + reflexão da sessão |
+| `/reflect` | Alias de `/worklog` |
+| `/worklog view` | Ver últimos registos |
+| `/reflect deep` | Análise profunda com histórico |
+| `/reflect week` | Revisão semanal (segundas via /today) |
+
+---
+
+## Storage
+
+| Tipo | Discussão | ID |
+|------|-----------|-----|
+| **Logs + Reflexões** | Logs | 31 |
+| **Reflexões Profundas** | Reflexões | 32 |
+| **Acções** | Acções de Melhoria | 33 |
+
+**Projecto:** #65 (DES Stack Workflow) | **Staff:** 25 (AikTop)
+
+---
+
+## Protocolo Principal (/worklog e /reflect)
+
+```
+1. Obter hora via mcp__mcp-time__current_time
+2. Verificar timer activo em ~/.claude-work/active-timer.json
+3. ANALISAR sessão:
+   - Ficheiros modificados (Edit/Write calls)
+   - MCPs usados
+   - Erros e soluções
+   - Padrões detectados
+   - Eficiência (tool calls vs resultado)
+4. VERIFICAR se há algo novo a documentar
+   - Se sessão vazia/sem dados → NÃO gerar
+5. Gerar comentário HTML (ver formato abaixo)
+6. mcp__desk-crm-v3__add_discussion_comment({
+     discussion_id: 31,
+     content: html,
+     staff_id: 25
+   })
+7. SE acções sugeridas:
+   mcp__desk-crm-v3__add_discussion_comment({
+     discussion_id: 33,
+     content: accoes_html,
+     staff_id: 25
+   })
+8. SE insight valioso → save_memory Supabase
+9. Confirmar
+```
+
+**Output:**
+
+```markdown
+Worklog registado!
+
+Tarefa: #1446 - Documentação Skills
+Duração: 2h 15m
+Discussão: #31 (Logs)
+Acções: 2 sugeridas (#33)
+Memória: Guardada / N/A
+```
+
+---
+
+## Formato Comentário HTML (Discussão #31)
+
+```html
+<h4>YYYY-MM-DD HH:MM - Título da Sessão</h4>
+
+<p><strong>Projecto:</strong> Nome</p>
+<p><strong>Tarefa:</strong> #ID - Nome</p>
+<p><strong>Duração:</strong> ~XXh YYm</p>
+<p><strong>Resultado:</strong> Concluído | Parcial | Bloqueado</p>
+
+<h4>Trabalho Realizado</h4>
+<ul>
+  <li>Acção 1</li>
+  <li>Acção 2</li>
+</ul>
+
+<h4>Ficheiros Modificados</h4>
+<ul>
+  <li><code>path/file.ext</code> - descrição</li>
+</ul>
+
+<h4>Problemas / Soluções</h4>
+<ul>
+  <li><strong>Problema:</strong> Descrição
+      <br><strong>Solução:</strong> Como foi resolvido</li>
+</ul>
+
+<h4>Padrões Detectados</h4>
+<ul>
+  <li>Padrão identificado e impacto</li>
+</ul>
+
+<h4>Acções Sugeridas</h4>
+<p><em>Detalhes na discussão #33</em></p>
+<ul>
+  <li>[Tipo] Descrição breve</li>
+</ul>
+
+<h4>Próximos Passos</h4>
+<ol>
+  <li>Tarefa pendente 1</li>
+</ol>
+```
+
+---
+
+## Formato Acções (Discussão #33)
+
+Cada acção num comentário separado:
+
+```html
+<p>- [ ] [Tipo] Descrição da acção</p>
+<p><strong>Origem:</strong> Worklog YYYY-MM-DD HH:MM</p>
+<p><strong>Prioridade:</strong> P1/P2/P3</p>
+<p><strong>Contexto:</strong> Breve explicação</p>
+```
+
+**Tipos:** `[CLAUDE.md]`, `[Skill]`, `[MCP]`, `[Workflow]`, `[Bug]`, `[Feature]`
+
+---
+
+## /worklog view
+
+```
+1. mcp__desk-crm-v3__get_project_discussions({ project_id: 65 })
+2. Filtrar discussão #31
+3. Mostrar últimos 5 comentários
+```
+
+---
+
+## /reflect deep (Análise Profunda)
+
+Análise mais detalhada que o worklog normal. Publica em discussão **#32** (Reflexões).
+
+```
+1. Ler comentários recentes de #31 (worklogs) e #32 (reflexões)
+2. Analisar padrões repetidos
+3. Comparar eficiência com sessões anteriores
+4. Verificar TaskForces utilizadas (ver Integração TaskForce)
+5. Gerar comentário detalhado em #32
+6. Acções em #33
+7. Memória Supabase
+```
+
+---
+
+## /reflect week (Revisão Semanal)
+
+Chamado automaticamente pelo `/today` às segundas-feiras. Publica em **#32**.
+
+```
+1. Ler comentários de #31 e #32 da semana
+2. Agregar padrões e métricas
+3. Gerar resumo semanal
+4. Identificar melhorias prioritárias
+```
+
+**Formato:**
+
+```html
+<h4>Semana YYYY-WNN - Revisão</h4>
+
+<h4>Métricas</h4>
+<table>
+  <tr><td>Sessões registadas</td><td>N</td></tr>
+  <tr><td>Reflexões geradas</td><td>M</td></tr>
+  <tr><td>Padrões detectados</td><td>P</td></tr>
+</table>
+
+<h4>Padrões Frequentes</h4>
+<ol><li>Padrão A - Nx detectado</li></ol>
+
+<h4>Melhorias Prioritárias</h4>
+<ul>
+  <li>[ ] [P1] Descrição</li>
+  <li>[ ] [P2] Descrição</li>
+</ul>
+
+<h4>Plano Esta Semana</h4>
+<ul>
+  <li>Implementar: X</li>
+  <li>Monitorar: Y</li>
+</ul>
+```
+
+---
+
+## Integração /time
+
+Quando `/time stop` é executado:
+
+```
+1. Timer parado
+2. Mostrar resumo (tarefa, duração)
+3. Perguntar: "Criar worklog? [Sim/Não]"
+4. Se sim → Gerar worklog com contexto do timer
+```
+
+---
+
+## Auto-Save Memória
+
+| Tipo | Exemplo | Guardar? |
+|------|---------|----------|
+| Solução técnica nova | Fix para erro MCP | Sim |
+| Configuração sistema | Novo MCP configurado | Sim |
+| Workaround descoberto | Bypass para bug | Sim |
+| Padrão novo | "X funciona melhor que Y" | Sim |
+| Decisão arquitectural | Escolha de abordagem | Sim |
+| Trabalho rotineiro | Updates, limpeza | Não |
+
+---
+
+## Checklist de Reflexão
+
+Perguntas ao analisar sessão:
+
+- O sistema respondeu bem aos pedidos?
+- Houve confusão ou mal-entendidos?
+- Alguma tarefa repetitiva deveria ser skill?
+- Faltou informação que deveria estar em memória?
+- Alguma regra CLAUDE.md foi violada?
+- Os MCPs funcionaram correctamente?
+- Algum TaskForce foi utilizado? Registar métricas.
+
+---
+
+## Auto-Alerts Data-Driven
+
+| Alerta | Threshold | Acção |
+|--------|-----------|-------|
+| Degradação performance | >15% vs baseline (7d) | Investigar causa |
+| Error rate alto | >10% (30d) | Analisar erros |
+| KB offline | 3 timeouts | Verificar MCP |
+
+**Formato alerta:** Inclui componente, tipo, threshold, valor actual, investigação e acções sugeridas.
+
+---
+
+## Integração TaskForce (para /reflect deep)
+
+```
+1. LER ~/.claude/sdks/_registry.json
+2. COMPARAR com skills/agents usados na sessão
+3. SE match: adicionar secção "SDKs Utilizados" com tempo e baseline
+```
+
+---
+
+## Auto-Trigger
+
+| Trigger | Acção |
+|---------|-------|
+| >10 tool calls | Gerar worklog background |
+| Parar timer | Oferecer criar worklog |
+| Mudança de projecto | Fechar sessão anterior |
+| Mesmo erro 2+ vezes | Analisar causa |
+| Segunda-feira via /today | Revisão semanal |
+
+---
+
+## Anti-Patterns
+
+- **NUNCA** criar worklog sem dados de sessão
+- **NUNCA** usar Markdown em comentários (usar HTML)
+- **NUNCA** guardar memória para trabalho rotineiro
+- **NUNCA** duplicar reflexão e worklog (são o mesmo)
+
+---
+
+## Changelog
+
+### v4.0.0 (2026-02-06)
+- Fusão de /worklog e /reflect numa skill unificada
+- /reflect torna-se alias de /worklog
+- Discussão #31 recebe tudo (worklog + reflexão)
+- Discussão #32 reservada para /reflect deep e /reflect week
+- Checklist de reflexão integrado
+- Auto-alerts data-driven integrados
+- Integração TaskForce mantida para /reflect deep
+
+### v3.0.0 (2026-02-05)
+- Integração completa com /time
+- Auto-trigger ao parar timer
+- Formato HTML alinhado com Regra #27
+
+---
+
+*Skill v4.0.0 | 2026-02-06 | Descomplicar(R)*
--- a/gestao/skills/worklog/prompts/background-agent.md
+++ b/gestao/skills/worklog/prompts/background-agent.md
@@ -0,0 +1,41 @@
+# Worklog Background Agent Prompt
+
+Prompt optimizado para contexto mínimo (funciona com sonnet em background).
+
+---
+
+## Prompt Padrão (CURTO)
+
+```
+Gera worklog no Desk CRM (discussão Logs do projecto).
+
+1. Identifica projecto via .desk-project ou usa #65 (Stack)
+2. Usa mcp__desk-crm-v3__add_discussion_comment
+3. Resume trabalho em 3-5 bullets
+
+Formato: ## HH:MM - [Titulo] + bullets + ficheiros
+```
+
+---
+
+## Invocação via Task Tool
+
+```javascript
+Task({
+  subagent_type: "general-purpose",
+  model: "sonnet",  // IMPORTANTE: não usar haiku (limite contexto)
+  description: "Generate worklog entry",
+  run_in_background: true,
+  prompt: "Gera worklog no Desk CRM. Identifica projecto via .desk-project ou usa #65. Adiciona comentário na discussão Logs via mcp__desk-crm-v3__add_discussion_comment."
+})
+```
+
+---
+
+## Notas de Optimização
+
+- **Usar sonnet** (não haiku) - haiku falha com "prompt too long" em sessões longas
+- **Desk CRM** - adicionar comentário via mcp__desk-crm-v3__add_discussion_comment
+- **Projecto default:** #65 (Stack Descomplicar)
+- **Background** - sempre run_in_background=true
+```