SuperAPI AI 工具集

powertoys-module-verification

测试与质量

查看项目

更新于 10-16 00:31

技能介绍

用途:在 PowerToys 发布签核时,对单个模块的检查清单逐项验证(如 Color Picker 的 18 项、Command Palette 的 88 项),每项输出 PASS/FAIL/BLOCKED 判定并附证据(UIA 枚举、日志行、settings.json 差异、截图等)。清单由调用任务提供,本技能负责“如何驱动”。

主要能力:提供三类驱动技术选择器——改设置(编辑模块读取的 JSON,等待文件监视去抖后断言并还原)、操作 UI 元素(优先 UIA invoke/set-value,其次 PostMessage WM_KEYDOWN/CHAR)、触发模块动作(优先命名事件,最后才用 SendInput 组合键)。附带辅助脚本:pt-shared-events.ps1(56 个命名事件映射)、pt-sendinput-chord.ps1、pt-foreground-guard.ps1、pt-cmdpal-recycle.ps1、pt-admin-probe.ps1、pt-clipboard-diff.ps1、pt-explorer-com.ps1、pt-explorer-contextmenu.ps1、pt-shell-verbs.ps1、pt-state.ps1、pt-nonelevated.ps1。

使用方式:先阅读 references/winapp-ui-testing.md,再读 SKILL.md;检查 references/modules/<module>.md 是否存在;涉及资源管理器右键菜单的模块读 references/explorer-context-menu-flow.md;还需读 pre-flight.md、reporting-format.md、environment-setup.md 及对应 release-checklist/<module>.md。引导脚本示例:$skill = '<this skill folder>'; Get-ChildItem "$skill\scripts" -Filter '*.ps1' | ForEach-Object { . $_.FullName }。

适用场景:PowerToys 各模块发布前逐项验证与签核。

限制:判定分 PASS/FAIL/BLOCKED,BLOCKED 需标注具体原因(如 BLK-ENV、BLK-HARDWARE、BLK-DRAG-REQUIRED、BLK-DESTRUCTIVE、BLK-VISUAL-RENDER 等);SendInput 需已连接输入桌面且会抢占前台,无法注入系统保留组合键;命名事件仅在所属进程运行时存在;部分检查需交互式桌面或特定硬件。