| 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（可靠性由高到低）
安全規則（不可違反）
- 破壞性動詞（Remove-Item、Stop-Service、Restart-Computer 等）預設
-WhatIf
- 每次動作記錄至
%LOCALAPPDATA%\windows-agent\audit.jsonl
- 使用者設定檔外的路徑操作需明確確認
- 允許清單見
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 使用指引
- 讀取決策樹，選擇一個子 Skill
- 僅載入對應子 Skill 的 SKILL.md
- 破壞性操作前重讀
safety-checklist.md
- GUI 與 PowerShell 均可時，優先選 PowerShell
參考資料
skills/windows-agent/references/decision-tree.mdskills/windows-agent/references/safety-checklist.mdskills/windows-agent/references/action-schema.jsondocs/architecture.md（來源歸屬與授權）
