|
| 1 | +# Skills |
| 2 | + |
| 3 | +Este diretório contém skills reutilizáveis de agentes de IA para o projeto Learn Harness Engineering. Cada skill é um template de prompt independente que pode ser carregado por agentes de programação com IA (Claude Code, Codex, Cursor, Windsurf, etc.) para executar tarefas especializadas. |
| 4 | + |
| 5 | +## Skills Disponíveis |
| 6 | + |
| 7 | +### harness-creator |
| 8 | + |
| 9 | +Skill de engenharia de harness para agentes de programação com IA em ambientes de produção. Ajuda a criar, avaliar e melhorar arquivos de harness de agentes (`AGENTS.md`, listas de funcionalidades, fluxos de verificação, mecanismos de continuidade de sessão). |
| 10 | + |
| 11 | +- **7 padrões de referência**: Persistência de Memória, Runtime de Skills, Engenharia de Contexto, Registro de Ferramentas, Coordenação Multiagente, Ciclo de Vida e Bootstrap, Armadilhas |
| 12 | +- **Templates**: `AGENTS.md`/`CLAUDE.md`, `feature-list.json`, `init.sh`, `progress.md`, `session-handoff.md` |
| 13 | +- **Scripts**: criação de estrutura, validação, renderização de avaliação em HTML, execução de benchmark estrutural |
| 14 | +- **10 casos de teste de avaliação integrados** |
| 15 | + |
| 16 | +Consulte [harness-creator/README.md](harness-creator/README.md) para a documentação completa. |
| 17 | + |
| 18 | +## Como o harness-creator Foi Criado |
| 19 | + |
| 20 | +A skill `harness-creator` foi desenvolvida usando a metodologia **skill-creator** — a meta-skill oficial da Anthropic para criar, testar e iterar sobre skills de agentes. O skill-creator fornece um fluxo de trabalho estruturado (rascunho → teste → avaliação → iteração) com executores de avaliação, avaliadores e um visualizador de benchmark integrados. |
| 21 | + |
| 22 | +- **Fonte do skill-creator**: [anthropics/skills — skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator) |
| 23 | +- **Documentação de skills do Claude Code da Anthropic**: [anthropics/claude-code — plugin-dev/skills](https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills) |
| 24 | + |
| 25 | +## Estrutura de Diretórios |
| 26 | +``` |
| 27 | +skills/ |
| 28 | +├── README.md # Este arquivo |
| 29 | +├── README-CN.md # Versão em chinês |
| 30 | +├── README-ZH-TW.md # Versão em chinês tradicional |
| 31 | +├── README-JA.md # Versão em japonês |
| 32 | +├── README-ES.md # Versão em espanhol |
| 33 | +├── README-FR.md # Versão em francês |
| 34 | +├── README-AR.md # Versão em árabe |
| 35 | +├── README-VI.md # Versão em vietnamita |
| 36 | +├── README-DE.md # Versão em alemão |
| 37 | +├── README-TR.md # Versão em turco |
| 38 | +├── README-PT-BR.md # Versão em português (Brasil) |
| 39 | +└── harness-creator/ # Skill de engenharia de harness |
| 40 | + ├── SKILL.md # Definição principal do skill |
| 41 | + ├── SKILL.md.en # Versão apenas em inglês |
| 42 | + ├── README.md # Documentação detalhada |
| 43 | + ├── metadata.json # Metadados e gatilhos do skill |
| 44 | + ├── agents/ # Metadados da UI do skill |
| 45 | + ├── scripts/ # Auxiliares de scaffold, validação, benchmark |
| 46 | + ├── evals/ # Casos de teste |
| 47 | + ├── templates/ # Templates de scaffold |
| 48 | + └── references/ # Documentos de padrões detalhados |
| 49 | +``` |
| 50 | + |
| 51 | +## Como as Skills Funcionam |
| 52 | + |
| 53 | +Cada skill segue uma estrutura padrão: |
| 54 | + |
| 55 | +1. **SKILL.md** — O ponto de entrada. Contém frontmatter YAML (nome, descrição para acionamento) e instruções em Markdown para o agente. |
| 56 | +2. **references/** — Documentos adicionais carregados no contexto conforme necessário. |
| 57 | +3. **templates/** — Templates iniciais que a skill pode gerar para os usuários. |
| 58 | + |
| 59 | +As skills utilizam divulgação progressiva — o agente primeiro visualiza apenas o nome + descrição, depois carrega o conteúdo completo do SKILL.md quando acionado e lê os recursos incluídos somente quando necessário. |
| 60 | + |
| 61 | +## Auditoria de Segurança |
| 62 | + |
| 63 | +Todos os arquivos deste diretório foram auditados para segurança: |
| 64 | + |
| 65 | +- Sem backdoors, URLs ocultas ou payloads codificados |
| 66 | +- Sem exfiltração de dados ou credenciais armazenadas diretamente no código |
| 67 | +- Sem vulnerabilidades de injeção de comandos |
| 68 | +- Os scripts utilizam apenas módulos nativos do Node.js |
| 69 | +- O `init.sh` gerado executa comandos de verificação detectados do projeto |
| 70 | + |
| 71 | +## Licença |
| 72 | + |
| 73 | +MIT |
0 commit comments