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>
This commit is contained in:
173
gestao/skills/report-templates/references/client-update.md
Normal file
173
gestao/skills/report-templates/references/client-update.md
Normal file
@@ -0,0 +1,173 @@
|
||||
# Template: Update Mensal de Cliente
|
||||
|
||||
**Tipo:** Comunicacao periodica de progresso
|
||||
**Frequencia:** Mensal (ou quinzenal em projectos activos)
|
||||
**Tom:** Profissional, directo, orientado para dados
|
||||
**Extensao:** 1 pagina (equivalente)
|
||||
|
||||
---
|
||||
|
||||
## Estrutura do Template
|
||||
|
||||
### HTML (Desk CRM)
|
||||
|
||||
```html
|
||||
<h4>Update {{MES_ANO}} — {{NOME_PROJECTO}}</h4>
|
||||
|
||||
<p>Caro {{NOME_CLIENTE}},</p>
|
||||
<p>Segue o update de progresso referente a {{MES_ANO}}.</p>
|
||||
|
||||
<h4>Trabalho Concluido</h4>
|
||||
<ul>
|
||||
<li>{{TAREFA_1}}</li>
|
||||
<li>{{TAREFA_2}}</li>
|
||||
<li>{{TAREFA_3}}</li>
|
||||
</ul>
|
||||
|
||||
<h4>Metricas do Periodo</h4>
|
||||
<table>
|
||||
<tr>
|
||||
<th>Metrica</th>
|
||||
<th>Valor</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Horas dedicadas</td>
|
||||
<td>{{HORAS_TOTAL}}h</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Tarefas concluidas</td>
|
||||
<td>{{TAREFAS_CONCLUIDAS}}</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Progresso geral</td>
|
||||
<td>{{PROGRESSO_PERCENTAGEM}}%</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<h4>Em Curso</h4>
|
||||
<ul>
|
||||
<li>{{ITEM_EM_CURSO_1}}</li>
|
||||
<li>{{ITEM_EM_CURSO_2}}</li>
|
||||
</ul>
|
||||
|
||||
<h4>Proximos Passos</h4>
|
||||
<ul>
|
||||
<li>{{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}</li>
|
||||
<li>{{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}</li>
|
||||
</ul>
|
||||
|
||||
<p>Qualquer questao, estamos disponiveis.</p>
|
||||
|
||||
<hr>
|
||||
<p>
|
||||
<strong>Descomplicar®</strong> |
|
||||
<a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> |
|
||||
911 510 005
|
||||
</p>
|
||||
<p><em>Update gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}</em></p>
|
||||
```
|
||||
|
||||
### Markdown (Email / Hub)
|
||||
|
||||
```markdown
|
||||
**Update {{MES_ANO}} — {{NOME_PROJECTO}}**
|
||||
|
||||
Caro {{NOME_CLIENTE}},
|
||||
|
||||
Segue o update de progresso referente a {{MES_ANO}}.
|
||||
|
||||
---
|
||||
|
||||
**Trabalho Concluido**
|
||||
|
||||
- {{TAREFA_1}}
|
||||
- {{TAREFA_2}}
|
||||
- {{TAREFA_3}}
|
||||
|
||||
**Metricas do Periodo**
|
||||
|
||||
| Metrica | Valor |
|
||||
|---------|-------|
|
||||
| Horas dedicadas | {{HORAS_TOTAL}}h |
|
||||
| Tarefas concluidas | {{TAREFAS_CONCLUIDAS}} |
|
||||
| Progresso geral | {{PROGRESSO_PERCENTAGEM}}% |
|
||||
|
||||
**Em Curso**
|
||||
|
||||
- {{ITEM_EM_CURSO_1}}
|
||||
- {{ITEM_EM_CURSO_2}}
|
||||
|
||||
**Proximos Passos**
|
||||
|
||||
- {{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}
|
||||
- {{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}
|
||||
|
||||
Qualquer questao, estamos disponiveis.
|
||||
|
||||
---
|
||||
Descomplicar® | info@descomplicar.pt | 911 510 005
|
||||
*Update gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}*
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Placeholders — Mapeamento Desk CRM
|
||||
|
||||
| Placeholder | Fonte Desk CRM | MCP Call |
|
||||
|-------------|---------------|----------|
|
||||
| `{{NOME_PROJECTO}}` | `project.name` | `get_project` |
|
||||
| `{{NOME_CLIENTE}}` | `customer.firstname` | `search_customers` |
|
||||
| `{{MES_ANO}}` | Calculado | `mcp-time` |
|
||||
| `{{HORAS_TOTAL}}` | Timesheets do mes | `get_project_time_tracking` |
|
||||
| `{{TAREFAS_CONCLUIDAS}}` | Tasks status=completed | `get_tasks` |
|
||||
| `{{PROGRESSO_PERCENTAGEM}}` | `project.progress` | `get_project` |
|
||||
| `{{TAREFA_1..N}` | Tasks recentes concluidas | `get_tasks` |
|
||||
| `{{ITEM_EM_CURSO_1..N}` | Tasks status=in_progress | `get_tasks` |
|
||||
| `{{PROXIMO_PASSO_1..N}` | Tasks status=not_started, por data | `get_tasks` |
|
||||
| `{{DATA_1..N}` | `task.due_date` | `get_tasks` |
|
||||
| `{{DATA_HOJE}}` | Hoje | `mcp-time` |
|
||||
| `{{PROJECTO_ID}}` | `project.id` | `get_project` |
|
||||
|
||||
---
|
||||
|
||||
## Exemplo Preenchido
|
||||
|
||||
```
|
||||
Update Fevereiro 2026 — Portal SFV-360
|
||||
|
||||
Caro Paulo Silva,
|
||||
|
||||
Segue o update de progresso referente a Fevereiro 2026.
|
||||
|
||||
Trabalho Concluido:
|
||||
- Implementacao modulo de relatorios automaticos
|
||||
- Integracao API energia solar (3 inversores)
|
||||
- Correccao erro calculo producao acumulada
|
||||
|
||||
Metricas do Periodo:
|
||||
- Horas dedicadas: 38h
|
||||
- Tarefas concluidas: 8
|
||||
- Progresso geral: 72%
|
||||
|
||||
Em Curso:
|
||||
- Dashboard mobile (responsivo)
|
||||
- Testes de carga base de dados
|
||||
|
||||
Proximos Passos:
|
||||
- Entrega dashboard mobile — previsto para 15-03-2026
|
||||
- Formacao utilizadores — previsto para 20-03-2026
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Notas de Uso
|
||||
|
||||
- Incluir apenas tarefas relevantes para o cliente (excluir internas/tecnicas sem impacto visivel)
|
||||
- Se o progresso diminuiu ou estagnou, explicar o motivo de forma clara
|
||||
- Proximos passos devem ter sempre datas concretas
|
||||
- Maximo 5 items por seccao — sintese e preferida
|
||||
- Se existem bloqueadores que dependem do cliente, destacar em negrito
|
||||
|
||||
---
|
||||
|
||||
*Template v1.0.0 | 2026-03-10 | Descomplicar®*
|
||||
Reference in New Issue
Block a user