windows-agent
Master orchestrator for Windows automation. Routes tasks across GUI automation (UIA), PowerShell primitives, COM automation (Office/Shell), and remote execution (WinRM). Use when the user asks to automate, inspect, or control anything on a Windows host.
Source facts
- Repository
- stevenke1981/windows-agent-skill
- Last source activity
- April 25, 2026 at 03:12
- Detected SKILL.md language
- Chinese
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- windows-agent
- description
- Master orchestrator for Windows automation. Routes tasks across GUI automation (UIA), PowerShell primitives, COM automation (Office/Shell), and remote execution (WinRM). Use when the user asks to automate, inspect, or control anything on a Windows host.
- version
- 1.0.0
- license
- MIT
- authors
- ["stevenke1981"]
- sources
- ["https://github.com/CursorTouch/Windows-Use","https://github.com/itc-ou-shigou/winclaw","https://github.com/microsoft/skills","https://github.com/VoltAgent/awesome-agent-skills","https://github.com/aloth/PowerSkills","https://github.com/microsoft/cua_skill"]
# Windows Agent — Master Skill
## 觸發時機
當使用者提到以下任何情境時啟動此 Skill：
- 「自動化 Windows 操作」
- 「控制 UI / 視窗 / 程式」
- 「執行 PowerShell 腳本」
- 「操作 Excel / Word / Outlook」
- 「新增排程工作」
- 「修改登錄檔」
- 「遠端執行命令」
## 決策樹（先讀這個）
詳見 `skills/windows-agent/references/decision-tree.md`
```
有 GUI 元素需操作、無 API 可用？
→ gui-automation
Shell / 檔案系統 / 服務 / 登錄檔？
→ powershell-patterns 或 registry-safe-edit
Office 文件操作（Word/Excel/Outlook）？
→ com-automation
排程 / 週期性任務？
→ scheduled-tasks
遠端主機操作？
→ winrm-remoting
```
**優先順序：** PowerShell > COM > GUI（可靠性由高到低）
## 安全規則（不可違反）
1. 破壞性動詞（Remove-Item、Stop-Service、Restart-Computer 等）預設 `-WhatIf`
2. 每次動作記錄至 `%LOCALAPPDATA%\windows-agent\audit.jsonl`
3. 使用者設定檔外的路徑操作需明確確認
4. 允許清單見 `references/safety-checklist.md`
## 動作 Schema
所有子 Skill 輸出動作需符合 `references/action-schema.json` 格式。
## 環境假設
- Windows 10/11，PowerShell 7+，Python 3.11+
- 首次使用前執行 `scripts/bootstrap.ps1`
## 子 Skills
| Skill | 路徑 | 用途 |
|-------|------|------|
| gui-automation | `skills/gui-automation/SKILL.md` | 截圖 + UIA + 點擊/輸入迴圈 |
| powershell-patterns | `skills/powershell-patterns/SKILL.md` | 慣用 PS，含錯誤處理 |
| com-automation | `skills/com-automation/SKILL.md` | Word/Excel/Outlook/Shell |
| winrm-remoting | `skills/winrm-remoting/SKILL.md` | 遠端工作階段 |
| scheduled-tasks | `skills/scheduled-tasks/SKILL.md` | 排程工作 |
| registry-safe-edit | `skills/registry-safe-edit/SKILL.md` | 可回滾登錄檔編輯 |
## Claude 使用指引
1. 讀取決策樹，選擇**一個**子 Skill
2. 僅載入對應子 Skill 的 SKILL.md
3. 破壞性操作前重讀 `safety-checklist.md`
4. GUI 與 PowerShell 均可時，**優先選 PowerShell**
## 參考資料
- `skills/windows-agent/references/decision-tree.md`
- `skills/windows-agent/references/safety-checklist.md`
- `skills/windows-agent/references/action-schema.json`
- `docs/architecture.md`（來源歸屬與授權）
View on GitHub