powershell-windows

用途：该技能为在 Windows PowerShell 中编写脚本提供关键模式与常见陷阱参考，帮助 AI 智能体避免语法与运行时错误。

主要能力与要点：

1. 运算符语法：使用逻辑运算符时，每个 cmdlet 调用必须加括号，例如 if ((Test-Path "a") -or (Test-Path "b"))。
2. Unicode/Emoji 限制：脚本中只用 ASCII 字符，用 [OK]、[!]、[*]、[i]、[...] 等替代符号。
3. 空值检查：访问属性前先判断，如 $array -and $array.Count -gt 0、if ($text) { $text.Length }。
4. 字符串插值：复杂表达式先存入变量再输出，如 $value = $obj.prop.sub; Write-Output "Value: $value"。
5. 错误处理：$ErrorActionPreference 可选 Stop（开发快速失败）、Continue（生产脚本）、SilentlyContinue（预期错误）；try/catch 中不要在 try 内 return，用 finally 清理，在 try/catch 之后返回。
6. 文件路径：使用 Join-Path，如 Join-Path $env:USERPROFILE "file.txt"、Join-Path $ScriptDir "data"。
7. 数组操作：空数组 $array = @()，添加 $array += $item，ArrayList 用 $list.Add($item)。
8. JSON：ConvertTo-Json 始终指定 -Depth，如 -Depth 10；读取用 Get-Content "file.json" -Raw。
9. 常见错误：缺少括号、Unicode 字符、空对象、类型不匹配等对应修复方式。
10. 脚本模板：Set-StrictMode -Version Latest、$ErrorActionPreference = "Continue"、$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path，主逻辑放在 try 中，catch 用 Write-Warning 并 exit 1。

使用方式：作为可安装技能供 AI 智能体在生成或审查 PowerShell 脚本时参考。

适用场景：Windows 环境下的自动化脚本、文件与 JSON 处理、错误处理与路径拼接。

限制：资料未提供安装命令、收费、平台支持范围等具体信息，暂未提供。