Files

Emanuel Almeida 6b3a6f2698 feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-12 15:05:03 +00:00

5.2 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
time	Gestão de tempo integrada com Desk CRM. Alertas >4h, total semanal, integração worklog. Usar quando "time", "timer", "horas", "timesheet", "start", "stop", "tempo".	true

/time v2.0 - Gestão de Tempo

Timer integrado com Desk CRM. Alertas inteligentes, resumo semanal.

Novidades v2.0

Alerta >4h: Perguntar se timer ainda activo
Total semana: Mostrar horas Seg-Dom no status
Link worklog: Oferecer criar worklog ao parar
Verificação: Comparar estado local vs Desk

Comandos

Comando	Função
`/time`	Ver status (timer + semana)
`/time start <task_id>`	Iniciar timer
`/time stop`	Parar timer actual
`/time switch <task_id>`	Trocar para outra tarefa
`/time log <hours> <task_id>`	Entrada manual

Protocolo

/time (Status)

1. Obter hora actual via mcp__mcp-time__current_time
2. Ler ~/.claude-work/active-timer.json
3. Se timer activo:
   a. Calcular duração
   b. SE >4h: Mostrar alerta "Timer activo há Xh. Ainda a trabalhar?"
4. Obter timesheets da semana:
   mcp__desk-crm-v3__get_timesheets_advanced({
     staff_id: 1,
     start_date: segunda_da_semana,
     end_date: domingo_da_semana
   })
5. Mostrar resumo

Output:

## ⏱️ Timer Activo
🟢 #1446 - Documentação Skills
   Projecto: Stack Workflow (#65)
   Iniciado: 14:30 (há 2h 15m)

## 📊 Esta Semana (03-09 Fev)
| Dia | Horas |
|-----|-------|
| Seg | 6h 30m |
| Ter | 7h 15m |
| Qua | 4h 45m ← Hoje |
| **Total** | **18h 30m** |

Se timer >4h:

⚠️ Timer activo há **5h 30m**

Ainda a trabalhar em #1446?
- [Sim, continuar]
- [Parar timer]
- [Ajustar tempo]

/time start <task_id>

1. Verificar se já existe timer activo
   - Se sim: "Já tens timer em #X. Parar primeiro?"
2. Obter detalhes da tarefa:
   mcp__desk-crm-v3__get_task({ task_id })
3. **VALIDAR WORKFLOW (obrigatório):**
   a. Verificar se tarefa está atribuída ao utilizador:
      - Verificar se staff_id: 1 está em task.assignees
      - Se NÃO: Erro "⚠️ Tarefa não atribuída a ti. Atribui primeiro."
   b. Verificar status da tarefa:
      - Status deve ser apropriado para timer (não "Não Iniciada")
      - Se status inadequado: Erro com instruções
   c. **Se validação falhar:**
      ```
      ⚠️ Para iniciar timer:
      1. Atribuir tarefa a ti (staff_id: 1)
      2. Mudar status para "Em progresso"
      3. Só depois iniciar timer

      Tarefas que precisam ser executadas:
      [Listar acções necessárias]
      ```
4. Iniciar timer no Desk:
   mcp__desk-crm-v3__start_timer({
     task_id: task_id,
     staff_id: 1,
     note: "Iniciado via Claude Code"
   })
5. Guardar estado local:
   ~/.claude-work/active-timer.json
6. Confirmar

Ficheiro estado:

{
  "task_id": 1446,
  "task_name": "Documentação Skills",
  "project_id": 65,
  "project_name": "Stack Workflow",
  "started_at": "2026-02-05T14:30:00Z",
  "staff_id": 1
}

/time stop

1. Ler estado local
2. SE vazio: "Sem timer activo"
3. Calcular duração
4. Parar timer no Desk:
   mcp__desk-crm-v3__stop_timer({
     task_id: task_id,
     staff_id: 1
   })
5. Limpar estado local
6. Perguntar: "Criar worklog? [Sim/Não]"
   - Se sim: Invocar /worklog com contexto
7. Confirmar

Output:

⏹️ Timer parado!

📋 Tarefa: #1446 - Documentação Skills
⏱️ Duração: 2h 15m
📁 Projecto: Stack Workflow

Criar worklog? [Sim] [Não]

/time switch <task_id>

1. Parar timer actual (silencioso, nota: "Switched")
2. Iniciar novo timer na tarefa indicada
3. Confirmar troca

/time log <task_id>

1. Validar formato horas (ex: "2h", "2.5", "2h30m")
2. Converter para decimal
3. Registar entrada manual:
   mcp__desk-crm-v3__add_timesheet_entry({
     task_id: task_id,
     staff_id: 1,
     hours: hours_decimal,
     note: "Entrada manual via Claude Code"
   })
4. Confirmar

Integração /today

O /today deve mostrar timer activo:

## ⏱️ Timer Activo
🟢 #1446 - Documentação (2h 15m)

Integração /worklog

Ao parar timer, oferecer criar worklog com contexto:

Tarefa trabalhada
Duração
Projecto

Constantes

const STAFF_ID = 1;  // Emanuel
const AIKTOP_ID = 25;  // Para comentários automáticos
const TIMER_STATE = "/home/ealmeida/.claude-work/active-timer.json";
const ALERT_HOURS = 4;  // Alertar após 4h

Anti-Patterns

NUNCA deixar timer overnight sem perguntar
NUNCA iniciar timer sem tarefa associada
NUNCA criar tarefa só para ter timer (usar tarefas existentes)
NUNCA iniciar timer sem validar workflow:
- Tarefa DEVE estar atribuída ao utilizador
- Status DEVE ser apropriado ("Em progresso", não "Não Iniciada")
- SEMPRE validar antes de start_timer

Changelog

v2.0.0 (2026-02-05)

Alerta se timer >4h
Mostrar total horas da semana no status
Integração com /worklog ao parar
Verificar estado Desk vs local
Semana: Seg-Dom

v1.1.0 (2026-02-03)

Workflows organizados
MCP Tools corrigidos

v1.0.0 (2026-01-27)

Versão inicial

Skill v2.0.0 | 2026-02-05 | Descomplicar®

5.2 KiB Raw Blame History