Skill Update

Skill Update — hub das skills Space

⚠️ COPIA: destino = SKILLS_DEST_PATH do .env desta maquina (PC ≠ Coders).
Altere em space-cursor-skills/skills/skill-update/ → obrigatorio rodar npm run sync na raiz (maquina alvo). Sem Sync a copia nao atualiza.
Ver 00-COPIA-LEIA-ME.md. Fluxo completo do repo: AGENTS.md na raiz do space-cursor-skills.

Trigger: /skill-update
Sempre responder em português.

Papel

Esta skill é o ponto único de verdade operacional do pack de skills:

• Onde editar (repo vs cópia)
• Como publicar mudanças (npm run sync)
• Destino por ambiente (.env / Coders)
• Catálogo do que existe e para que serve
• Como criar / alterar / deprecar uma skill
• Regras transversais (.task/, .docs/, gitignore, idioma)
• Constituição do time (docs/ na raiz — não é skill; mapa em docs/README.md)
• Skills 100% genéricas — nenhum cliente/produto hardcoded (BATEU, SPACEBET, …)

Quando o usuário falar de manutenção de skill, sync, nova skill ou “como funciona o pack”, usar esta skill — não reinventar o fluxo em cada skill de produto.

Skills são genéricas (obrigatório)

O pack roda em vários produtos. SKILL.md, playbooks, scripts, templates e .env.example descrevem processo, não um cliente.

IDs, URLs e nomes de um produto: perguntar na conversa (ou inferir do workspace aberto e validar).
Ao criar/alterar skill: se o texto só fizer sentido para um cliente, generalizar antes do sync.

Wizard (perguntar se não estiver claro)

1. Ação: sync | alterar skill existente | criar skill nova | diagnosticar (cópia desatualizada / path errado) | explicar catálogo | atualizar constituição (docs/ na raiz do repo)
2. Skill alvo (se alterar/criar): nome da pasta skills/<nome>/
3. Máquina alvo do Sync: PC local | Coders | ambas (lembrar: cada uma tem seu .env)
4. Constituição (se a ação for atualizar constituição): qual arquivo em docs/ muda; atualizar docs/README.md primeiro (mapa skill → arquivo → por quê)

Fonte da verdade

Nunca editar só a pasta de destino e considerar pronto.

Comando Sync (obrigatório após mudança)

Na raiz do clone, na máquina onde o Cursor lê as skills:

npm run sync
# ou
npm run sync:dry

O Sync: git pull (se ligado) → copia skills/ e docs/ → destino → carimba 00-COPIA-LEIA-ME.md → gera clickup.env / apidog.env onde couber.

Sem Sync, a cópia não atualiza. Após Sync, sugerir reiniciar o chat se a skill já estava carregada.

Detalhes: playbook.md.

Catálogo

Lista viva: catalog.md. Manter atualizado ao criar/remover skill.

Constituição (docs/)

Não é skill. Fonte: space-cursor-skills/docs/. Destino após sync: {SKILLS_DEST_PATH}/docs/.

Antes de qualquer alteração nos arquivos temáticos: ler e, se o mapa mudou, atualizar docs/README.md. Esse README é o que todas as skills de produto leem primeiro — PO, QA e contexto não usam os mesmos arquivos do mesmo jeito.

Skills de produto só têm ponteiro (../docs/README.md + tabela curta). Proibido colar resumo do entry-point ou do DS no SKILL.md.

Fluxo: editar docs/ → conferir README → npm run sync. Detalhe: playbook.md.

Regras transversais (todas as skills de produto)

Artefatos locais

Não commitar essas pastas sem o usuário pedir.

Pipeline PO (task com API)

Na skill po-techlead-scrum: Objetivo → regra de negócio → DB → rotas no Apidog → task ClickUp.
Project ID e moduleId: perguntar sempre (não ficam no .env). Detalhe: skills/po-techlead-scrum/apidog.md.

Comunicação

• Respostas das skills Space: português
• Meta de manutenção de skill (sync, path, COPIA): falar aqui (/skill-update) ou apontar para esta skill
• Skills de produto focam no domínio; leem ../docs/README.md primeiro (PO ≠ QA ≠ contexto); banner COPIA + ponteiro AGENTS.md / esta hub

Fluxos rápidos

A — Só sincronizar

1. Confirmar clone + .env da máquina (SKILLS_DEST_PATH)
2. npm run sync
3. Reportar skills copiadas + destino usado
4. Pedir restart do chat se necessário

B — Alterar skill existente

1. Editar em skills/<nome>/ no repo (não na cópia)
2. Se mudou catálogo/comportamento transversal → atualizar catalog.md e AGENTS.md se preciso
3. Commit/push se o usuário pedir
4. npm run sync na máquina alvo
5. Resumir o que mudou em 3–5 bullets

C — Criar skill nova

Seguir playbook.md. Checklist mínimo:

• Pasta skills/<kebab-name>/
• SKILL.md com frontmatter (name, description, trigger /…)
• Banner COPIA + Sync obrigatório + ponteiro AGENTS.md / esta hub
• Seção artefatos (.task/ / .docs/ / N/A) se gravar arquivos
• Entrada em catalog.md
• Linha em AGENTS.md + README do repo
• Conteúdo genérico (sem IDs/URLs/defaults de um cliente)
• npm run sync

D — Diagnosticar

Sintomas comuns → playbook.md.

E — Atualizar constituição

1. Ler docs/README.md (quem lê o quê — PO ≠ QA)
2. Editar docs/<arquivo>.md no repo
3. Se o mapa mudou, atualizar só o README — skills de produto continuam com ponteiro fino
4. npm run sync (precisa copiar docs/ para o destino)
5. Pedir restart do chat

Checklist final (qualquer ação desta skill)

• Mudança feita no repo space-cursor-skills, não só no destino
• Constituição: mapa em docs/README.md ainda verdadeiro (se mexeu em docs/)
• SKILLS_DEST_PATH respeitado (PC ≠ Coders)
• npm run sync rodado (ou instruído) na máquina alvo
• Catálogo / AGENTS atualizados se skill nova ou removida
• Nada específico de um produto nas regras globais (IDs/URLs/defaults de cliente)
• apidog.env / clickup.env gerados no destino se os tokens existem no .env (nunca commitados)
• Usuário avisado para reiniciar chat se skill já estava em uso