Usando skills

Invoque as skills do toolkit após um sync bem-sucedido. Prefira ids de skill (kebab-case em core/skills/). A UX do host varia: slash / quando o agente suporta, seletor de skill, @-mention ou “use skill …”. Exemplos abaixo costumam usar slash por brevidade — o id é o que importa em todos os adapters.

Após qualquer sync, invoque a skill help-skills para o catálogo estático instalado (CATALOG.md + OPERATOR.md) — não carregue cada SKILL.md.

Especialistas em paralelo (padrão)

Após o sync, o router publicado pede aos agentes que prefiram subagentes especialistas em paralelo para planejamento, execução multi-facet, análise ou dúvidas não triviais, mantendo esta sessão como pai. Trabalho trivial / single-path fica no pai. Caps e fallback: SPAWN.md (ver Arquitetura).

Pré-requisitos

1. Sync de pelo menos um agente — ver Começar.
2. Projeto da aplicação aberto nesse agente (não só este repositório do toolkit).
3. Opcional: validação com toolkit.ps1 -Action Validate -Agent <id>.

Qual Forma / skill?

flowchart TD
  Start([Nova tarefa]) --> Q1{Várias stories / brownfield / precisa de especialistas?}
  Q1 -->|Sim| FC[Forma C]
  Q1 -->|Não| Q2{Feature única de complexidade média ou alta?}
  Q2 -->|Sim| SDD[Forma A SDD]
  Q2 -->|Só item de backlog informal| FB[Forma B refine]
  Q2 -->|Não| Q3{Correção pequena em uma área?}
  Q3 -->|Sim .NET| NET[dotnet-developer]
  Q3 -->|Sim outra stack| STACK[skill de stack ou developer]
  Q3 -->|Incerto| DEV[router developer]
  FC --> S0["/memory-bank-init Step 0"]
  S0 --> O1["/orchestrate-analyze"]
  O1 --> ArchGate{"Projeto novo / needs_domain (modelagem de domínio)?"}
  ArchGate -->|Sim| Confirm["papel architect: minuta → sim (confirmar) → ARCH"]
  ArchGate -->|Espelho brownfield| O2
  Confirm --> O2["/orchestrate-deliver"]
  O2 --> O3["/orchestrate-develop ou /sdd-develop"]
  FB --> Refine["/refine-story"]
  Refine --> AorC[Depois Forma A ou C]
  SDD --> Spec["/sdd-spec"]
  Spec --> Plan["/sdd-plan"]
  Plan --> Impl["/sdd-develop um passo"]
  NET --> DoneNet[Mudança de código]
  STACK --> DoneNet
  DEV --> STACK
  Impl --> DoneSdd[Mudança de código]
  O3 --> DoneSdd
  AorC --> SDD
  AorC --> FC
  DoneNet --> Post
  DoneSdd --> Post
  Post[Depois do código] --> CR["/code-review"]
  CR --> TC["/test-coverage opcional .NET"]
  TC --> Commit["/commit"]
  Commit --> Push["/push"]
  Push --> PR["/open-github-pr"]

Resumo ASCII:

Nova tarefa
  ├─ Várias stories / brownfield?        -> Forma C: memory-bank-init → analyze → deliver → develop
  ├─ Projeto novo / precisa domínio?     -> Forma C: analyze (+ confirmação architect) antes de develop
  ├─ Feature única média/alta?           -> Forma A: sdd-spec → sdd-plan → sdd-develop
  ├─ Item de backlog informal?           -> Forma B: refine-story → checklist? → A ou C
  ├─ Mudança pequena de stack?           -> *-developer ou /developer
  └─ Depois do código                    -> code-review → test-coverage? → commit → push → open-github-pr

Formas A / B / C

Forma	Quando	Pipeline	Notas
A Clássica	Uma feature clara	sdd-spec → sdd-plan → sdd-develop	Sem memory-bank obrigatório
B Backlog	Bug/story informal	refine-story → split-story-checklist opcional → A ou C	Prepara markdown estruturado
C Orquestrada	Várias stories / brownfield / domínio em projeto novo (greenfield)	memory-bank-init → analyze → deliver → develop	Analyze pode pedir confirmação do architect; deliver/develop reusam SDD clássico

Trabalho de domínio em projeto novo (greenfield): prefira Forma C. Assim /orchestrate-analyze pode acionar o papel architect do roster (não é skill slash). Ele gera uma minuta ARCH; você responde sim (confirmar); o ARCH fica aprovado. Só então os implementadores carregam um estilo de arquitetura e a camada de stack correspondente. Em brownfield, use descoberta primeiro: espelhe o ARCH existente.

Invocar por agente

A skill help-skills funciona em todos os adapters sincronizados (não só Codex).

Cursor

Skills: ~/.cursor/skills/<id>/SKILL.md. Rules: ~/.cursor/rules/*.mdc. Router: AGENTS.md.

Ação	Exemplo
Menu slash	/sdd-spec
Com args	/sdd-plan - path/to/PRD.md
Router de stack	/developer
Catálogo	/help-skills
Forma C Step 0	/memory-bank-init

Aceite os hooks na UI do Cursor uma vez se solicitado (fora de CI).

Claude Code

Skills em ~/.claude/skills/ (ou .claude/ do projeto). Router: CLAUDE.md. Invoque via UX de skill / slash do Claude; os nomes coincidem com os ids kebab-case. Catálogo: help-skills.

GitHub Copilot

Sync com -Mode user ou -Mode repo:

Mode	Skills / instruções
user	~/.copilot/skills, instructions/, copilot-instructions.md
repo	<repo>/.github/skills, …

Use os pontos de publicação agent-skills / custom-instructions do Copilot. Id do catálogo: help-skills.

Codex

O Codex é dual-root — skills do plugin e rules em InstallRoot não compartilham um único TOOLKIT_ROOT:

Superfície	Local
Skills do plugin + CATALOG + OPERATOR	Sob InstallRoot/plugin (sync padrão)
Rules (Publish-Policy)	InstallRoot/rules/*.md
Produto / AGENTS / hooks	InstallRoot (live ~/.codex)
USER skills opcional	Fixture InstallRoot/.agents/skills · live ~/.agents/skills com -UserScope + -AllowUserHome

Sync padrão é somente plugin. Use help-skills para o catálogo instalado — não carregue cada SKILL.md. Aceite os hooks com Codex /hooks após install real (smoke nunca exige isso).

OpenCode / Grok / ZCode / Antigravity

Agente	Local típico das skills	Dica
OpenCode	~/.config/opencode/skills	Plugins JS em plugins/
Grok	~/.grok/skills	Autorize via /hooks-trust se necessário
ZCode	~/.zcode/skills	ADE (filesystem do agente)
Antigravity	~/.gemini/config/skills	Layout oficial config/*

Layouts de publicação por agente: Adaptadores. Todos publicam help-skills + o pack skills-catalog.

Fluxos comuns

Forma A

/sdd-spec
/sdd-plan - <prd-path>
/sdd-develop - <plan-path> - Step N

Uma sessão de develop = um passo do PLAN.

Forma C

/memory-bank-init
/orchestrate-analyze

Depois /orchestrate-deliver e /orchestrate-develop (ou /sdd-develop). Orquestradores reusam contratos SDD clássicos; não os substituem.

Mudança pequena de stack

/developer

ou /dotnet-developer, /react-developer, /python-developer, …

Depois da implementação

/code-review
/commit
/push
/open-github-pr

PRs de feature: feature/* (ou feat/*) atual → develop. Modo release: develop → master/main. Prefira /open-github-pr à UI web quando gh estiver disponível.

Catálogo de skills (resumo)

Pastas canônicas em core/skills/ (38 skills + _shared). SoT do agente: skill help-skills → _shared/skills-catalog/CATALOG.md (mapa) + OPERATOR.md (confirmações, opções, nuances — não carregue cada SKILL.md). Packs em _shared/ não são skills slash. Não existe skill slash architect — o caminho architect é acionado a partir de orchestrate-analyze.

Grupo	Skills
Forma A	sdd-spec, sdd-plan, sdd-develop
Forma B	refine-story, split-story-checklist
Forma C	memory-bank-init, orchestrate-analyze, orchestrate-deliver, orchestrate-develop
Stack	developer + dotnet-, java-, react-, react-native-, angular-, vue-, blazor-, electron-, javascript-, python-developer
Design / Blip	impeccable, blip-plugin-developer
Docs RAG	document-plan, document-implement
Operacional	help-skills, code-review, commit, push, open-github-pr, refactor, repair-dotnet-build, test-coverage, ef-add-migration, scaffold-message-handler, api-integrate, performance-profile, containerize, i18n-manager

Expectativas do operador (visão geral)

Área	O que será pedido / opções
Git (commit / push / open-github-pr)	Confirmar mensagem de commit; confirmar push; modo PR feature vs release; confirmar título/corpo; sempre perguntar auto-merge. Detalhe: git-ops.md
code-review	Escolher single vs multi-angle (sem default silencioso)
Forma C	Memory-bank Step 0; backlog sim; rascunho ARCH do architect → sim em greenfield / needs_domain
sdd-develop	Um passo do PLAN por sessão
document-plan	Pergunta o idioma da doc antes de escrever
Caveman	Default OFF; caveman on\|off\|status\|lite\|full\|ultra — Modo Caveman

Notas estáticas instaladas: _shared/skills-catalog/OPERATOR.md (via help-skills).

Re-sync quando as skills parecerem desatualizadas

Fixture (seguro) — qualquer id Tier-1:

pwsh -NoProfile -File .\scripts\toolkit.ps1 -Action Sync -Agent claude

Exemplo live (Claude):

pwsh -NoProfile -File .\scripts\sync-agent.ps1 -Agent claude `
  -InstallRoot "$env:USERPROFILE\.claude" -AllowUserHome

Live Cursor:

pwsh -NoProfile -File .\scripts\sync-agent.ps1 -Agent cursor `
  -InstallRoot "$env:USERPROFILE\.cursor" -AllowUserHome

Arquivos gerenciados são sobrescritos; arquivos não gerenciados (externos) no ambiente do agente são preservados.

Próximo: Começar · Adaptadores · Arquitetura · Caveman · Início