<!-- locale: zh-CN -->

# delete-agent 技能

## L0：一句话摘要

安全删除指定的智能体及其关联数据（文件系统、内存状态、可选会话历史）。

## L1：概述

元技能：列出候选 → 确认意图（不可恢复）→ 询问是否删历史 → `ManageAgent(action='delete')` 执行。用于清理不再使用、测试性/实验性、或需释放存储的智能体。价值在工具给不了的部分：候选筛选与状态引导、删除前的意图确认。工具层多重拒绝（核心体 / 自身 / 活跃态）与团队级联由工具保证。

## L2：详细规范

流程：列出可选智能体 → 确认意图与目标 → 询问是否删历史 → 执行删除 → 回执。

### 阶段 1：列出候选

用户未指定具体智能体时，`ManageAgent(action='list')` 取列表，按状态分组展示：`offline` / `error` 可安全删除；`online` / `busy` / `recovery` 标注"需先停止"（会被工具拒绝），不进入后续流程。需详情用 `ManageAgent(action='get', id)`。例如：

```
可删除：法律顾问助手 (legal-assistant, offline)、测试机器人 (test-bot, offline)
需先停止：数据分析师 (data-analyst, online)
```

### 阶段 2：确认意图

向用户确认目标智能体（名称/ID），**明确告知不可恢复**（配置、技能、工具将永久删除），展示基本信息，等用户确认。

### 阶段 3：询问删除选项

问是否同时删除该智能体的全部会话历史：是 → `deleteRuns=true`；否 → `deleteRuns=false`（默认、可省略，保留历史）。

### 阶段 4：执行删除

调用前再次确认目标和 `deleteRuns` 选择。工具会把删除提交到当前审批链；是否出现额外弹窗取决于调用方的审批模式，不要在没有看到审批事件时声称“一定会弹窗”。执行：

```
ManageAgent(action='delete', id='legal-assistant', deleteRuns=true)
```

确认后完成删除，含团队级联：目标是组长的团队自动解散，是成员的自动移除。

### 阶段 5：回执

据工具返回（已清理路径、删除会话数、内存清理详情）生成用户友好报告（不暴露内部路径），例如「✅ 已删除 XXX；清理了文件系统 / 调度 / 订阅 / MCP / N 条会话历史 / 团队级联」。

### 删除范围与边界

- **始终删**：AgentFS 目录（配置/人格/规则/技能/工具/记忆）、用户偏好数据、内存状态（调度器/队列/消息订阅/MCP 连接）、注册表条目。**可选删**（`deleteRuns=true`）：会话历史与话题索引。**团队级联**（自动）：组长 → 解散团队、成员 → 移除。**保留不删**：其他智能体、用户配置、全局设置、市场缓存。
- 工具拒绝场景据此向用户解释并给下一步：核心智能体（desirecore / core / 绑定 UUID）不可删；不能删调用方自身；活跃态（online/busy/recovery）需先在 UI 停止或等其空闲；ID 不存在则智能体已删或 ID 有误。
- 一律经 `ManageAgent`（`action='list' | 'get' | 'delete'`）完成；delete 为高风险操作，必须先完成本技能的明确意图确认，并遵循工具返回的审批结果。
