powershell-safe
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 1
03 SKILL.md 正文
PowerShell Safe
PowerShell footguns silently blank files and corrupt encoding. Targets Windows PowerShell 5.1 (powershell.exe), the default on Windows machines without pwsh.
Rule zero: file content does not go through the shell
Use write/edit tools to create or edit real files. Never:
echo "..." > file.ps1for real files.Set-Content/Out-File/Add-Contentfor code or config.- Redirect (
>,>>) is only acceptable for disposable output (logs, temp dumps).
Redirect re-encodes, may emit BOM, does no surgical diff, and if the left side produces $null the existing file becomes blank.
The classic bug: read and write the same file in one pipeline
Get-Content $f | ForEach-Object { $_ -replace 'a','b' } | Set-Content $f
# RESULT: $f BLANKED. Set-Content opens for write before Get-Content finishes.
Equally fatal variants: type $f | ... > $f, Import-Csv $f | ... | Export-Csv $f.
Correct patterns, in order:
# 1. Read fully into memory BEFORE writing
$c = [IO.File]::ReadAllText($f)
$c = $c -replace 'a','b'
[IO.File]::WriteAllText($f, $c) # UTF-8 no BOM
# 2. Temp + move (safer: original survives mid-failure)
$tmp = "$f.tmp"
# ...generate content into $tmp...
if ((Get-Item $tmp).Length -eq 0) { throw "tmp empty, aborting" }
Move-Item -Force $tmp $f
Encoding: PS 5.1 silent corruption
>/>>areOut-File: in 5.1 they write UTF-16LE with BOM. Git sees binary, diff dies, parsers break.Out-File -Encoding utf8/Set-Content -Encoding utf8in 5.1 write UTF-8 with BOM. BOM breaks shebang, some JSON/YAML parsers, diff tools.- UTF-8 without BOM in 5.1:
[IO.File]::WriteAllText($path, $text). - Detect BOM:
Get-Content -Encoding Byte -TotalCount 3 $f->239 187 191= UTF-8 BOM;255 254= UTF-16LE. - PS7 (
pwsh) defaults to utf8NoBOM; check$PSVersionTable.PSVersionbefore relying on it. - Never pipe
.exeoutput via>: re-encodes to UTF-16. Capture in a variable +WriteAllText, orcmd /c "foo.exe > out.txt".
$null blanks files
$content = Get-Something # failed, returned $null
$content | Out-File $f # $f is now BLANK
Before any write: if ([string]::IsNullOrEmpty($content)) { throw "empty content" }.
JSON round-trip is destructive
ConvertTo-Jsondefaults-Depth 2: deeper objects become"System.Collections.Hashtable"strings. Always-Depth 32.ConvertFrom-Jsonin 5.1 loses comments and may reorder keys. For point edits, useedittool or surgical regex instead of deserialize->modify->serialize.- After writing JSON programmatically, validate:
Get-Content $f -Raw | ConvertFrom-Jsonmust parse. Test-Jsononly exists in PS7; in 5.1 the try/catch aroundConvertFrom-Jsonis the test.
Destructive ops: Remove-Item, empty variables, -LiteralPath
$p = Get-TargetDir # returned $null or ""
Remove-Item -Recurse -Force "$p\sub" # becomes "\sub" or cwd!
- Check path variables:
if ([string]::IsNullOrWhiteSpace($p)) { throw }. Test-Path -LiteralPath $pbefore deleting; if absent, stop.- Use
-LiteralPath(not-Path) when the path may contain[ ] * ?(wildcards delete neighbors). -WhatIffirst on-Recursewhen the target isn't obviously disposable.
Quoting and escapes
- Single quotes = literal; double quotes interpolate
$varand`n(backtick is the PS escape, not\). &&does not exist in PS 5.1. Chain with;orcmd1; if ($LASTEXITCODE -eq 0) { cmd2 }.$?= last cmdlet bool;$LASTEXITCODE= last.exeexit code. Do not mix.- Inside the exec tool (Git Bash),
$is eaten by bash. For anything beyond one line, write a.ps1with thewritetool and runpowershell -NoProfile -ExecutionPolicy Bypass -File x.ps1.
Aliases that lie
| Alias | Actually is | Trap |
|---|---|---|
curl |
Invoke-WebRequest |
Not curl.exe: no -k, different output, slow .Content download |
wget |
Invoke-WebRequest |
same |
sc |
Set-Content |
sc file x BLANKS the file; sc.exe is services |
iex |
Invoke-Expression |
never with external input |
rm,ls,cat,cp,mv,echo |
PS cmdlets | Unix flags missing or change meaning |
In scripts write full cmdlet names or explicit .exe (curl.exe, sc.exe).
Errors: try/catch catches almost nothing
- try/catch only catches terminating errors. Use
-ErrorAction Stopon critical cmdlets or$ErrorActionPreference = 'Stop'at the top. -NoProfilewhen invoking scripts: user profiles inject unpredictable behavior.
Post-write verification (mandatory)
Get-Item $f | Select-Object Length
Get-Content $f -TotalCount 5
# JSON: Get-Content $f -Raw | ConvertFrom-Json | Out-Null
Size 0 or unexpected encoding = stop and investigate. "The command ran without error" is NOT verification.
Checklist before writing/deleting via PowerShell
- Target exists?
Test-Pathdone? - Backup if a real file?
Copy-Item $f "$f.bak". - Content validated (non-null, parses)?
- Explicit correct encoding? (UTF-8 no BOM =
WriteAllText) - Reading and writing the same file? (forbidden in one pipeline)
- Path variable checked non-empty?
-LiteralPath? - After writing, read back and confirmed?
Cascade
edge-cases: what if $var is empty / file missing / BOM present.shell-safe: sibling skill, same class of disaster in bash.
04 同仓库更多 Skills
montador-de-ideias
Use when assembling, expanding, or elevating a raw project idea or initial prompt into an ultra-detailed, first-principles dossier and compiled master prompt with journalistic OSINT market research, Tech Lead and Staff Architect justifications, atomic and modular hardening/optimization, and high-impact contact surfaces.
git-github-adaptive-engineering
Use when any task touches git history, GitHub issues/PRs/releases/CI, repo governance, or branch and merge decisions. Runs the Fase Zero situational-awareness battery, picks one of five delivery flows via the adaptive decision engine, and enforces commit/PR information-density standards. Orchestrates the gh, git-workflows, github-actions, pr, and debug/finish skills.
adaptive-agenda-calendar-routine-engine
Use when planning or executing work across hours, days, weeks, or sprints. Turns the calendar into a strict time-blocked agenda (HH:MM-HH:MM blocks carrying a routine profile, expected inputs, and a handoff output artifact), runs the 5-stage cognitive flow (Radar and Hunt -> Triage plus Steve Jobs conception -> workbench manifest -> >=32-cycle loop -> Close plus Open-Minded Scrum), and unfolds macro calendar milestones into micro agenda blocks through extensions/gcal/wrapper.py.
demo
Use when demonstrating a skill in a fixture project.
duplicate-skill
Use when testing duplicate skill name detection.
duplicate-skill
Use when testing duplicate skill name detection.