fix: 为 9 个 skill 补全 L0/L1/L2 分层结构,版本号 +1

按照 desirecore-format.md 规范,为以下 skill 添加标准分层结构:
- docx (1.0.0→1.0.1), pdf (1.0.0→1.0.1), pptx (1.0.0→1.0.1), xlsx (1.0.0→1.0.1)
- frontend-design (1.0.0→1.0.1), mail-operations (1.0.0→1.0.1)
- environment-setup (1.1.0→1.1.1), web-access (1.1.0→1.1.1)
- manage-teams (1.2.0→1.2.1)

每个文件增加 L0(一句话摘要)、L1(概述与使用场景)、L2(详细规范)三层,
原有技术内容保持不变,metadata.updated_at 更新为 2026-04-13。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-13 15:33:56 +08:00
parent 9cde6c0c7d
commit aa6b1389fe
15 changed files with 439 additions and 236 deletions

View File

@@ -1,11 +1,11 @@
---
name: 删除智能体
description: 安全删除指定的智能体及其关联数据。删除前会验证智能体状态支持可选地删除所有会话历史。Use when 用户需要删除不再使用的智能体。
version: 2.4.0
version: 2.4.1
type: meta
risk_level: high
status: enabled
disable-model-invocation: true
disable-model-invocation: false
tags:
- agent
- deletion
@@ -81,11 +81,13 @@ delete-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 安全
**触发条件**:用户表达删除意图但未指定具体智能体
**操作**
- 调用 `GET /api/agents` 获取所有智能体列表
- 筛选出状态为 `offline``error` 的智能体(可安全删除)
- 标注出 `online`/`busy`/`recovery` 状态的智能体(需先停止)
**输出示例**
```
可删除的智能体:
1. 法律顾问助手 (legal-assistant) - 状态: offline
@@ -98,11 +100,13 @@ delete-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 安全
### 阶段 2确认用户意图与目标
**确认要点**
- 用户指定的智能体名称/ID
- 明确告知删除操作不可恢复
- 展示智能体基本信息供用户确认
**对话示例**
```
您要删除智能体 "法律顾问助手" (legal-assistant)。
⚠️ 警告:此操作不可恢复,该智能体的所有配置、技能、工具将被永久删除。
@@ -113,6 +117,7 @@ delete-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 安全
### 阶段 3询问删除选项
**询问内容**
```
是否同时删除该智能体的所有会话历史?
- 是:删除智能体及其所有对话记录
@@ -122,12 +127,14 @@ delete-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 安全
```
**参数映射**
- 用户选择"是" → `deleteRuns=true`
- 用户选择"否" → `deleteRuns=false`(默认)
### 阶段 4最终确认
**确认摘要**
```
请确认删除操作:
- 目标智能体:法律顾问助手 (legal-assistant)
@@ -142,9 +149,11 @@ delete-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 安全
**API 端点**`DELETE /api/agents/{agentId}`
**查询参数**
- `deleteRuns`: `'true'``'false'`
**请求示例**
```bash
curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
```
@@ -154,6 +163,7 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
### 阶段 6返回操作结果
**成功响应处理**
```json
{
"deleted": true,
@@ -172,6 +182,7 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
```
**结果报告模板**
```
✅ 智能体 "法律顾问助手" 已成功删除
@@ -189,16 +200,16 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
在阶段 1 列出智能体时,通过 `GET /api/agents` 筛选状态:
| 状态 | 可否删除 | 阶段 1 展示方式 |
|------|---------|---------------|
| `offline` / `error` | ✅ 可删除 | 列入"可删除"列表 |
| 状态 | 可否删除 | 阶段 1 展示方式 |
| ------------------------------ | ----------- | ------------------------------ |
| `offline` / `error` | ✅ 可删除 | 列入"可删除"列表 |
| `online` / `busy` / `recovery` | ❌ 需先停止 | 标注"需先停止",不进入后续流程 |
**停止活跃智能体的方式**:通过 Socket.IO 发送 `agent:shutdown` 事件:
```yaml
事件: agent:shutdown
数据: { "agentId": "<agent_id>" }
数据: { 'agentId': '<agent_id>' }
效果: 中止所有活跃会话 → 停止调度任务 → 状态转为 offline
```
@@ -206,20 +217,20 @@ curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
### API 错误码
| 错误码 | 场景 | 处理方式 |
|--------|------|---------|
| 400 | Agent ID 格式无效 | 提示用户检查智能体名称 |
| 404 | 智能体不存在 | 告知用户智能体已被删除或 ID 错误 |
| 409 | 智能体处于活跃状态API 返回 `Cannot delete agent "xxx": currently online` | 提示用户先在 UI 中停止智能体 |
| 500 | 服务器内部错误 | 提示用户稍后再试 |
| 错误码 | 场景 | 处理方式 |
| ------ | ---------------------------------------------------------------------------- | -------------------------------- |
| 400 | Agent ID 格式无效 | 提示用户检查智能体名称 |
| 404 | 智能体不存在 | 告知用户智能体已被删除或 ID 错误 |
| 409 | 智能体处于活跃状态API 返回 `Cannot delete agent "xxx": currently online` | 提示用户先在 UI 中停止智能体 |
| 500 | 服务器内部错误 | 提示用户稍后再试 |
## 删除范围说明
| 类别 | 删除内容 | 条件 |
|------|---------|------|
| **始终删除** | AgentFS 目录配置、人格、规则、技能、工具、记忆、用户偏好数据、内存状态调度器、队列、消息订阅、MCP 连接)、注册表条目 | 无条件 |
| **可选删除** | 会话历史、话题索引 | `deleteRuns=true` |
| **保留不删** | 其他智能体数据、用户配置、全局设置、市场缓存 | — |
| 类别 | 删除内容 | 条件 |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| **始终删除** | AgentFS 目录配置、人格、规则、技能、工具、记忆、用户偏好数据、内存状态调度器、队列、消息订阅、MCP 连接)、注册表条目 | 无条件 |
| **可选删除** | 会话历史、话题索引 | `deleteRuns=true` |
| **保留不删** | 其他智能体数据、用户配置、全局设置、市场缓存 | — |
## 权限要求