用途:在 Windows / PowerShell 环境中,高强度调用 agent team 后,若怀疑残留可归属当前 run 的 node.exe、npx.exe、命令包装器(cmd.exe、powershell.exe、pwsh.exe、conhost.exe)、agent browser 浏览器进程(chrome.exe / msedge.exe / chromium.exe)或 agent browser CLI 进程,可在安装后的 skill 目录内使用本技能。它用于事后清理,不用于日常进程管理。
主要能力:随 skill 分发的 scripts/agent-team-node-cleanup.ps1 结合 Windows 原生进程信息做审计。默认模式只把 JSON 审计结果输出到标准输出,不停止进程、不传 -OutputPath。判断归属时综合 PID、PPID、CommandLine、ExecutablePath、CreationTime、工作目录线索、监听端口、父进程存活与 agent 关键词命中。WorkBuddy 分组区分高置信度显式池与 topology-inferred 中置信度池,会话归属用 current / not-current / unknown 三态,监听器观察用 known / unknown 两态。
使用方式:先诊断资源来源,确认是否确为当前 agent run 残留;再运行 powershell -ExecutionPolicy Bypass -File scripts/agent-team-node-cleanup.ps1 做 dry-run,逐行复核输出。清理需显式 -Apply,并把 -OutputPath 指向系统临时目录,在同一段 try/finally 中删除;通用路径必须提供足够窄的 -IncludePattern,WorkBuddy 路径必须用唯一 -WorkBuddyPoolId 或 -WorkBuddyPoolPid,并同时传入 -ConfirmWorkBuddyPoolNotCurrent 与 -ConfirmWorkBuddyPoolIdle。
限制:禁止按进程名或单一关键词批量杀进程;WorkBuddy daemon、sidecar、MCP server、UI / renderer、未知角色、嵌套 pool、shell snapshot 及受保护长期服务不可清理;监听器查询失败必须阻断;-Force 仅作第二道门;卡死一次性 Node CLI 恢复需 -EnableStuckOneShotRecovery 且满足精确命令、CPU 增量与无端口等条件,且不自动停止父 cmd.exe。清理后须重新采样确认。