Sistema de competências

Uma habilidade é um pacote de capacidade para um agente: um diretório construído em torno de um arquivo SKILL.md, contendo instruções, scripts e material de referência. Um Agente lê isso sob demanda enquanto executa uma tarefa, habilitando-o a fazer algo que de outra forma não poderia – como gerar um documento do Word com uma tabela de conteúdos e cabeçalhos.

O que é uma habilidade

Cada habilidade é um diretório contendo no mínimo um SKILL.md: a matéria frontal contém nome e descrição, e o corpo são as instruções que o Agente lê. O diretório também pode incluir anexos (scripts, documentos de referência, modelos de configuração) e declarar dependências e servidores MCP.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

Habilidades usam a divulgação progressiva: normalmente o Agente vê apenas o nome e descrição de cada habilidade, e lê no corpo inteiro e anexos apenas quando decide que uma habilidade se aplica à tarefa atual. Dessa forma, mesmo com muitas habilidades instaladas, nem tudo fica carregado em cada conversa.

Habilidades do sistema e habilidades instaladas pelo usuário

As habilidades pré-instaladas do sistema de uso geral da plataforma se enquadram em duas categorias principais: geração de documentos do Office (docx / xlsx / pptx / pdf) e habilidades de desenvolvimento (frontend, full-stack, iOS, Android, Flutter, React Native, e muito mais). A página Skill Management no console mostra a lista completa, e abrir qualquer habilidade revela sua versão, anexos e o SKILL.md completo.

Geração de documentos de escritório

Este grupo de habilidades do sistema permite que as etapas do Agent produzam arquivos de documentos de escritório diretamente, não apenas texto Markdown:

Um uso típico: um passo do Agente em um workflow diário de relatório usa a habilidade xlsx para produzir uma planilha de relatório semanal formatada, baixado com artefatos da execução ou entregue diretamente ao Slack ou e-mail. Os artefactos também podem ser publicados como ligações públicas; verPartilha de Artefactos Públicos.

Mercado de habilidades: instalação e versões

A página GarraHub Skill Marketplace no console se conecta ao registro ClawHub. Pesquisar por palavra-chave, ver a versão de cada habilidade, autor, contagem de download, e última atualização, e clique em instalar para adicioná-lo à sua conta.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• As habilidades carregam números de versão. Para ter habilidades instaladas, clique em Verificar atualizações na página Gerenciamento de Habilidades; atualizando a versão mais recente
• Apenas as habilidades instaladas a partir do mercado passam pelo fluxo de atualização; as habilidades importadas do ZIP não têm fonte de atualização – apenas reimportação
• Desinstalar apenas remove a habilidade de sua própria conta e não afeta outros usuários que instalaram a mesma habilidade
• Você também pode enviar um ZIP para importar uma habilidade que você mesmo escreveu: o pacote deve conter um SKILL.md com campos de nome e descrição válidos, e o tamanho total unzipped não deve exceder 100MB

Activar/desactivar por utilizador

Cada habilidade na página de gerenciamento de habilidades tem sua própria alternância. O estado habilitado/desativado é gravado em sua conta: uma vez que você desabilita uma habilidade do sistema, ele não é mais visível para seus Agentes, enquanto outros usuários não são afetados. Habilidades instaladas privadamente por outros usuários não são visíveis para você nem carregadas para você.

Âmbito do agente: limitação das competências que um agente pode utilizar

Além do nível de conta alterna, você pode definir um escopo de habilidade mais estreito para um único Agente em sua configuração. Campos comuns:

• Desactivar o subsistema de competências — desliga-o e este Agente não usa quaisquer competências
• Modo Allowlist – quando ligado, somente habilidades permitidas podem ser detectadas por este Agente, e habilidades incorporadas são adicionadas à lista automaticamente
• Desactivar a lista — uma lista negativa que ainda se aplica quando o modo allowlist estiver desligado
• Max habilidades por pedido — limita quantas habilidades são injetadas em um único pedido
• Busca e download automático—desligado por padrão; quando ligado, o Agente pesquisa automaticamente ClawHub e baixa novas habilidades quando encontra uma capacidade faltando localmente. Isso introduz downloads externos, então use-o com cuidado nas configurações da empresa

No momento da execução, a plataforma funde a configuração do Agente com seu estado de nível de usuário no escopo de habilidade eficaz: uma habilidade que você desativou na página Gerenciamento de habilidades não está disponível para cada Agente nessa execução.

Configuração do tempo de execução

Algumas habilidades precisam de parâmetros ou credenciais preenchidos antes de funcionar, como um token API para um serviço de terceiros. Uma habilidade com um modelo de configuração mostra configurado ou não em seu cartão; clique em Configurar Habilidade e preencha os campos.

• Campos sensíveis (token, senha, chave privada, etc.) são mascarados após salvar e nunca mostrados em texto simples; enviar com a máscara mantém o valor antigo inalterado
• Você pode configurar as habilidades que você mesmo instalou; apenas os administradores podem alterar a configuração em tempo de execução das habilidades do sistema

Objetivos comuns

Páginas relacionadas

• Guia de Configuração do Agente
• Biblioteca de módulos incorporada
• Partilha de Artefactos Públicos