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.
معلومات المصدر
- المستودع
- stevenke1981/windows-agent-skill
- آخر نشاط في المصدر
- ٢٥ أبريل ٢٠٢٦ في ٠٣:١٢
- لغة SKILL.md المكتشفة
- الصينية
- النجوم
- ١
- التفرعات
- ٠
خيارات التثبيت
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
مراجعة ملفات المصدر
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
عرض SKILL.md
SKILL.md
تعليمات المصدر · معاينة للقراءة فقط- 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`（來源歸屬與授權）
عرض على GitHub