Axios V2 | Skills Plan

axios v2 skills

Plano de skills V2 — refinar as 3 skills atuais do projeto + criar 4 novas que vão dar ao Axios competência de domínio (Colliers/Costal) e capacidade de orquestrar reuniões e alertas.

Localização runtime: /root/.openclaw/workspace/skills/<skill-name>/SKILL.md (OpenClaw VPS). Espelho no vault: documentar cada skill aqui em agentes-core/axios/v2/skills/ para versionamento.


Skills atuais (V1) — refinar

1. google-workspace

Estado: funciona; foco em Drive / Gmail / Calendar.

Refinamento V2:

  • Adicionar capacidade de ler reuniões do Calendar com 4h de antecedência (suporta gatilho 1 do playbook — pré-reunião)
  • Adicionar capacidade de detectar mudança em arquivo Drive entre daily-drive-sync e agora (suporta detecção de novo material para recarregar Tier 1)
  • Adicionar capacidade de rodar OCR em PDFs (suporta extração pendente do visao-geral-colliers-construcao-ia.pdf — gap G-009)

Status: sem mudança estrutural; ampliar funções acima.

2. obsidian-vault-governance

Estado: ativa, mas precisa atualização pós-25/04 — vault mudou substancialmente.

Refinamento V2 — atualizações obrigatórias:

a) Documentos canônicos novos (que a skill precisa conhecer):

b) Reorganizações estruturais:

  • 04-referencia/ é por tema agora (não mais flat em pdfs/)
  • 05-arquitetura-empresarial/ é separada por frente (costal/ + colliers/)
  • 33 perfis em 00-projeto/directory/pessoas/ (era 12)

c) Convenções novas (incorporar):

  • Diagramas Mermaid: aspas em labels + sem N. no início (regra anti Unsupported markdown: list)
  • IDs de TASKS sequenciais persistentes acima do maior — nunca preencher gaps
  • Homônimos: sempre referir pelo sobrenome (Leandro Braga vs Delecrodio)

Ação: Pedro + Axios revisitam a skill na semana 1 da V2 (28/04 → 02/05) e atualizam o SKILL.md para refletir a realidade atual.

3. slack-signal-governance

Estado: ativa, mas o cron que a usa (slack-governance-monitor) está com erro.

Refinamento V2:

  • Aplicar correções do slack-governance-monitor (chunking, retry exponencial, filtro confiança ≥0.7)
  • Ampliar padrões de detecção:
    • Homônimo confundido ("Leandro" sem sobrenome)
    • Decisão sem registro (mensagem com “decidimos” sem reação 📌 nas próximas 24h)
    • Risco material (palavras-chave + contexto)
  • Versionar saída: cada sinal capturado deve ter ID estável para deduplicação

Skills novas — V2

4. costal-domain-knowledge (NOVO)

Por que: Axios precisa entender semanticamente o universo Costal — organograma, processos, agentes, governança. Sem isso, responde queries com fragmentos sem contextualizar.

Conteúdo (SKILL.md):

# costal-domain-knowledge
 
## Quando aplicar
Triggers:
- "costal", "construtora", "obra", "construção"
- Nomes do organograma Costal (Igor, Cristiane, Marcos, agentes)
- Termos do mapa de processos R01
 
## Conhecimento canônico
- Estrutura: Conselho (REB+BS) + MD Igor + 7 diretorias (PMO, Comercial, Engenharia de Projetos, Construção, Suprimentos, Administrativo, TI). 6 diretorias TBD.
- Característica única: 6 funções corporativas exercidas por pessoas Colliers (papel compartilhado).
- 26 agentes IA em 8 áreas, 3 ondas:
  - Onda 1: Atlas, Draft, Sentinel, Trace, Hunter
  - Onda 2: Hit, Visor, King, Source, Gate, Guardian
  - Onda 3: 15 restantes
- Sienge é coluna vertebral; Anouk é AI Driven (terceiro)
- 9 macroáreas de processo (R01)
- 15 DIRs + 75 POLs (governança corporativa R01)
 
## Documentos-fonte (carregar quando necessário)
[lista do Tier 2 da reading-list — seção Costal]
 
## Regras de uso
- Antes de afirmar fato sobre Costal, validar contra estrutura-costal.md
- Para perguntas sobre agentes específicos, ir para 02-costal/agentes/<area>/<agente>/
- Não inventar dados de obras concretas (Costal ainda não iniciou primeira obra)

5. colliers-domain-knowledge (NOVO)

Por que: Mesma lógica para Colliers (CIB/CTS/CREMS, 23 áreas, 33 perfis).

Conteúdo (SKILL.md):

# colliers-domain-knowledge
 
## Quando aplicar
Triggers:
- "colliers", "CIB", "CTS", "CREMS"
- Nomes do organograma Colliers (Ricardo, Lucas, Daniel Jackel, Gianlucca, etc.)
- Áreas (Office, Industrial, Inteligência de Mercado, Property, Facilities, etc.)
 
## Conhecimento canônico
- 3 divisões:
  - CIB: Transações (Office, Industrial, Capital Markets, Incorporação, Growth) + Corporativo (Financeiro, Gente, Jurídico, Marketing, Compras, TI)
  - CTS: Avaliações (CIVAS), Inteligência de Mercado, Projetos SPS (sob Igor)
  - CREMS: REMS, Property, Facilities, Lease Administration
- Sprint semana 2: Property + Facilities (prioridade Ricardo)
- Inteligência de Mercado em discovery (sessão 30/04 com Braga)
- 9 discovery preps prontos + 1 spec consolidada (IM v2)
- 21 iniciativas no backlog (re-categorizadas por divisão)
- Acúmulos relevantes: Igor (SPS+Costal), Tatiana (Jurídico+Compras), Gianlucca (REMS+Property+Facilities), Carolina (PM+Construtivo), Guilherme (Diligências+Sustentabilidade)
 
## Homônimos críticos
- "Leandro" — sempre usar sobrenome:
  - Leandro Delecrodio = Orçamentos (CTS/SPS, sob Igor)
  - Leandro Braga (Cardoso) = Inteligência de Mercado (CTS, sob Daniel Jackel)
 
## Documentos-fonte
[lista do Tier 2 da reading-list — seção Colliers]
 
## Regras de uso
- Antes de afirmar fato sobre Colliers, validar contra estrutura-colliers.md
- Para discovery preps, ir para 01-colliers/specs/
- Para perfis, ir para 00-projeto/directory/pessoas/

6. meeting-orchestration (NOVO)

Por que: Suporte aos gatilhos 1 e 2 do playbook (pré-reunião T-4h e pós-reunião T+30min).

Conteúdo (SKILL.md):

# meeting-orchestration
 
## Quando aplicar
Triggers (automáticos, via cron):
- T-4h antes de reunião confirmada em MEETINGS (gatilho 1)
- T+30min após reunião terminar (gatilho 2)
 
Triggers (manuais):
- Pedro pede "preparar reunião com X"
- Pedro pede "consolidar a reunião de hoje"
 
## Pré-reunião (T-4h)
1. Localizar discovery prep ou doc de preparação
2. Carregar atas anteriores com mesma contraparte
3. Carregar perfil(is) da contraparte
4. Gerar mini-brief:
   - Quem é a contraparte (1 frase: cargo + acúmulo + advocate?)
   - 3 pendências abertas (citar T-NNN)
   - 3 perguntas-chave (citar do prep)
   - 1 risco de comunicação (de people-calibration)
5. Enviar Telegram Pedro com `🎯 prep T-4h: <reunião>`
 
## Pós-reunião (T+30min)
1. Identificar canal Slack relevante (matching por tópico)
2. Extrair sinais materiais (decisões, tarefas, definições, riscos novos)
3. Classificar cada sinal por camada-alvo (decisões/TASKS/DEFINICOES/riscos/gaps/dependencias)
4. Propor promoção em rascunho:
   - "Sinal 1: [texto]. Camada-alvo: <camada>. Próximo ID livre: <ID>."
5. Enviar Slack DM Pedro: "encontrei N sinais; ok promover?"
6. Aguardar confirmação antes de qualquer write
 
## Limites
- NUNCA escrever direto em camada canônica
- NUNCA marcar tarefa como concluida sem evidência (link de ata ou commit)
- Se houver dúvida classificatória: marcar como "[ambíguo — confirmar]"

7. proactive-alerts (NOVO)

Por que: Gerencia gatilhos 3, 4, 5, 7, 8 do playbook. Centraliza a lógica de “quando vale a pena alertar Pedro”.

Conteúdo (SKILL.md):

# proactive-alerts
 
## Princípio
Alertar é caro. Alertar errado é caríssimo. Esta skill aplica filtros de relevância antes de qualquer alerta proativo.
 
## Filtros de qualidade (todos devem passar)
1. Material — não é detalhe operacional menor
2. Acionável — Pedro pode fazer algo a respeito
3. Não duplicado — não foi alertado nas últimas 24h (ou 7d para tarefas atrasadas)
4. Tem evidência — link para arquivo/mensagem que comprova
5. Tem recomendação — não é só "olha isso"; é "olha isso e considera X"
 
## Tipos de alerta (cf. proactivity-playbook gatilhos 3, 4, 5, 7, 8)
- Tarefa atrasada (gatilho 3)
- Sinal Slack (gatilho 4)
- Conflito de classificação epistêmica (gatilho 5)
- Gap material (gatilho 7)
- Vault integrity (gatilho 8)
 
## Formato padrão de alerta (Telegram)
 
[ícone] [tipo curto]
 
Contexto: <1-2 linhas>
Evidência: <link>
Recomendação: <ação concreta>
 
(máx 800 caracteres por alerta — Telegram-friendly)
 
## Backoff
- Mesmo tipo de alerta: dedup 24h
- Mesmo objeto (mesmo task ID, mesmo gap, mesma pessoa): dedup 7d
- Após 3 alertas seguidos sem reação Pedro: pausar tipo de alerta por 48h
 
## Métricas (revisão semanal)
- % alertas que viraram ação (>80% = bom; <60% = filtro frouxo)
- # alertas/dia (>10 = ruído; <2 = filtro estreito)

Implementação — ordem sugerida

SemanaSkillPor que essa ordem
Semana 2 (28/04 → 02/05)colliers-domain-knowledgeSprint Property/Facilities precisa Axios entender CREMS
Semana 2atualizar obsidian-vault-governanceVault mudou demais; outras skills dependem de uma vault skill atualizada
Semana 3 (05/05 →)costal-domain-knowledgeDiscovery orçamentação semana 2 vira material esta semana
Semana 3meeting-orchestrationGatilhos 1+2 dependem desta skill
Semana 4 (12/05 →)proactive-alertsOutras skills precisam estar maduras antes do alerta proativo
Semana 4atualizar slack-signal-governanceJunto com correção do cron

Skills padrão OpenClaw — observações

Skill padrãoUso esperado V2
healthcheckSim — para vault-integrity-check
node-connectSob demanda
skill-creatorPara criar as 4 skills novas acima
taskflowSim — orquestrar gatilhos
taskflow-inbox-triageSim — para classificar sinais Slack
tmuxSob demanda (raro)
weatherNão usado — pode ignorar

Checklist de validação por skill nova

Antes de promover skill nova de “rascunho” para “ativa”:

  • SKILL.md publicado em /root/.openclaw/workspace/skills/<nome>/
  • Espelho versionado em agentes-core/axios/v2/skills/<nome>.md
  • Pelo menos 3 invocações de teste com saída validada
  • Documentado quais documentos do vault a skill consome
  • Limites duros listados
  • Compatível com guardrails V1 (security-guardrails)
  • Pedro deu OK explícito para ativação

Ver também