Guia de leitura localizado
writing-skillsFinalidade, utilização e fonte
Utilize esta ferramenta ao criar novas habilidades, editar habilidades existentes ou verificar se as habilidades funcionam antes da implementação.
Fonte recuperada:
- Repositório de origem
- obra/superpowers
- SKILL.md
skills/writing-skills/SKILL.md- Estrelas do repositório
- 309,479
- Atualização do repositório
- 2026-10-30
- Classificação de Habilidades
- Fluxo de trabalho do agente
- Última coleta
Licença: MIT
Os trechos do fluxo de trabalho são auxiliares de leitura e não instruções executáveis do Codez. Nenhuma Skill de terceiros foi executada para gerar esta página.
Os trechos abaixo, que descrevem o propósito e o fluxo de trabalho, são material original, organizado e traduzido para facilitar a leitura. Eles são distintos da análise editorial da Codez, que possui uma etiqueta separada.
O que esta habilidade faz
Utilize esta ferramenta ao criar novas habilidades, editar habilidades existentes ou verificar se as habilidades funcionam antes da implementação.
Como funciona o fluxo de trabalho upstream
Fluxo de trabalho de descoberta
Como os futuros agentes encontram sua habilidade: Encontra o problema ("os testes são inconsistentes") Busca habilidades (busca por descrições, navega pelas categorias) Encontra a HABILIDADE (a descrição corresponde)
Passagem a montante · L388 ↗Visão geral
Habilidades de escrita são Desenvolvimento Orientado a Testes aplicado à documentação de processos. Habilidades pessoais residem no diretório de habilidades do seu ambiente de execução (~/.claude/skills/(sobre o Código Claude) — vejacodex-tools.mdougemini-tools.mdpara o caminho nesses ambientes de execução. Codex, Copilot CLI e Gemini CLI também reconhecem~/.agents/skills/como um alias entre ambientes de execução. Você escreve casos de teste (cenários de pressão com subagentes), observa-os falhar (comportamento de referência), escreve a habilidade (documentação), observa os testes serem aprovados (agentes em conformidade) e refatora (corrige falhas). Princípio fundamental: se você não observou um agente falhar sem a habilidade, você não sabe se a habilidade ensina a coisa certa.
Quando criar uma habilidade
A técnica não era intuitivamente óbvia para você. Você a consultaria novamente em vários projetos. O padrão se aplica de forma ampla (não é específico de um projeto). Outras pessoas se beneficiariam.
Passagem a montante · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if neededRequisitos e configuração
Habilidades de aplicação de disciplina (rules/requirements)
Exemplos: TDD, verificação antes da conclusão, projeto antes da codificação. Questões acadêmicas: Eles entendem as regras?
Passagem a montante · L188 ↗Limites e verificações de qualidade
Nenhuma passagem de limites separada foi selecionada deste arquivo. Isso não significa que a Skill seja segura para todas as entradas ou ambientes. Analise o código-fonte completo e valide seus próprios resultados.
Comece com um teste seguro.
- Verifique o host compatível e as instruções de instalação do repositório. Mantenha o diretório Skill e seus scripts, recursos e documentação referenciados juntos;SKILL.mdsozinho pode omitir dependências.
- Forneça ao agente suas entradas reais, a saída desejada e os critérios de aceitação. A sintaxe de invocação e as ferramentas disponíveis dependem do host; este site não pressupõe um comando de instalação universal.
- Teste o fluxo de trabalho original em um projeto descartável ou em uma cópia. Analise as operações que alteram arquivos, serviços remotos ou recursos faturáveis antes de permiti-las.
- Valide o resultado comparando-o com as verificações de qualidade da fonte e com seus próprios requisitos. Um gatilho bem-sucedido ou uma alta contagem de estrelas no repositório não garantem um resultado correto.
Leia mais na fonte.
- Visão geral
- O que é uma habilidade?
- Mapeamento TDD para Habilidades
- Quando criar uma habilidade
- Técnica
- Padrão
- Referência
- Estrutura de diretórios
- EscritaSKILL.md
- Fluxogramas
- Exemplos de código
- Habilidade autônoma
- Habilidade com ferramenta reutilizável
- Habilidade com Referências Detalhadas
- A Lei de Ferro (Igual ao TDD)
- Testando todos os tipos de habilidades
- Habilidades de aplicação de disciplina (rules/requirements)
- Técnicas e Habilidades (guias práticos)
- Habilidades de reconhecimento de padrões (modelos mentais)
- Habilidades de Referência (documentation/APIs)
- Justificativas comuns para não fazer os testes
- Associe o formulário à falha.
- Blindagem contra a racionalização
- RED-GREEN-REFACTOR para Habilidades
- VERMELHO: Escrever teste com falha (linha de base)
- VERDE: Habilidade mínima de escrita
- REFACTOR: Fechar brechas
- Redação de microtestes antes de cenários completos
- ❌ Exemplo Narrativo
- ❌ Diluição Multilíngue
Habilidades relacionadas
Tradução e escopo
Este guia de leitura seleciona trechos do texto fixado a montante.SKILL.mdA tradução foi feita com auxílio de ferramentas. Este não é um manual completo nem garante compatibilidade comprovada. Leia o original e os arquivos referenciados antes de usar.
Esta introdução refere-se à versão fixada abaixo; a atividade atual do repositório e o tempo de coleta são mostrados separadamente.
- Fonte fixada
- Leia o original ↗
- Fonte recuperada
- Commit de origem
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Fonte SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe