内容
# PowerSkills
[](https://github.com/aloth/PowerSkills/blob/main/LICENSE)
[](https://github.com/aloth/PowerSkills/releases)
[](https://docs.microsoft.com/en-us/powershell/)
[](https://github.com/aloth/PowerSkills)
[](https://github.com/aloth/PowerSkills/stargazers)
[](https://agentskills.io)
Windows 智能代理能力 — Outlook, Edge 浏览器, 桌面自动化, 以及 shell 命令作为结构化 JSON 技能。
## 安装
```
git clone https://github.com/aloth/PowerSkills
```
每个技能都有一个 `SKILL.md` 用于自我发现。不需要依赖。
### 对于 AI 代理（通过 AgentSkills）
```bash
npx skills add aloth/PowerSkills
```
## 快速开始
```powershell
# 列出可用技能
.\powerskills.ps1 list
# 获取技能帮助
.\powerskills.ps1 outlook help
# 运行操作
.\powerskills.ps1 outlook inbox --limit 10
.\powerskills.ps1 browser tabs
.\powerskills.ps1 desktop screenshot --out-file screen.png
.\powerskills.ps1 system exec --command "whoami"
.\powerskills.ps1 workiq check
.\powerskills.ps1 workiq ask --question "What's on my calendar tomorrow?"
```
## 技能
| 技能 | 描述 |
|-------|-------------|
| `outlook` | 通过 Outlook COM 实现电子邮件和日历 |
| `workiq` | 通过 [Work IQ](https://github.com/microsoft/work-iq) CLI 实现 Microsoft 365（邮件/日历/Teams/SharePoint/OneDrive） |
| `browser` | 通过 CDP（Chrome DevTools Protocol）实现 Edge 自动化 |
| `desktop` | 截图，窗口管理，键盘操作 |
| `system` | Shell 命令，进程，系统信息 |
## 输出格式
所有命令返回具有一致信封的 JSON：
```json
{
"status": "success",
"exit_code": 0,
"data": { ... },
"timestamp": "2026-03-06T16:00:00+01:00"
}
```
## 需求
- Windows 10/11
- PowerShell 5.1+
- Microsoft Outlook（用于 `outlook` 技能）
- 带有 `--remote-debugging-port=9222` 的 Microsoft Edge（用于 `browser` 技能）
- Node.js + npm（用于 `workiq install`；如果您通过其他方式安装 Work IQ，请跳过）
### 执行策略
如果脚本被阻止（`UnauthorizedAccess` 错误），请设置执行策略：
```powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
```
或使用 bypass 运行：
```powershell
powershell -ExecutionPolicy Bypass -File .\powerskills.ps1 list
```
## 独立技能
每个技能可以直接调用，无需 `powerskills.ps1`:
```powershell
.\skills\outlook\outlook.ps1 inbox --limit 5
.\skills\system\system.ps1 info
.\skills\browser\browser.ps1 tabs
```
独立模式使用 `lib\bootstrap.ps1` 进行参数解析和 JSON 输出。
### Edge CDP 设置
```powershell
# 启动 Edge 并启用调试
Start-Process "msedge" -ArgumentList "--remote-debugging-port=9222"
```
## 配置
编辑 `config.json`:
```json
{
"edge_debug_port": 9222,
"default_timeout": 30,
"outlook_body_max_chars": 5000,
"output_dir": ""
}
```
## 对于 AI 代理
每个技能都有一个 `SKILL.md`，包含操作文档。将您的代理指向 `skills/<name>/SKILL.md` 以实现结构化能力发现。
### 代理集成
添加到您的技能目录或直接引用：
```yaml
# SKILL.md 参考
skills:
- name: powerskills
description: Windows 自动化通过 PowerShell（Outlook，Edge，桌面）
location: /path/to/PowerSkills/
```
## 项目结构
```
PowerSkills/
├── powerskills.ps1 # CLI 入口点/调度器
├── config.json # 配置
├── lib/
│ └── bootstrap.ps1 # 共享参数解析和 JSON 输出帮助程序
├── assets/
│ └── powerskills-ai-agents-windows-powershell-automation.jpg
├── skills/
│ ├── outlook/
│ │ ├── SKILL.md # 代理可读技能文档
│ │ └── outlook.ps1 # Outlook COM 自动化
│ ├── workiq/
│ │ ├── SKILL.md
│ │ └── workiq.ps1 # Microsoft 365 通过 Work IQ CLI
│ ├── browser/
│ │ ├── SKILL.md
│ │ └── browser.ps1 # Edge CDP 自动化
│ ├── desktop/
│ │ ├── SKILL.md
│ │ └── desktop.ps1 # Win32 窗口/截图/剪贴板
│ └── system/
│ ├── SKILL.md
│ └── system.ps1 # 系统信息，进程，执行
├── tests/
│ └── test-all.ps1 # 测试套件（-SkipBrowser，-SkipOutlook，-SkipWorkIq）
├── SKILL.md # 根技能元数据
├── LICENSE # MIT
└── README.md
```
## 贡献
欢迎贡献！以下是您可以帮助的方式：
- **报告错误** - 使用 Bug Report 模板打开 [问题](https://github.com/aloth/PowerSkills/issues)
- **请求功能** - 通过 [功能请求](https://github.com/aloth/PowerSkills/issues) 建议新操作或技能
- **添加技能** - 在 `skills/` 下创建新文件夹，包含 `.ps1` 和 `SKILL.md`
- **改进现有技能** - 更好的错误处理，新操作，文档修复
- **加入讨论** - 在 [讨论](https://github.com/aloth/PowerSkills/discussions) 中分享想法
添加或修改技能时，请遵循现有模式：
1. 使用 `lib\bootstrap.ps1` 进行参数解析和 JSON 输出
2. 通过 `Write-SkillResult` / `Write-SkillError` 返回结果
3. 包含一个带有操作文档的 `SKILL.md`
4. 测试调度器和独立模式
## 许可证
MIT
MCP 市场