Habilidade
@trustless-work/skill
Instale habilidades de IA e verifique integrações do Trustless Work diretamente do seu terminal.
O que são Habilidades de IA?
Assistentes modernos de codificação com IA, como Claude Code ou Gemini CLI são ferramentas de uso geral — elas sabem muito sobre programação, mas não entendem inerentemente seu produto específico, suas convenções de API ou as nuances dos seus padrões de integração.
Habilidades resolvem esse problema. Uma habilidade é um conjunto curado de arquivos markdown injetados no diretório de contexto do agente de IA, para que o assistente possa lê-los como material de referência ao ajudar você a escrever, depurar ou revisar código. Pense nisso como dar à IA um manual focado para uma integração específica — sem nenhum fine-tuning ou alteração no modelo.
Uma habilidade normalmente contém:
Conceitos centrais e modelos mentais do produto
Documentação de referência da API e do SDK
Guias de ciclo de vida e definições de funções
Exemplos de código funcionais e padrões comuns
Checklists de pré-produção
Quando o agente de IA inicia uma sessão, ele pode acessar esses arquivos e aplicar esse conhecimento a cada sugestão que faz. O resultado é um assistente que entende profundamente sua stack — e que você não precisa reexplicar toda vez.
Por que as Habilidades são úteis?
Sem uma habilidade
Você gasta tempo explicando o mesmo contexto em todas as conversas:
"Trustless Work é um protocolo de escrow na Stellar... o endpoint de deploy retorna uma transação XDR não assinada... você precisa assiná-la com a carteira do financiador... a trustline é definida com o endereço do emissor, não com o endereço do contrato..."
Com uma habilidade
A IA já sabe tudo isso. Você pode ir direto para:
"Gere o fluxo de implantação do escrow para o meu marketplace freelance."
E ela produzirá código correto e idiomático na primeira tentativa.
As habilidades são especialmente valiosas para:
Onboarding de novos desenvolvedores — a IA pode orientá-los com contexto preciso
Reduzir erros de integração — a IA aponta padrões incorretos antes de irem para produção
Manter-se atualizado — execute
updatequando a habilidade lançar uma nova versão, e sua IA fica imediatamente atualizada
A Habilidade Trustless Work
O @trustless-work/skill pacote instala uma base de conhecimento curada sobre Trustless Work Escrow-as-a-Service no seu assistente de codificação com IA preferido. Ele cobre tudo o que sua IA precisa para ajudar você a construir integrações de escrow corretas e prontas para produção na Stellar.
O que a habilidade ensina à IA
Conceitos centrais
O que é o Trustless Work, tipos de escrow, o padrão de assinatura XDR
Funções
Todas as 9 funções (Provedor de Serviço, Aprovador, Signatário da Liberação, Recebedor, Endereço da Plataforma, Resolutor de Disputas) e suas permissões
Ciclo de vida
As 6 fases da Iniciação até a Liberação e a Resolução de Disputas
REST API
Endpoints, autenticação, URLs base, payloads de implantação, limites de taxa
SDK
Hooks para React/Next.js, TrustlessWorkConfig configuração do provider, tipos TypeScript
Blocks
Componentes de UI pré-construídos, ordem de aninhamento dos providers, dependências peer
Exemplos
Cenários completos de integração funcional para API e SDK
Checklist
Itens de verificação de pré-produção antes de entrar no ar
Detalhes críticos codificados pela habilidade
Estes são os erros de integração mais comuns — a habilidade ensina a IA a identificá-los:
Toda operação de escrita retorna uma transação XDR não assinada que deve ser assinada pela função correta antes do envio
O
trustlineno payload de implantação requer o endereço do emissor (G…) — não o endereço do contrato (C…)As trustlines devem ser adicionadas a partir da carteira do próprio usuário — não existe chamada de API para isso
A ordem de aninhamento dos providers importa:
QueryClientProvider → TrustlessWorkConfig → WalletProviderAs aprovações de marcos são irreversíveis na blockchain
O limite de taxa da API é 50 solicitações a cada 60 segundos
Agentes de IA suportados
Claude Code
✅ Suportado
.claude/skills/trustless-work/
Gemini CLI
✅ Suportado
.gemini/skills/trustless-work/
OpenCode
🔜 Em breve
—
Instalação
Não é necessária instalação global. Execute diretamente com npx:
Um prompt interativo vai guiá-lo por três etapas:
Etapa 1 — Selecione seu agente de IA
Etapa 2 — Selecione uma ação
Etapa 3 — Escolha um preset de produto (apenas instalação)
Os arquivos de habilidade selecionados são copiados para o diretório de contexto do seu agente. A partir desse momento, seu assistente de IA tem conhecimento completo da superfície de integração do Trustless Work.
Mantendo a Habilidade Atualizada
À medida que a API e o SDK do Trustless Work evoluem, a habilidade também evolui. Para atualizar todas as habilidades instaladas para a versão mais recente:
Isso detecta automaticamente quais agentes têm a habilidade instalada e atualiza todos os arquivos de template.
Verificando Sua Integração
Além de instalar contexto para a IA, a CLI inclui um verificador de integração que analisa estaticamente sua base de código e relata problemas antes de você implantar em produção.
O verificador detecta o tipo do seu projeto (Next.js, SPA React, backend Node.js) e executa verificações direcionadas com base em quais produtos do Trustless Work você está usando.
O que é verificado
Uso da REST API
A chave de API é carregada de uma variável de ambiente (não codificada no código)
As requisições incluem o
x-api-keycabeçalhoAs URLs base estão corretas para testnet e mainnet
O padrão de assinatura XDR está implementado corretamente
Há tratamento do limite de taxa
Uso do SDK (@trustless-work/escrow)
O pacote está instalado
TrustlessWorkConfigo provider envolve a aplicação"use client"diretriz está presente onde necessárioQueryClientProviderestá colocado antes deTrustlessWorkConfigengagementIdé passado ao criar escrowsStellar Wallets Kit está integrado para assinatura de XDR
Uso de Blocks (@trustless-work/blocks)
O pacote e todas as dependências peer estão instalados
A ordem de aninhamento dos providers está correta
"use client"está definido nos arquivos de layoutWalletNetworkestá configuradosetSelectedEscrowpadrão é usado corretamenteOs diálogos de confirmação de aprovação estão implementados
A orientação sobre trustline está presente na UI
Relatório de verificação
Cada verificação retorna um de três status:
✅ OK
Implementado corretamente
⚠️ AVISO
Funciona, mas não está pronto para produção
❌ FALHA
Problema crítico que deve ser corrigido
Cada achado inclui uma descrição, o que foi detectado e um guia de "como corrigir" com um link para a documentação relevante.
O relatório é impresso no console e também salvo como um arquivo markdown em:
.claude/skills/trustless-work/report.md(Claude Code).gemini/skills/trustless-work/report.md(Gemini CLI)
Esse arquivo pode ser comitado no seu repositório ou compartilhado com revisores.
Estrutura dos Arquivos da Habilidade
Após a instalação, os seguintes arquivos ficam disponíveis no diretório de habilidades do seu agente:
Você pode ler qualquer um desses arquivos diretamente no seu editor. Eles são markdown puro — não é საჭირო ferramenta especial.
Requisitos
Node.js >= 18.0.0
Um dos agentes de IA suportados instalado na sua máquina
Referência Rápida
npx @trustless-work/skill
Instalação ou verificação interativa
npx @trustless-work/skill update
Atualizar todas as habilidades instaladas
Atualizado
Isto foi útil?