清理 Agent Team 孤儿 Node 进程 Skill

清理 Agent Team 孤儿 Node 进程

概述

在 Windows / PowerShell 环境中，高强度调用 agent team 后，如果怀疑残留了孤儿 node.exe 进程，请在安装后的 skill 目录内使用本技能。

核心原则是：先审计，生成进程归属台账，再只清理可复核、可解释、已明确收窄范围的进程。

本技能用于 agent team 运行后的事后清理，不用于日常进程管理。

第一判断不是“有没有 node.exe”，而是资源消耗是否确实来自当前 agent run 的孤儿 Node。若高 CPU、磁盘或内存来自 Code.exe、rg.exe、tsserver.js、文件 watcher、AI 索引器、Windows Defender、构建产物或缓存目录，应转为 VSCode 排除规则、搜索索引、文件监听、TypeScript Server、Defender 排除项或缓存治理，不执行清理。

安全规则

默认先执行 dry-run。脚本默认模式只输出 JSON 进程归属台账，不停止任何进程。
禁止按 node.exe、包装器命令或单一关键词批量杀进程。
先诊断资源来源，不先 kill。不是孤儿 Node 的问题，就不要套用本技能清理。
判断归属时要同时看 PID、PPID、CommandLine、ExecutablePath、CreationTime、工作目录线索、监听端口、父进程是否仍存活，以及 agent 关键词命中情况。
Agent run 归属必须能回到 runId、sessionId、父 agent、任务名、checkpoint、执行日志、trace、失败重试 / scheduled retry、人工确认记录、监听端口、PPID 和命令行中的多个证据点；只有一个线索时只能记为待审计。
证据缺失时要降低置信度。工作目录无法安全读取时，保留为未解析线索，不要编造确定性结论。
清理前必须保存执行日志、checkpoint 位置和 dry-run 台账。涉及监听端口、长期服务关键词、父进程仍存活或归属不清的高风险停止，必须先取得人工确认。
只有显式传入 -Apply、足够窄的 -IncludePattern，并保存 -OutputPath 台账时，才允许调用 Stop-Process。
-Force 只能作为第二道门：普通停止路径失败后，且 PID 仍然可复核时才使用。
保护长期服务：MCP gateway、工具市场、记忆服务、监控服务、定时任务、queue worker、SSE / chat session、RAG / vector 服务、IDE / 编辑器扩展宿主、用户明确保留的开发服务器和包管理器后台任务默认不清理。
清理后必须重新采样目标 PID 和监听端口，确认结果后再说环境已清理。

工作流程

先诊断资源来源并定义清理范围，不要一上来碰进程。
- 先区分资源来源是 node.exe、Code.exe、rg.exe、tsserver.js、watcher、AI 索引器、Windows Defender，还是构建产物 / 缓存目录引起的扫描。
- 如果不是当前 agent run 遗留的孤儿 Node，转去治理 files.exclude、search.exclude、files.watcherExclude、TypeScript Server 内存 / watch 配置、Defender 排除项或缓存清理。
- 刚结束的是哪一次 agent team 运行？
- 哪个 runId、sessionId、父 agent、任务名、checkpoint、日志片段、trace、失败重试 / scheduled retry、人工确认记录、工作区或命令片段能识别本次任务拥有的进程？
- 哪些长期运行的开发服务器、编辑器、包管理器或终端任务必须排除？
生成进程归属台账。

powershell -ExecutionPolicy Bypass -File scripts/agent-team-node-cleanup.ps1 -OutputPath .\node-ledger.dry-run.json

在执行清理前，逐行复核台账。

需要重点检查这些字段：

脚本字段之外，还要在本次执行记录里补充 agent run 维度证据：runId / sessionId、父 agent 或父任务、checkpoint、日志位置、trace、失败重试 / scheduled retry 状态、人工确认结论、端口用途、PPID 链路和完整命令行。补不齐这些证据时，不要把进程升级为可清理候选。

只有收窄候选列表后，才允许执行清理。

powershell -ExecutionPolicy Bypass -File scripts/agent-team-node-cleanup.ps1 -IncludePattern "run-id-fragment|session-id-fragment|workspace-fragment|task-token" -ExcludePattern "vite|next|storybook|mcp|gateway|tool-market|memory|monitor|cron|scheduler|queue|sse|rag|vector|extensionHost|tsserver|keep-alive" -MinAgeMinutes 30 -OutputPath .\node-ledger.apply.json -Apply

脚本会拒绝没有 -IncludePattern 或没有 -OutputPath 的 -Apply。这样可以强制留下可复核台账，避免误触发宽泛清理。

只有第二道门才使用强制终止：

powershell -ExecutionPolicy Bypass -File scripts/agent-team-node-cleanup.ps1 -IncludePattern "run-id-fragment|session-id-fragment|workspace-fragment|task-token" -ExcludePattern "vite|next|storybook|mcp|gateway|tool-market|memory|monitor|cron|scheduler|queue|sse|rag|vector|extensionHost|tsserver" -MinAgeMinutes 30 -OutputPath .\node-ledger.force.json -Apply -Force

复核重新采样结果。
- 确认 Verification.RemainingCandidatePids 为空；如果不为空，逐个解释剩余 PID。
- 如果终端、编辑器或 MCP 运行时仍然明显变慢或噪音很大，再跑一次 dry-run 台账。
- 如果已停止的 PID 重新出现，检查父级服务，不要重复盲目清理。

候选规则

内置脚本只有在所有安全检查通过后，才会把进程标记为 candidate：

它是 node.exe 进程；
它不是当前 PowerShell 进程、脚本宿主进程，也不在当前父进程链上；
它的存活时间达到 -MinAgeMinutes；
它至少命中一个 -IncludePattern；
它没有命中任何 -ExcludePattern；
它的父进程已经不存在；
它没有监听 TCP 端口。

其他进程都会保持为 audit-only 或 excluded。

常见错误

资源索引

| 路径 | 用途 | | :------------------------------------ | :-------------------------------------- | | scripts/agent-team-node-cleanup.ps1 | Windows PowerShell 审计与门禁清理脚本。 |

Agent Skills: 清理 Agent Team 孤儿 Node 进程

Install this agent skill to your local

Skill Files