feat: sync all plugins, skills, agents updates
New plugins: core-tools New skills: auto-expense, ticket-triage, design, security-check, aiktop-tasks, daily-digest, imap-triage, index-update, mindmap, notebooklm, proc-creator, tasks-overview, validate-component, perfex-module, report, calendar-manager New agents: design-critic, design-generator, design-lead, design-prompt-architect, design-researcher, compliance-auditor, metabase-analyst, gitea-integration-specialist Updated: all plugin configs, knowledge datasets, existing skills Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
365
gestao/skills/proc-creator/SKILL.md
Normal file
365
gestao/skills/proc-creator/SKILL.md
Normal file
@@ -0,0 +1,365 @@
|
||||
---
|
||||
name: proc-creator
|
||||
description: Cria procedimentos seguindo formato Hub Descomplicar. Use quando "criar procedimento", "novo PROC", "documentar processo", "PROC-*". Gera código automático [DEPT]-[TEMA]-[NUM], cria ficheiro na pasta departamental correcta, actualiza INDEX.md.
|
||||
---
|
||||
|
||||
# /proc-creator - Criador de Procedimentos Hub
|
||||
|
||||
Cria procedimentos estruturados seguindo formato e organização Hub Descomplicar.
|
||||
|
||||
---
|
||||
|
||||
## Referências e Documentação
|
||||
|
||||
**SEMPRE consultar:**
|
||||
- **[06-Operacoes/Procedimentos/INDEX.md](file:///media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/INDEX.md)** - Estrutura completa (36 procedimentos, 8 departamentos)
|
||||
- **[Hub CLAUDE.md](file:///media/ealmeida/Dados/Hub/CLAUDE.md)** - Secção "Organização de Procedimentos" (convenções, padrão referenciação)
|
||||
|
||||
---
|
||||
|
||||
## Estrutura de Procedimentos
|
||||
|
||||
### 8 Departamentos
|
||||
|
||||
| Departamento | Pasta | Código | Procedimentos Actuais |
|
||||
|--------------|-------|--------|----------------------|
|
||||
| D1-Comercial | `D1-Comercial/` | CRM | 1 |
|
||||
| D2-Suporte | `D2-Suporte/` | SUP | 0 (gap) |
|
||||
| D3-Contabilidade | `D3-Contabilidade/` | FIN | 2 |
|
||||
| D4-RH | `D4-RH/` | HR | 0 (novo) |
|
||||
| D5-Design | `D5-Design/` | DES | 0 (gap) |
|
||||
| D6-Marketing | `D6-Marketing/` | MKT | 1 |
|
||||
| D7-Tecnologia | `D7-Tecnologia/` | DEV, WP, INF, AI, WEB | 28 |
|
||||
| Cross-Departamental | `Cross-Departamental/` | XDP | 4 |
|
||||
|
||||
**Base path:** `/media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/`
|
||||
|
||||
---
|
||||
|
||||
## Convenção de Código
|
||||
|
||||
Formato: `[DEPT]-[TEMA]-[NUM]`
|
||||
|
||||
**Exemplos:**
|
||||
- D7: `DEV-MCP-001`, `WP-SEC-001`, `INF-SSL-001`, `AI-PLG-001`, `WEB-SEO-001`
|
||||
- D1: `CRM-OPS-001`
|
||||
- D3: `FIN-MOL-001`, `FIN-DSP-001`
|
||||
- D6: `MKT-CNT-001`
|
||||
- Cross: `XDP-GPR-001`, `XDP-OBS-001`
|
||||
|
||||
**Números:** Sequencial por tema (001, 002, 003...)
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Criação
|
||||
|
||||
```
|
||||
1. PERGUNTAR ao utilizador:
|
||||
- Título do procedimento
|
||||
- Departamento (D1-D7 ou Cross)
|
||||
- Tema/categoria
|
||||
- Descrição breve
|
||||
|
||||
2. DETERMINAR código:
|
||||
- Ler INDEX.md do departamento
|
||||
- Identificar próximo NUM disponível para o tema
|
||||
- Gerar código [DEPT]-[TEMA]-[NUM]
|
||||
|
||||
3. CRIAR ficheiro PROC-*.md:
|
||||
- Nome: PROC-[Titulo].md
|
||||
- Localização: /media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/[Departamento]/
|
||||
- Usar template abaixo
|
||||
|
||||
4. ACTUALIZAR INDEX.md:
|
||||
- Adicionar linha na tabela do departamento
|
||||
- Incrementar contador total
|
||||
- Actualizar data
|
||||
|
||||
5. CONFIRMAR:
|
||||
- Mostrar path completo do ficheiro criado
|
||||
- Mostrar código atribuído
|
||||
- Listar próximos passos (preencher conteúdo)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Template PROC-*.md
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: [Título do Procedimento]
|
||||
date: YYYY-MM-DD
|
||||
type: procedimento
|
||||
status: draft
|
||||
dept_id: [N]
|
||||
desk_dept_id: [N]
|
||||
desk_dept_name: [Nome Departamento]
|
||||
codigo: [DEPT]-[TEMA]-[NUM]
|
||||
tags: [tag1, tag2, tag3]
|
||||
---
|
||||
|
||||
# [Título do Procedimento]
|
||||
|
||||
**Código:** [DEPT]-[TEMA]-[NUM] | **Departamento:** [Nome] | **Status:** Draft
|
||||
|
||||
---
|
||||
|
||||
## 📋 Contexto
|
||||
|
||||
Descrição clara do propósito e âmbito deste procedimento.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Objectivo
|
||||
|
||||
O que este procedimento pretende alcançar.
|
||||
|
||||
---
|
||||
|
||||
## 📍 Âmbito
|
||||
|
||||
### Aplica-se a:
|
||||
- [ ] Item 1
|
||||
- [ ] Item 2
|
||||
|
||||
### Não se aplica a:
|
||||
- [ ] Item 1
|
||||
- [ ] Item 2
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Pré-requisitos
|
||||
|
||||
| Requisito | Descrição |
|
||||
|-----------|-----------|
|
||||
| [Nome] | [Detalhe] |
|
||||
|
||||
---
|
||||
|
||||
## 📝 Procedimento
|
||||
|
||||
### Passo 1: [Nome do Passo]
|
||||
|
||||
**Objectivo:** [O quê]
|
||||
**Como:**
|
||||
1. Acção 1
|
||||
2. Acção 2
|
||||
|
||||
**Validação:** Como confirmar sucesso
|
||||
|
||||
### Passo 2: [Nome do Passo]
|
||||
|
||||
[...]
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist de Execução
|
||||
|
||||
- [ ] Pré-requisito A verificado
|
||||
- [ ] Passo 1 concluído
|
||||
- [ ] Passo 2 concluído
|
||||
- [ ] Validação final OK
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Troubleshooting
|
||||
|
||||
| Problema | Causa Provável | Solução |
|
||||
|----------|----------------|---------|
|
||||
| [Erro X] | [Causa] | [Como resolver] |
|
||||
|
||||
---
|
||||
|
||||
## 📊 Métricas e KPIs
|
||||
|
||||
| Métrica | Target | Como Medir |
|
||||
|---------|--------|------------|
|
||||
| [Nome] | [Valor] | [Método] |
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Referências
|
||||
|
||||
**Procedimentos relacionados:**
|
||||
- [PROC-Outro.md](../PROC-Outro.md)
|
||||
|
||||
**Skills relacionadas:**
|
||||
- `/skill-name` - Descrição
|
||||
|
||||
**Documentação externa:**
|
||||
- [Nome](URL)
|
||||
|
||||
---
|
||||
|
||||
## 📅 Histórico de Revisões
|
||||
|
||||
| Data | Versão | Autor | Alterações |
|
||||
|------|--------|-------|------------|
|
||||
| YYYY-MM-DD | 1.0 | [Nome] | Criação inicial |
|
||||
|
||||
---
|
||||
|
||||
**[Título] | Código: [DEPT]-[TEMA]-[NUM] | Departamento: [Nome]**
|
||||
**Última actualização:** YYYY-MM-DD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Frontmatter Obrigatório
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: [Título Procedimento]
|
||||
date: YYYY-MM-DD
|
||||
type: procedimento
|
||||
status: draft | active | archived
|
||||
dept_id: [1-7]
|
||||
desk_dept_id: [1-7]
|
||||
desk_dept_name: [D1-Comercial | D2-Suporte | ...]
|
||||
codigo: [DEPT]-[TEMA]-[NUM]
|
||||
tags: [categoria, tema, tecnologia]
|
||||
---
|
||||
```
|
||||
|
||||
**Mapeamento dept_id:**
|
||||
- 1 = D1-Comercial (info@descomplicar.pt)
|
||||
- 2 = D2-Suporte (suporte@descomplicar.pt)
|
||||
- 3 = D3-Contabilidade (contabilidade@descomplicar.pt)
|
||||
- 4 = D4-RH (rh@descomplicar.pt)
|
||||
- 5 = D5-Design (design@descomplicar.pt)
|
||||
- 6 = D6-Marketing (marketing@descomplicar.pt)
|
||||
- 7 = D7-Tecnologia (dev@descomplicar.pt)
|
||||
|
||||
---
|
||||
|
||||
## Actualização INDEX.md
|
||||
|
||||
Adicionar linha na tabela do departamento:
|
||||
|
||||
```markdown
|
||||
| [PROC-Titulo.md](./PROC-Titulo.md) | [Descrição breve] | [DEPT]-[TEMA]-[NUM] |
|
||||
```
|
||||
|
||||
Actualizar estatísticas:
|
||||
- Incrementar contador "X procedimentos"
|
||||
- Actualizar data "Última actualização: YYYY-MM-DD"
|
||||
|
||||
---
|
||||
|
||||
## Integração com Skills/Agents
|
||||
|
||||
Após criar procedimento, informar utilizador:
|
||||
|
||||
```markdown
|
||||
**Próximos passos:**
|
||||
|
||||
1. Preencher conteúdo do procedimento
|
||||
2. Testar procedimento em cenário real
|
||||
3. Actualizar status: draft → active
|
||||
4. Adicionar referências em skills/agents relevantes:
|
||||
|
||||
\`\`\`markdown
|
||||
## Referências e Documentação
|
||||
|
||||
**SEMPRE consultar:**
|
||||
- [PROC-Titulo.md](file:///media/ealmeida/Dados/Hub/06-Operacoes/Procedimentos/[Dept]/PROC-Titulo.md)
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### Exemplo 1: Procedimento Técnico D7
|
||||
|
||||
```
|
||||
User: Criar procedimento para deployment EasyPanel
|
||||
Assistant: /proc-creator
|
||||
|
||||
Título: Deployment EasyPanel via API
|
||||
Departamento: D7-Tecnologia
|
||||
Tema: Infraestrutura (INF)
|
||||
Descrição: Deploy automatizado de serviços no EasyPanel usando API oficial
|
||||
|
||||
→ Código gerado: INF-EPL-001
|
||||
→ Ficheiro: PROC-Deployment-EasyPanel.md
|
||||
→ Localização: D7-Tecnologia/
|
||||
→ INDEX.md actualizado
|
||||
```
|
||||
|
||||
### Exemplo 2: Procedimento Cross-Departamental
|
||||
|
||||
```
|
||||
User: Documentar processo de gestão de projectos
|
||||
Assistant: /proc-creator
|
||||
|
||||
Título: Sistema Gestão Projectos
|
||||
Departamento: Cross-Departamental
|
||||
Tema: Gestão Projectos (GPR)
|
||||
Descrição: Metodologia híbrida Ágil/Waterfall
|
||||
|
||||
→ Código gerado: XDP-GPR-002 (já existe 001)
|
||||
→ Ficheiro: Sistema-Gestao-Projectos-v2.md
|
||||
→ Localização: Cross-Departamental/
|
||||
→ INDEX.md actualizado
|
||||
```
|
||||
|
||||
### Exemplo 3: Procedimento D2-Suporte (Gap)
|
||||
|
||||
```
|
||||
User: Criar procedimento atendimento cliente
|
||||
Assistant: /proc-creator
|
||||
|
||||
Título: Atendimento Cliente
|
||||
Departamento: D2-Suporte
|
||||
Tema: Suporte (SUP)
|
||||
Descrição: Workflow primeiro contacto, templates resposta, escalação
|
||||
|
||||
→ Código gerado: SUP-ATC-001 (primeiro do D2!)
|
||||
→ Ficheiro: PROC-Atendimento-Cliente.md
|
||||
→ Localização: D2-Suporte/
|
||||
→ INDEX.md actualizado
|
||||
→ NOTA: D2 tinha 0 procedimentos, agora tem 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Anti-Patterns
|
||||
|
||||
**NUNCA:**
|
||||
- ❌ Criar procedimento sem perguntar departamento
|
||||
- ❌ Inventar código sem verificar INDEX.md
|
||||
- ❌ Esquecer de actualizar INDEX.md
|
||||
- ❌ Usar status "active" para draft inicial
|
||||
- ❌ Omitir frontmatter obrigatório
|
||||
- ❌ Criar em localização errada
|
||||
- ❌ Duplicar NUM existente no mesmo tema
|
||||
|
||||
**SEMPRE:**
|
||||
- ✅ Confirmar departamento com utilizador
|
||||
- ✅ Ler INDEX.md para próximo NUM
|
||||
- ✅ Actualizar INDEX.md após criação
|
||||
- ✅ Usar status "draft" inicialmente
|
||||
- ✅ Incluir todo frontmatter obrigatório
|
||||
- ✅ Criar em pasta departamental correcta
|
||||
- ✅ Verificar tema antes de atribuir NUM
|
||||
|
||||
---
|
||||
|
||||
## Validação Pós-Criação
|
||||
|
||||
Checklist automática:
|
||||
|
||||
```
|
||||
✅ Ficheiro criado em pasta correcta
|
||||
✅ Frontmatter completo e válido
|
||||
✅ Código único e sequencial
|
||||
✅ INDEX.md actualizado
|
||||
✅ Template aplicado
|
||||
✅ Path absoluto correcto
|
||||
✅ Data actual em YYYY-MM-DD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*Skill v1.0.0 | 2026-02-13 | Plugin gestao | Descomplicar®*
|
||||
Reference in New Issue
Block a user