windows-shell-reliability
Ajuda seu agente a executar comandos no Windows de forma confiável. Evita problemas comuns com caminhos e codificação.
O que ela faz
Esta ferramenta ajuda a executar comandos no Windows sem erros. Ela ensina a lidar com caminhos de arquivos que contêm espaços, a usar a codificação correta de texto e a evitar problemas comuns ao rodar programas.
Quando usar
- ✓Ao criar ou corrigir programas que rodam no Windows.
- ✓Quando comandos falham por causa de nomes de arquivos com espaços.
- ✓Se os textos de saída dos comandos aparecem com caracteres estranhos.
Exemplo do que pedir para a IA
“Como faço para rodar um programa que está em uma pasta com espaço no nome?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta ensina a colocar aspas nos caminhos de arquivos com espaços e a usar comandos específicos do Windows para evitar erros de codificação ou problemas com programas.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill windows-shell-reliabilityOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/windows-shell-reliability/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Padrões de Confiabilidade do Shell do Windows
Melhores práticas para executar comandos no Windows via PowerShell e CMD.
Quando Usar
Use esta habilidade ao desenvolver ou depurar scripts e automação que rodam em sistemas Windows, especialmente ao lidar com caminhos de arquivo, codificação de caracteres ou ferramentas de linha de comando padrão.
1. Codificação e Redirecionamento
CRÍTICO: Diferenças de Redirecionamento Entre Versões do PowerShell
Versões mais antigas do Windows PowerShell podem reescrever a saída de comandos nativos de maneiras que quebram o processamento posterior. O PowerShell 7.4+ preserva o fluxo de bytes ao redirecionar a saída padrão (stdout), portanto, aplique a solução alternativa de conversão UTF-8 apenas quando estiver lidando com o comportamento de shell mais antigo ou com um arquivo de log que já está ilegível.
| Problema | Sintoma | Solução |
|---|---|---|
dotnet > log.txt |
view_file falha no Windows PowerShell mais antigo |
`Get-Content log.txt |
npm run > log.txt |
Necessita de um log de texto UTF-8 com erros incluídos | `npm run ... 2>&1 |
Regra: Prefira o redirecionamento nativo como está no PowerShell 7.4+ e use a conversão explícita para UTF-8 apenas quando o redirecionamento do Windows PowerShell mais antigo produzir um log ilegível.
2. Lidando com Caminhos e Espaços
CRÍTICO: Aspas
Caminhos do Windows frequentemente contêm espaços.
| ❌ Errado | ✅ Correto |
|---|---|
dotnet build src/my project/file.fsproj |
dotnet build "src/my project/file.fsproj" |
& C:\Path With Spaces\bin.exe |
& "C:\Path With Spaces\bin.exe" |
Regra: Sempre coloque entre aspas caminhos absolutos e relativos que possam conter espaços.
O Operador Call (&)
No PowerShell, se o caminho de um executável começar com uma aspa, você DEVE usar o operador &.
Padrão:
& "C:\Program Files\dotnet\dotnet.exe" build ...
3. Armadilhas Comuns de Binários e Cmdlets
| Ação | ❌ Estilo CMD | ✅ Escolha do PowerShell |
|---|---|---|
| Deletar | del /f /q file |
Remove-Item -Force file |
| Copiar | copy a b |
Copy-Item a b |
| Mover | move a b |
Move-Item a b |
| Criar Diretório | mkdir folder |
New-Item -ItemType Directory -Path folder |
Dica: Usar aliases de linha de comando como ls, cat e cp no PowerShell geralmente funciona, mas usar cmdlets completos em scripts é mais robusto.
4. Confiabilidade do .NET CLI
Velocidade e Consistência de Build
| Contexto | Comando | Por quê |
|---|---|---|
| Iteração Rápida | dotnet build --no-restore |
Pula o restore redundante de nuget. |
| Build Limpo | dotnet build --no-incremental |
Garante que não há artefatos obsoletos. |
| Em Segundo Plano | Start-Process dotnet -ArgumentList 'run' -RedirectStandardOutput output.txt -RedirectStandardError error.txt |
Inicia o aplicativo sem bloquear o shell e mantém os logs. |
5. Variáveis de Ambiente
| Shell | Sintaxe |
|---|---|
| PowerShell | $env:VARIABLE_NAME |
| CMD | %VARIABLE_NAME% |
6. Caminhos Longos
O Windows tem um limite padrão de 260 caracteres para caminhos.
Correção: Se você encontrar erros de caminho longo, use o prefixo de caminho estendido:
\\?\C:\Very\Long\Path\...
7. Solução de Problemas de Erros do Shell
| Erro | Causa Provável | Correção |
|---|---|---|
The term 'xxx' is not recognized |
Caminho não está em $env:PATH | Use o caminho absoluto ou corrija o PATH. |
Access to the path is denied |
Arquivo em uso ou permissões | Pare o processo ou execute como Administrador. |
Encoding mismatch |
Redirecionamento de shell mais antigo reescreveu a saída | Reexporte o arquivo como UTF-8 ou capture com `2>&1 |
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.
Perguntas frequentes
Por que aspas são importantes nos caminhos?
Porque o Windows pode interpretar o espaço como o fim de um nome e o início de outro, causando erros.
O que é codificação de texto?
É a forma como o computador representa os caracteres. Usar a codificação errada pode fazer com que acentos e outros símbolos apareçam incorretamente.
Posso usar comandos como 'del' ou 'copy'?
Sim, mas o PowerShell tem comandos mais seguros e claros como 'Remove-Item' e 'Copy-Item' que são preferíveis em scripts.
Detalhes
Descrição original do autor
Reliable command execution on Windows: paths, encoding, and common binary pitfalls.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4575
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC