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.
Quellinformationen
- Repository
- stevenke1981/windows-agent-skill
- Letzte Quellaktivität
- 25. April 2026 um 03:12
- Erkannte Sprache von SKILL.md
- Chinesisch
- Sterne
- 1
- Forks
- 0
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
SKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- 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`（來源歸屬與授權）
Auf GitHub ansehen