mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-09-05 23:43:58 +08:00

Files

Yige 22b128f185 feat(skills): 独立维护智能体生命周期操作说明 (#90 )

## 中文

### 变更
- 新增 `clone-agent` 内置 Skill，覆盖私有数据复制和团队分发边界
- 将 Smart routing、reasoning、头像和确认流程迁入 action-specific Skills
- 修正 `update-agent` 与当前 ManageAgent 白名单的漂移
- 保持所有市场 Skill 按需加载，并加入 builtin 清单

### 验证
- `uv run --quiet scripts/i18n/test_validate_i18n.py`
- `uv run --quiet scripts/i18n/validate-i18n.py`
- `uv run --quiet scripts/i18n/translate.py --check`
- 公共信息边界检查通过

## English

### Changes
- Add the built-in `clone-agent` Skill for private-data copy and
team-distribution boundaries
- Move Smart routing, reasoning, avatar, and confirmation workflows into
action-specific Skills
- Align `update-agent` with the current ManageAgent configuration
whitelist
- Keep every marketplace Skill on-demand and add the new Skill to the
built-in manifest

### Verification
- `uv run --quiet scripts/i18n/test_validate_i18n.py`
- `uv run --quiet scripts/i18n/validate-i18n.py`
- `uv run --quiet scripts/i18n/translate.py --check`
- Public information boundary review passed

2026-08-25 16:13:09 +08:00

3.1 KiB

Raw Blame History

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 为高风险操作，必须先完成本技能的明确意图确认，并遵循工具返回的审批结果。

3.1 KiB Raw Blame History Unescape Escape