PowerShell Windows Skill

一个用于 Windows PowerShell 系统操作的 OpenClaw 技能。

为 AI Agent 提供全面的 Windows 系统操作能力——包括 PowerShell 脚本生成、命令执行规范、安全检查和分领域操作参考文档。

✨ 特性

• 执行约定 — 编码规范（UTF-8 BOM）、命令格式、平台判断
• 安全检查 — 7 类高影响操作，执行前强制确认流程
• 脚本生成 — 参数化模板，支持 -WhatIf、try/catch、环境变量最佳实践
• 12 个操作领域 — 文件操作、系统信息、服务、注册表、网络、用户权限、进程、软件包管理、任务计划、磁盘存储、事件日志、系统更新

📋 操作领域

领域	核心命令
文件/文件夹	Get-ChildItem、Copy-Item、Select-String、批量重命名
系统信息与硬件	Get-ComputerInfo、WMI/CIM 查询、环境变量
服务管理	Get-Service、Start/Stop/Restart-Service、启动类型
注册表	Get/Set/New-Remove-ItemProperty、常用注册表路径
网络配置	Get-NetAdapter、IP/DNS 配置、防火墙规则、端口测试
用户与权限	Get-LocalUser、组管理、ACL、管理员权限检测
进程管理	Get-Process、Start/Stop-Process、资源监控
软件包管理	Winget、Chocolatey
任务计划	Get-ScheduledTask、Register-ScheduledTask、触发器配置
磁盘与存储	Get-Disk/Volume/Partition、大文件夹扫描
事件日志	Get-EventLog、Get-WinEvent、FilterHashtable 筛选
系统更新	PSWindowsUpdate 模块、更新历史

🔒 安全策略

高影响操作（停用服务、修改注册表、删除文件、关闭防火墙、修改用户、停止关键进程、修改环境变量）遵循以下流程：

1. 分析影响范围 — 列出操作将影响的用户/系统/服务
2. 判断是否为高影响 — 对照 7 类高影响操作清单
3. 高风险操作 — 向用户说明风险和影响范围，等待确认后再执行
4. 普通操作 — 直接执行，异常时记录并报告

📦 安装

通过 SkillHub 安装（推荐）

skillhub install powershell-windows-skill

手动安装

1. 下载或克隆本仓库
2. 将 powershell-windows-skill/ 文件夹复制到 ~/.qclaw/skills/
3. 重启 OpenClaw

📂 文件结构

powershell-windows-skill/
├── SKILL.md                  # 核心指南：执行约定、安全检查、脚本模板
└── references/
    └── operations.md         # 分领域操作参考（12 个领域）

📄 许可证

本项目采用 MIT 和 Apache 2.0 双重许可。你可以任选其一使用。