Harness engineering beginner tutorial, from 0 to 1
TypeScript agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm
refactor: Add Portuguese (Brazil) translation for skills documentation
João Paulo Fricks32d61ee11098
diff --git a/skills/README-AR.md b/skills/README-AR.mdindex 882cadc..0e819a3 100644--- a/skills/README-AR.md+++ b/skills/README-AR.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-CN.md b/skills/README-CN.mdindex cad9c34..58bbffd 100644--- a/skills/README-CN.md+++ b/skills/README-CN.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skills(技能集)diff --git a/skills/README-DE.md b/skills/README-DE.mdindex 5fb916f..0cb69bc 100644--- a/skills/README-DE.md+++ b/skills/README-DE.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-ES.md b/skills/README-ES.mdindex 2d62625..57ca4d4 100644--- a/skills/README-ES.md+++ b/skills/README-ES.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-FR.md b/skills/README-FR.mdindex 66e2492..e9f1a19 100644--- a/skills/README-FR.md+++ b/skills/README-FR.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-JA.md b/skills/README-JA.mdindex 264ab5a..1c28818 100644--- a/skills/README-JA.md+++ b/skills/README-JA.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-KO.md b/skills/README-KO.mdindex 53372af..7d28fb9 100644--- a/skills/README-KO.md+++ b/skills/README-KO.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># 스킬(Skills)diff --git a/skills/README-PT-BR.md b/skills/README-PT-BR.mdnew file mode 100644index 0000000..24ebdc3--- /dev/null+++ b/skills/README-PT-BR.md@@ -0,0 +1,73 @@+# Skills++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.++## Skills Disponíveis++### harness-creator++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).++- **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+- **Templates**: `AGENTS.md`/`CLAUDE.md`, `feature-list.json`, `init.sh`, `progress.md`, `session-handoff.md`+- **Scripts**: criação de estrutura, validação, renderização de avaliação em HTML, execução de benchmark estrutural+- **10 casos de teste de avaliação integrados**++Consulte [harness-creator/README.md](harness-creator/README.md) para a documentação completa.++## Como o harness-creator Foi Criado++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.++- **Fonte do skill-creator**: [anthropics/skills — skill-creator](https://github.com/anthropics/skills/tree/main/skills/skill-creator)+- **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)++## Estrutura de Diretórios+```+skills/+├── README.md # Este arquivo+├── README-CN.md # Versão em chinês+├── README-ZH-TW.md # Versão em chinês tradicional+├── README-JA.md # Versão em japonês+├── README-ES.md # Versão em espanhol+├── README-FR.md # Versão em francês+├── README-AR.md # Versão em árabe+├── README-VI.md # Versão em vietnamita+├── README-DE.md # Versão em alemão+├── README-TR.md # Versão em turco+├── README-PT-BR.md # Versão em português (Brasil)+└── harness-creator/ # Skill de engenharia de harness+ ├── SKILL.md # Definição principal do skill+ ├── SKILL.md.en # Versão apenas em inglês+ ├── README.md # Documentação detalhada+ ├── metadata.json # Metadados e gatilhos do skill+ ├── agents/ # Metadados da UI do skill+ ├── scripts/ # Auxiliares de scaffold, validação, benchmark+ ├── evals/ # Casos de teste+ ├── templates/ # Templates de scaffold+ └── references/ # Documentos de padrões detalhados+```++## Como as Skills Funcionam++Cada skill segue uma estrutura padrão:++1. **SKILL.md** — O ponto de entrada. Contém frontmatter YAML (nome, descrição para acionamento) e instruções em Markdown para o agente.+2. **references/** — Documentos adicionais carregados no contexto conforme necessário.+3. **templates/** — Templates iniciais que a skill pode gerar para os usuários.++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.++## Auditoria de Segurança++Todos os arquivos deste diretório foram auditados para segurança:++- Sem backdoors, URLs ocultas ou payloads codificados+- Sem exfiltração de dados ou credenciais armazenadas diretamente no código+- Sem vulnerabilidades de injeção de comandos+- Os scripts utilizam apenas módulos nativos do Node.js+- O `init.sh` gerado executa comandos de verificação detectados do projeto++## Licença++MIT\ No newline at end of filediff --git a/skills/README-TR.md b/skills/README-TR.mdindex 9a3891d..4946ed1 100644--- a/skills/README-TR.md+++ b/skills/README-TR.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skill'lerdiff --git a/skills/README-VI.md b/skills/README-VI.mdindex ce240e2..0f61d81 100644--- a/skills/README-VI.md+++ b/skills/README-VI.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skillsdiff --git a/skills/README-ZH-TW.md b/skills/README-ZH-TW.mdindex cc84bf4..8669fd4 100644--- a/skills/README-ZH-TW.md+++ b/skills/README-ZH-TW.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skills(技能集)diff --git a/skills/README.md b/skills/README.mdindex b24e176..e6c6be8 100644--- a/skills/README.md+++ b/skills/README.md@@ -10,6 +10,7 @@<a href="README-VI.md"><img alt="Tiếng_Việt" src="https://img.shields.io/badge/Tiếng_Việt-d9d9d9"></a><a href="README-DE.md"><img alt="Deutsch" src="https://img.shields.io/badge/Deutsch-d9d9d9"></a><a href="README-TR.md"><img alt="Türkçe" src="https://img.shields.io/badge/Türkçe-d9d9d9"></a>+ <a href="README-PT-BR.md"><img alt="Português (Brasil)" src="https://img.shields.io/badge/Português (Brasil)-d9d9d9"></a></p># Skills@@ -50,6 +51,7 @@ skills/├── README-VI.md # Vietnamese version├── README-DE.md # German version├── README-TR.md # Turkish version+├── README-PT-BR.md # Portuguese (Brazil) version└── harness-creator/ # Harness engineering skill├── SKILL.md # Main skill definition├── SKILL.md.en # English-only version