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.5.0
version: 2.5.1
type: procedural
risk_level: low
status: enabled
disable-model-invocation: true
disable-model-invocation: false
tags:
- agent
- discovery
@@ -77,6 +77,7 @@ discover-agent 是一个**流程型技能Procedural Skill**,赋予 Desir
### 阶段 1需求理解
**触发条件**(任一满足):
- 用户说"帮我找一个..."、"有没有..."、"谁能帮我..."
- 用户描述了一个任务但未指定具体智能体
- 用户说"有哪些智能体"、"看看都有谁"
@@ -86,23 +87,25 @@ discover-agent 是一个**流程型技能Procedural Skill**,赋予 Desir
从用户描述中提取以下维度:
| 维度 | 说明 | 示例 |
|------|------|------|
| `domain` | 专业领域 | 法律、财务、技术、教育 |
| 维度 | 说明 | 示例 |
| ----------- | -------- | ---------------------- |
| `domain` | 专业领域 | 法律、财务、技术、教育 |
| `task_type` | 任务类型 | 咨询、审查、分析、创作 |
| `keywords` | 关键词 | 合同、报表、代码、论文 |
| `urgency` | 紧急程度 | 日常 / 紧急 |
| `keywords` | 关键词 | 合同、报表、代码、论文 |
| `urgency` | 紧急程度 | 日常 / 紧急 |
### 阶段 2Agent 检索
**数据源**:调用 `GET /api/agents` 获取所有已注册的智能体列表。
**API 调用**
```bash
GET /api/agents
```
**返回数据中的关键字段**
- `id` — 智能体唯一标识
- `name` — 智能体名称
- `description` — 智能体描述
@@ -110,6 +113,7 @@ GET /api/agents
- `status` — 当前状态online/offline/busy
**过滤规则**
- 默认只展示 `status: online``status: offline` 的智能体
- 排除系统内部智能体(如 DesireCore 自身,除非用户显式要求)
@@ -117,14 +121,15 @@ GET /api/agents
根据以下维度综合判断匹配度(使用 LLM 语义理解,非公式计算):
| 维度 | 说明 |
|------|------|
| 维度 | 说明 |
| ---------- | --------------------------------------------------- |
| 描述相关性 | 智能体 description / persona 与用户需求的语义相关度 |
| 技能匹配度 | 智能体拥有的 skills 与任务类型的关联度 |
| 领域契合度 | 智能体专业领域与用户需求领域的契合程度 |
| 状态可用性 | 智能体当前状态online 优先于 offline |
| 技能匹配度 | 智能体拥有的 skills 与任务类型的关联度 |
| 领域契合度 | 智能体专业领域与用户需求领域的契合程度 |
| 状态可用性 | 智能体当前状态online 优先于 offline |
**展示规则**
- 高度匹配(明确适合该任务)→ 标为"推荐"
- 部分匹配(可能有帮助)→ 标为"可能相关"
- 无明显关联 → 不展示
@@ -132,6 +137,7 @@ GET /api/agents
### 阶段 4候选排序
**排序规则**
1. 按综合得分降序排列
2. 同分时 online 状态优先
3. 最多展示 5 个候选
@@ -196,12 +202,12 @@ GET /api/agents
**用户选择后的操作**
| 用户选择 | 后续操作 |
|---------|---------|
| 选择了某个智能体 | 切换到该智能体的对话,传递用户需求上下文 |
| 要求了解更多 | 调用 `GET /api/agents/:id` 获取详情,展示结构化信息(见下方) |
| 不满意候选 | 引导用户细化需求或建议创建新 Agent |
| 选择"创建新的" | 调用 create-agent 技能,传递已收集的需求信息 |
| 用户选择 | 后续操作 |
| ---------------- | ------------------------------------------------------------- |
| 选择了某个智能体 | 切换到该智能体的对话,传递用户需求上下文 |
| 要求了解更多 | 调用 `GET /api/agents/:id` 获取详情,展示结构化信息(见下方) |
| 不满意候选 | 引导用户细化需求或建议创建新 Agent |
| 选择"创建新的" | 调用 create-agent 技能,传递已收集的需求信息 |
**"了解更多"的实现**
@@ -238,23 +244,23 @@ GET /api/agents/{agentId}/persona
context_handoff:
source_agent: desirecore
target_agent: legal-assistant
user_intent: "帮我审查这份合同的风险点"
user_intent: '帮我审查这份合同的风险点'
```
### 与其他技能的协作
| 协作技能 | 协作方式 |
|---------|---------|
| create-agent | 无匹配时建议创建新 Agent传递用户需求作为初始信息 |
| task-management | 匹配成功后可自动创建任务并分配给目标 Agent |
| 协作技能 | 协作方式 |
| --------------- | -------------------------------------------------- |
| create-agent | 无匹配时建议创建新 Agent传递用户需求作为初始信息 |
| task-management | 匹配成功后可自动创建任务并分配给目标 Agent |
### 错误处理
| 错误场景 | 处理方式 |
|---------|---------|
| API 调用失败 | 提示网络错误,建议稍后重试 |
| Agent 列表为空 | 引导用户创建第一个智能体 |
| 用户描述过于模糊 | 追问具体需求,提供领域选项引导 |
| 错误场景 | 处理方式 |
| --------------------- | -------------------------------- |
| API 调用失败 | 提示网络错误,建议稍后重试 |
| Agent 列表为空 | 引导用户创建第一个智能体 |
| 用户描述过于模糊 | 追问具体需求,提供领域选项引导 |
| 推荐的 Agent 状态异常 | 标注状态,建议选择其他在线 Agent |
### 权限要求