mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-07-23 04:44:36 +08:00

Files

Yige d52e61e041 perf(skills): 智能体 CRUD 四技能提示词改写压缩（功能不变，~65%） (#56 )

## 摘要 / Summary

### 中文

四个智能体管理技能（create/update/delete/discover-agent）改用 `ManageAgent`
内置工具后，正文与工具契约大量重叠——ManageAgent 的 description + params 已**常驻每次 query
的上下文**，声明了五个 action 语义、参数约束、权限硬边界、错误语义、字段级合并、确认行为、list/get
返回格式；技能正文里再复述即冗余。本次对四技能做**强改写·语境融合**压缩：

- 与工具契约重复的说明（参数/权限/错误码/确认行为/成功返回话术）**改写融入对应流程步骤**（如错误处理表 → 阶段一句、确认行为 →
阶段一句），不再照抄、不再表格化。
- 装饰性 ASCII 流程框图 → 一行文字流程；update 内部两张重复更新表 → 合并；YAML
元数据块（diff_metadata/context_handoff）融入流程；冗长示例（create 三份 JSON、update 附录 4
示例、discover ASCII 卡片）就地精简为代表示意。
- **不外置 references、不净删除任何内容**：所有决策/领域/交互意图完整保留——领域匹配表、persona/principles
的 L0/L1/L2 生成规范、update 两路径分流与字段级合并 vs 整体替换、防幻觉改名、回滚流程、discover
需求维度与无匹配衔接 create 等核心一字未丢。

zh 正文合计 **26542 → 9196 字符（降 ~65%）**；中英双份同步改写、逐段对齐，重算 i18n
source_hash（validate-i18n 通过）。版本 create 2.5.1 / update 3.1.2 / delete
2.5.1 / discover 2.6.1，manifest 1.2.12。

### English

After the four agent-management skills adopted the `ManageAgent` builtin
tool, their bodies heavily duplicated the tool contract — ManageAgent's
description + params are **resident in every query's context** (action
semantics, param constraints, permission hard-boundaries, error
semantics, field-level merge, confirmation behavior, list/get return
formats). This PR compresses all four via **aggressive rewrite +
contextual fusion**: contract-duplicating text is rewritten into the
relevant flow steps (not copied, not tabularized), decorative ASCII flow
boxes become one-line text, update's two duplicate tables are merged,
YAML metadata blocks are folded in, and long examples are trimmed in
place to representative sketches. **No references externalization, no
net deletion** — every decision/domain/interaction intent is preserved
(domain matching table, persona/principles L0/L1/L2 generation spec,
update's two-path split and field-level-merge-vs-full-replace,
anti-hallucination rename, rollback flow, discover's need dimensions and
create hand-off). zh bodies total **26542 → 9196 chars (~65% down)**;
both locales rewritten and aligned, i18n source hashes recomputed
(validate-i18n passes). Versions bumped, manifest 1.2.12.

2026-07-19 15:16:43 +08:00

3.4 KiB

Raw Blame History

discover-agent 技能

L0：一句话摘要

根据用户需求描述，在已注册的智能体中匹配并推荐最合适的 Agent。

L1：概述

流程型技能：理解需求 → ManageAgent(action='list') 检索 → 语义匹配评分 → 排序展示 → 引导选择；无匹配时自动衔接 create-agent。价值在工具给不了的部分：需求语义匹配、候选排序与呈现、无匹配时的创建衔接。list / get 只读免审批。

L2：详细规范

流程：需求理解 → 检索 → 匹配评估 → 排序 → 展示 → 引导选择。

阶段 1：需求理解

触发（任一）：用户说"帮我找一个… / 有没有… / 谁能帮我…"、描述任务但未指定智能体、"有哪些智能体"，或系统检测到需求与当前 Agent 能力不匹配。从描述提取维度：domain（领域，如法律/财务/技术/教育）、task_type（咨询/审查/分析/创作）、keywords（合同/报表/代码/论文…）、urgency（日常/紧急）。

阶段 2：检索

ManageAgent(action='list') 取全部已注册智能体（返回 name / id / status / description 的紧凑列表）。过滤：默认展示 offline 之外的，offline 仅在无更优候选时补充；排除系统内部智能体（如 DesireCore 自身，除非用户显式要求）。

阶段 3：匹配评估

用 LLM 语义理解综合判断匹配度（非公式计算）：description / persona 与需求的相关性、skills 与任务类型的关联、领域契合度、状态可用性（online 优先）。展示分级：高度匹配 → 标"推荐"，部分匹配 → 标"可能相关"，无明显关联 → 不展示。

阶段 4：排序

综合得分降序；同分 online 优先；最多展示 5 个候选。

阶段 5：结果展示

有匹配：列出候选，每个含名称、描述、关键技能、状态、匹配度，请用户选择或进一步细化需求。例如「1. 法律顾问助手（92%）——合同审查与法律风险评估；技能：合同审查 / 风险评估 / 法律研究；在线」。
无匹配：告知未找到，给三选项——用更具体描述重试 / 创建新专业智能体（衔接 create-agent）/ 浏览全部。
浏览模式（用户要看全部）：按在线 / 离线分组列出名称 + 描述，问是否要看某个的详情。

阶段 6：引导选择

选中某智能体 → 切换到该智能体的对话，传递用户需求上下文（source / target / user_intent）。
要求了解更多 → ManageAgent(action='get', id) 取详情（名称 / 描述 / 状态 / 版本 / 技能数 / 工具数 / Git 状态），以自然语言或表格呈现关键信息，问是否对话。
不满意候选 → 引导细化需求或建议创建新 Agent。
选"创建新的" → 调 create-agent 技能，传递已收集的需求信息。

协作与错误处理

协作：无匹配衔接 create-agent（传需求作初始信息）；匹配成功后可创建任务并分配给目标 Agent。
错误：工具调用失败 → 提示错误、建议重试；Agent 列表为空 → 引导创建第一个智能体；需求过于模糊 → 追问并给领域选项引导；get 返回「智能体不存在: 」→ 回退 list 重新确认可用智能体；推荐 Agent 状态异常 → 标注状态并建议选在线的。
list / get 均为只读、免审批、无风险，一律经 ManageAgent 完成。

3.4 KiB Raw Blame History Unescape Escape