Ir para o conteúdo
Ir para o conteúdo

Adaptadores

Os adaptadores publicam o core compartilhado (skills, policy, router e hooks, quando suportados) no layout de instalação de cada agente. Os orquestradores (scripts/toolkit.ps1, scripts/sync-agent.ps1, scripts/validate-agent.ps1) resolvem o agente via adapters/registry.json e chamam o módulo PowerShell daquela entrada.

Para o fluxo do produto, comece em Começar. Visão do núcleo e dos adaptadores: Arquitetura. Depois do sync: Usando skills.

Agentes suportados

id Nome de exibição
cursor Cursor
antigravity Antigravity
claude Claude Code
codex Codex
copilot GitHub Copilot
opencode OpenCode
grok Grok Build
zcode ZCode
hermes Hermes
openhands OpenHands

Conjunto fechado implementado: estes 10 ids. Cada um tem módulo concreto com publicação e teste smoke no repositório.

Nota Codex

O Codex é dual-root: skills do plugin em InstallRoot/plugin (rules=true Publish-Policy → InstallRoot/rules); pai de produto/AGENTS/hooks é o InstallRoot (live ~/.codex). Sync padrão é somente plugin; -UserScope opcional espelha skills para fixture InstallRoot/.agents/skills ou live ~/.agents/skills (exige -AllowUserHome). Contrato completo: docs/ADAPTERS.md · guia: Usando skills.

Nota Hermes

O InstallRoot live é $HERMES_HOME (típico ~/.hermes). Skills e AGENTS.md ficam direto nessa raiz. Policy é dobrada em AGENTS.md (sem árvore rules/). Hooks são publicados: plugin agent-dev-toolkit-guard + shell agent-hooks path/secrets; merge chaveado de config.yaml só para plugins.enabled / hooks.pre_tool_call — nunca SOUL / tokens / gateway. Invoque skills com /id. Publish-Agents é no-op.

Nota OpenHands

O InstallRoot de projeto é a raiz do repo: skills em .agents/skills/, roster em .agents/agents/, AGENTS.md dobrado, hooks shell em .openhands/ (incl. guard_pre_tool.sh para pre_tool_use path/secrets, fail-closed), metadados de plugin em .plugin/plugin.json. Skills do usuário live usam -InstallRoot "$env:USERPROFILE\.agents" -AllowUserHome para skills em ~/.agents/skills. Canvas não é spawn de subagente (subagents=none; fallback SPAWN no pai).

Path/secrets (hosts capazes)

Regras compartilhadas: adapters/_shared/guard-rules.md + GuardCommon.ps1. Fora do workspace e write sem path = deny. Matriz completa: docs/ADAPTERS.md.

Honestidade dos Publish knobs (depth / threads / inherit)

O Publish pode emitir somente honesty de depth/threads alinhada ao SPAWN e model inherit (ou omitir model). Caps: *-developer ≤2, orchestrate-* ≤4. Nunca fixe slug de model filho≠pai no publish. Hosts com agents=false / no-op (Hermes, OpenCode, Antigravity): não emita knobs delegation.max_spawn_depth do host. Contrato: spawn-publish-honesty.md · domains/adapters.md.

Honestidade do emissor TRACE

SoT do trail continua sendo só features/NNN-slug/TRACE.jsonl. Emissores são fail-open (exit 0; nunca anexam secrets / tool_input). Claim apenas o que está wired:

Claim Hosts
Wired fail-open emit-trace.ps1 Cursor (hooks.json postToolUse / subagentStop); Claude (PostToolUse / SubagentStop)
Asset only — sem wire live PostToolUse Codex (Publish-Hooks ainda só PreToolUse guard)
Not claimed OpenHands, OpenCode, Hermes, Grok, Copilot, Antigravity, ZCode

Contrato: trace-emitter-honesty.md · assert Assert-TraceEmitterFailOpen.ps1.

Como o sync funciona

  1. Prefira o scripts/toolkit.ps1 interativo (Smart Manager).
  2. Resolve -Agent <id> em adapters/registry.json.
  3. Carrega o módulo do adaptador (Publish-*, Invoke-SmokeValidate, Uninstall-Toolkit, …).
  4. O InstallRoot padrão é uma fixture in-repo; caminhos reais sob USERPROFILE exigem -AllowUserHome explícito.
pwsh -NoProfile -File .\scripts\toolkit.ps1
pwsh -NoProfile -File .\scripts\toolkit.ps1 -Action ListAgents
pwsh -NoProfile -File .\scripts\toolkit.ps1 -Action Sync -Agent claude
pwsh -NoProfile -File .\scripts\sync-agent.ps1 -Agent claude
pwsh -NoProfile -File .\scripts\validate-agent.ps1 -Agent claude
# ou: -Agent cursor | copilot | hermes | openhands | …

Árvore de origem

READMEs e módulos por agente ficam no diretório adapters/ do repositório:

Próximo: Começar · Usando skills · Arquitetura