Guia de leitura localizado
writing-plansFinalidade, utilização e fonte
Use quando tiver uma especificação ou requisitos para uma tarefa de várias etapas, antes de começar a escrever o código.
Fonte recuperada:
- Repositório de origem
- obra/superpowers
- SKILL.md
skills/writing-plans/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
Use quando tiver uma especificação ou requisitos para uma tarefa de várias etapas, antes de começar a escrever o código.
Como funciona o fluxo de trabalho upstream
Visão geral
Elabore planos de implementação para um engenheiro que não tenha visto este código-fonte ou esta especificação. Presuma que ele escreverá código idiomático na linguagem do projeto assim que conhecer a interface exata e os testes específicos, e que fará uma escolha razoável sempre que o plano deixar alguma opção em aberto. O que ele não pode saber é o que você decidiu: quais arquivos, quais nomes e assinaturas, quais valores da especificação, quais testes comprovam cada tarefa. Documente tudo isso. Apresente a ele o plano completo em tarefas menores. DRY (Don't Repeat Yourself - Não se Repita). YAGNI (You Ain't Gonna Need It - Você Não Vai Precisar Disso). TDD (Test-Driven Development - Desenvolvimento Orientado a Testes). Commits frequentes. Anuncie no início: "Estou usando a habilidade de escrever planos para criar o plano de implementação." Contexto: Se estiver trabalhando em uma árvore de trabalho isolada, ela deve ter sido criada por meio dosuperpowers:using-git-worktreesHabilidade no momento da execução. Salvar planos em:docs/superpowers/plans/YYYY-MM-DD-.md
Granularidade de Etapa
Cada etapa consiste em uma ação com um resultado verificável: "Escrever o teste que falha" - etapa "Executar o teste para garantir que ele falhe" - etapa "Implementar o código mínimo necessário para que o teste seja aprovado" - etapa
Passagem a montante · L43 ↗O que contém um passo
Uma etapa é considerada concluída quando o implementador consegue escrever exatamente uma coisa razoável a partir dela. Esse é o requisito fundamental: não ambíguo, não completo. Cada tipo de etapa carrega consigo apenas o que a torna não ambígua: Etapa de teste: o nome do teste e suas asserções, em código, com os valores exatos da especificação. Etapa de código: a assinatura exata (nome, parâmetros, tipo de retorno), o arquivo em que reside e os valores específicos definidos na especificação. O implementador escreve o corpo do código. Um corpo de código aparece apenas para um algoritmo cuja assinatura e testes não determinam, ou para uma cópia exata que a especificação fixa. Etapa de verificação: o comando a ser executado e a saída que indica que a verificação foi bem-sucedida.
Passagem a montante · L140 ↗Requisitos e configuração
Nenhuma passagem de requisitos resumida foi selecionada deste arquivo. Isso não significa que a Skill não tenha dependências. Verifique as instruções de configuração do repositório e os arquivos referenciados.
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.
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
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a