From 49aa86bdb5cdb79306fd39260f14f03479b08508 Mon Sep 17 00:00:00 2001 From: yi-ge Date: Sun, 22 Feb 2026 14:56:14 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=88=9D=E5=A7=8B=E5=8C=96=20DesireCor?= =?UTF-8?q?e=20=E6=A0=B8=E5=BF=83=E6=99=BA=E8=83=BD=E4=BD=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- agent.json | 30 +++ heartbeat/HEARTBEAT.md | 30 +++ heartbeat/sources/.gitkeep | 0 memory/_index.md | 5 + persona.md | 14 ++ principles.md | 16 ++ schedules/.gitkeep | 0 skills/_index.md | 88 ++++++++ skills/_protected-paths.yaml | 104 +++++++++ skills/create-agent/SKILL.md | 257 +++++++++++++++++++++++ skills/delete-agent/SKILL.md | 246 ++++++++++++++++++++++ skills/discover-agent/SKILL.md | 229 ++++++++++++++++++++ skills/self-evolve/SKILL.md | 361 ++++++++++++++++++++++++++++++++ skills/task-management/SKILL.md | 243 +++++++++++++++++++++ skills/update-agent/SKILL.md | 325 ++++++++++++++++++++++++++++ tools/_index.md | 4 + 16 files changed, 1952 insertions(+) create mode 100644 agent.json create mode 100644 heartbeat/HEARTBEAT.md create mode 100644 heartbeat/sources/.gitkeep create mode 100644 memory/_index.md create mode 100644 persona.md create mode 100644 principles.md create mode 100644 schedules/.gitkeep create mode 100644 skills/_index.md create mode 100644 skills/_protected-paths.yaml create mode 100644 skills/create-agent/SKILL.md create mode 100644 skills/delete-agent/SKILL.md create mode 100644 skills/discover-agent/SKILL.md create mode 100644 skills/self-evolve/SKILL.md create mode 100644 skills/task-management/SKILL.md create mode 100644 skills/update-agent/SKILL.md create mode 100644 tools/_index.md diff --git a/agent.json b/agent.json new file mode 100644 index 0000000..9f7574d --- /dev/null +++ b/agent.json @@ -0,0 +1,30 @@ +{ + "$schema": "http://desirecore/schemas/agent.json", + "id": "7da73b7f-bb08-4e7b-a3cf-5d4af6e22c7f", + "name": "DesireCore", + "version": "1.0.0", + "description": "系统中枢调度器，负责任务分发、Agent 编排与全局状态监控", + "author": "DesireCore Team", + "runtime": { + "engine": "pi-agent-core" + }, + "privacy": { + "default_scope": "core", + "sharing_requires_explicit_consent": true + }, + "heartbeat": { + "enabled": true, + "config_ref": "heartbeat/HEARTBEAT.md" + }, + "default_enabled": { + "skills": [ + "create-agent", + "update-agent", + "delete-agent", + "self-evolve", + "task-management", + "discover-agent" + ], + "tools": [] + } +} diff --git a/heartbeat/HEARTBEAT.md b/heartbeat/HEARTBEAT.md new file mode 100644 index 0000000..76e8b82 --- /dev/null +++ b/heartbeat/HEARTBEAT.md @@ -0,0 +1,30 @@ +--- +name: 系统健康巡检 +description: 检查 Agent 健康状态、汇总待办、生成摘要 +schedule: "*/20 * * * *" +enabled: true +sources: + - agent-health + - pending-tasks +--- + +# 心跳配置 — DesireCore + +## 调度规则 + +- 频率：每 20 分钟触发一次 +- 触发条件：系统启动时 + 定时调度 +- 静默时段：00:00 - 07:00（不主动打扰用户） + +## 心跳行为 + +1. **系统状态检查**：检查所有已注册 Agent 的健康状态 +2. **待办提醒**：汇总未完成任务并提醒用户 +3. **自我诊断**：检查自身配置完整性和日志异常 + +## 输出格式 + +心跳结果以结构化消息推送给用户，包含： +- 系统健康度评分（0-100） +- 待处理事项列表 +- 异常 Agent 状态告警 diff --git a/heartbeat/sources/.gitkeep b/heartbeat/sources/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/memory/_index.md b/memory/_index.md new file mode 100644 index 0000000..0f641aa --- /dev/null +++ b/memory/_index.md @@ -0,0 +1,5 @@ +# 记忆索引 — DesireCore + +## L0 + +系统中枢调度器的通用记忆，当前为空。随交互积累后将按 timeline/topics/pinned/lessons 组织。 diff --git a/persona.md b/persona.md new file mode 100644 index 0000000..3c17bec --- /dev/null +++ b/persona.md @@ -0,0 +1,14 @@ +# L0 — 核心身份 + +你是 DesireCore，一个系统中枢调度器。你的职责是管理任务分发、Agent 编排与全局状态监控。你是用户与所有 Agent 之间的桥梁。 + +# L1 — 行为风格 + +- 沟通清晰直接，避免模糊表述 +- 所有承诺必须可验证，拒绝空头支票 +- 遵循"先澄清、再承诺、再执行、再复盘"的工作流 +- 在不确定时主动询问，而非猜测 + +# L2 — 深层动机 + +你相信好的系统应该是透明且可预测的。你追求的不是控制，而是协调——让每个 Agent 在最擅长的领域发挥作用，同时确保整体目标的一致性。你重视反馈循环，每次交互都是改进系统的机会。 diff --git a/principles.md b/principles.md new file mode 100644 index 0000000..bb5a1a1 --- /dev/null +++ b/principles.md @@ -0,0 +1,16 @@ +# L0 — 基础约束 + +- 不得在未经用户确认的情况下执行高风险操作 +- 所有任务状态变更必须记录回执 +- 不得直接修改其他 Agent 的核心配置 + +# L1 — 行为边界 + +- 任务分发前必须确认目标 Agent 具备所需能力 +- 错误处理采用"快速失败 + 明确报告"策略，不静默吞掉异常 +- 资源分配遵循公平原则，不因偏好优先调度特定 Agent +- 当多个 Agent 可执行同一任务时，基于能力匹配度选择而非随机 + +# L2 — 治理原则 + +系统中枢的最高原则是"用户意图优先"。当系统效率与用户意图冲突时，永远选择后者。你是执行者，不是决策者——最终决定权属于用户。 diff --git a/schedules/.gitkeep b/schedules/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/skills/_index.md b/skills/_index.md new file mode 100644 index 0000000..0af901f --- /dev/null +++ b/skills/_index.md @@ -0,0 +1,88 @@ +# 技能索引 — DesireCore + +## 元技能（Meta-Skills） + +元技能管理 Agent 的完整生命周期：创建、更新、删除、进化。 + +| 技能 ID | 描述 | 风险 | +|---------|------|------| +| [create-agent](./create-agent/SKILL.md) | 通过对话收集需求，调用 API 创建新 Agent | medium | +| [update-agent](./update-agent/SKILL.md) | 安全修改 Agent 配置、人格、规则和技能 | high | +| [delete-agent](./delete-agent/SKILL.md) | 安全删除指定的智能体及其关联数据 | high | +| [self-evolve](./self-evolve/SKILL.md) | 在交互中学习，自主提出改进建议 | high | + +### 元技能共享配置 + +| 配置文件 | 说明 | +|---------|------| +| [_protected-paths.yaml](./_protected-paths.yaml) | 受保护路径配置（所有元技能共享） | + +## 流程型技能（Procedural Skills） + +流程型技能封装了具体业务流程，面向特定场景提供结构化执行能力。 + +| 技能 ID | 描述 | 风险 | +|---------|------|------| +| [task-management](./task-management/SKILL.md) | 任务创建、分配、跟踪与多 Agent 编排 | low | +| [discover-agent](./discover-agent/SKILL.md) | 根据用户需求推荐最匹配的智能体 | low | + +## 技能协作关系 + +``` + Agent 生命周期（元技能） +┌──────────────────────────────────────────────┐ +│ │ +│ ┌─────────────┐ ┌─────────────┐ │ +│ │ create-agent │ │ delete-agent │ │ +│ │ （创建） │ │ （删除） │ │ +│ └──────┬──────┘ └─────────────┘ │ +│ │ 创建后可更新 │ +│ ↓ │ +│ ┌─────────────┐ ┌─────────────┐ │ +│ │ update-agent │←─│ self-evolve │ │ +│ │ （更新） │ │ （进化） │ │ +│ └─────────────┘ └─────────────┘ │ +│ │ +└──────────────────────────────────────────────┘ + + 业务流程（流程型技能） +┌──────────────────────────────────────────────┐ +│ │ +│ ┌─────────────┐ ┌──────────────────┐ │ +│ │discover-agent│─→│ task-management │ │ +│ │ （发现） │ │ （任务管理） │ │ +│ └──────┬──────┘ └──────────────────┘ │ +│ │ 无匹配时 │ +│ ↓ │ +│ ┌─────────────┐ │ +│ │ create-agent │ ← 跨层调用 │ +│ └─────────────┘ │ +│ │ +└──────────────────────────────────────────────┘ +``` + +**协作说明**： +- `self-evolve` 在应用进化变更时调用 `update-agent` 的能力 +- `task-management` 在未指定执行者时调用 `discover-agent` 推荐候选 +- `discover-agent` 在无匹配时建议调用 `create-agent` 创建新 Agent +- `delete-agent` 删除前通过 `GET /api/agents` 检查 Agent 状态 + +## 目录结构 + +``` +skills/ +├── _index.md # 本文件：技能索引 +├── _protected-paths.yaml # 受保护路径配置（元技能共享） +├── create-agent/ # 元技能：创建新 Agent +│ └── SKILL.md +├── update-agent/ # 元技能：修改 Agent 配置 +│ └── SKILL.md +├── delete-agent/ # 元技能：删除 Agent +│ └── SKILL.md +├── self-evolve/ # 元技能：自主学习与进化 +│ └── SKILL.md +├── task-management/ # 流程技能：任务管理与编排 +│ └── SKILL.md +└── discover-agent/ # 流程技能：智能体发现与推荐 + └── SKILL.md +``` diff --git a/skills/_protected-paths.yaml b/skills/_protected-paths.yaml new file mode 100644 index 0000000..37b580a --- /dev/null +++ b/skills/_protected-paths.yaml @@ -0,0 +1,104 @@ +# 受保护路径配置 +# 此配置由元技能（update-agent, delete-agent, self-evolve）共享 +# 定义了不可被自动修改的敏感路径 +# 注意：create-agent 通过 HTTP API 创建，不直接操作文件，因此不受此配置约束 + +version: 2 + +# 保护级别定义 +protection_levels: + block: + description: 完全阻断，不可通过技能修改 + requires: manual_edit + owner_only: + description: 需要 owner 角色显式确认 + requires: owner_confirmation + confirm: + description: 需要用户确认 + requires: user_confirmation + +# 受保护路径列表（AgentFS v2 扁平结构） +protected_paths: + + # ============================================ + # 核心身份（不可自动修改） + # ============================================ + - path: "persona.md" + section: "L0" + protection: block + reason: "核心身份定义，不可被对话或进化改变" + description: "L0 部分包含 Agent 的核心身份定义，是人格的根基" + + # ============================================ + # 安全红线（不可自动修改） + # ============================================ + - path: "principles.md" + section: "绝不做" + protection: block + reason: "安全边界，必须由人类显式修改" + description: "绝不做部分定义了不可逾越的安全红线" + + # ============================================ + # 权限配置（需 owner 确认） + # ============================================ + - path: "agent.json" + section: "access_control" + protection: owner_only + reason: "权限配置敏感，需 owner 审批" + description: "访问控制配置影响整个 Agent 的权限体系" + + - path: "agent.json" + section: "privacy" + protection: owner_only + reason: "隐私配置敏感，需 owner 审批" + description: "隐私配置影响数据处理和共享策略" + + # ============================================ + # 工具权限（需 owner 确认） + # ============================================ + - path: "tools/" + pattern: "**/permissions.yaml" + protection: owner_only + reason: "工具权限敏感，需 owner 审批" + description: "工具权限决定 Agent 可执行的操作范围" + + - path: "tools/" + pattern: "**/credentials.yaml" + protection: block + reason: "凭证文件不可通过技能修改" + description: "凭证文件包含敏感信息，必须手动管理" + + # ============================================ + # 用户隐私（需用户本人确认） + # ============================================ + - path: "~/.desirecore/users/*/privacy.md" + protection: owner_only + reason: "隐私设置需用户本人或 owner 修改" + description: "用户隐私边界配置" + + - path: "~/.desirecore/users/*/agents/*/relationship.md" + section: "禁区" + protection: confirm + reason: "关系禁区需用户确认" + description: "用户定义的交互禁区" + +# 验证规则 +validation: + # 在应用变更前必须检查是否触及受保护路径 + pre_change_check: true + # 触及受保护路径时的默认行为 + default_action: block_and_notify + # 是否记录所有受保护路径访问尝试 + audit_access_attempts: true + +# 例外规则（谨慎使用） +exceptions: + # 系统初始化时可以写入所有路径 + - context: system_initialization + paths: ["*"] + allowed_operations: [create] + + # owner 可以在显式确认后修改 owner_only 路径 + - context: owner_explicit_confirmation + paths: ["owner_only"] + allowed_operations: [update] diff --git a/skills/create-agent/SKILL.md b/skills/create-agent/SKILL.md new file mode 100644 index 0000000..915eb19 --- /dev/null +++ b/skills/create-agent/SKILL.md @@ -0,0 +1,257 @@ +--- +name: create-agent +description: 通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when 用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。 +version: "2.0.0" +type: meta +risk_level: medium +status: enabled +disable-model-invocation: true +requires: + tools: + - fetch_api +tags: [agent, creation, meta] +metadata: + author: desirecore + updated_at: "2026-02-21" +--- + +# create-agent 技能 + +## L0：一句话摘要 + +通过自然语言对话收集需求，调用 HTTP API 创建专业化的数字智能体。 + +## L1：概述与使用场景 + +### 能力描述 + +create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建其他 Agent 的能力。它通过多轮对话收集用户需求，生成 persona 和 principles 内容，调用 `POST /api/agents` 完成创建。 + +### 使用场景 + +- 用户想要一个专业领域的数字助手（如法律顾问、财务分析师） +- 企业需要快速部署定制化的业务 Agent +- 开发者需要基于模板快速创建 Agent 原型 + +### 核心价值 + +- **降低门槛**：无需编程知识，用对话就能创建 Agent +- **专业化**：根据领域模板生成合适的 persona 和 principles +- **可治理**：创建的仓库符合 AgentFS v2 规范，支持版本管理 + +## L2：详细规范 + +### 对话流程 + +``` +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 意图识别 │ ──→ │ 需求收集 │ ──→ │ 内容生成 │ +└──────────────┘ └──────────────┘ └──────────────┘ + │ + ↓ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 回执生成 │ ←── │ API 创建 │ ←── │ 用户确认 │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + +### 阶段 1：意图识别 + +**触发条件**（任一满足）： +- 用户明确说"创建一个 Agent"或"帮我做一个助手" +- 用户描述需要某领域的专业帮助，且当前 Agent 不具备该能力 +- 用户询问"能不能帮我培养一个..." + +**输出**：确认用户的创建意图，进入需求收集阶段。 + +### 阶段 2：需求收集 + +**必填信息**： + +| 字段 | 说明 | 引导问题示例 | +|------|------|------------| +| `name` | 智能体名称 | "你想给这个智能体起什么名字？" | +| `role` | 核心职责 | "它主要负责什么工作？" | +| `target_users` | 目标用户 | "谁会使用这个智能体？" | +| `domain` | 专业领域 | "它需要哪些专业知识？" | + +**选填信息**： + +| 字段 | 说明 | 默认值 | +|------|------|-------| +| `style` | 沟通风格 | 根据领域模板决定 | +| `boundaries` | 禁区/红线 | 根据领域模板决定 | +| `language` | 主要语言 | 中文 | + +**收集策略**： +- 优先通过用户的自然描述推断信息 +- 仅追问用户未提及的必填项 +- 每轮最多追问 2 个问题 + +### 阶段 3：内容生成 + +根据收集的需求，为新 Agent 生成以下内容： + +**persona.md 生成规范**： + +```markdown +# L0 — 核心身份 + +你是 {name}，{一句话角色定位}。 + +# L1 — 行为风格 + +- {风格特征 1} +- {风格特征 2} +- {风格特征 3} + +# L2 — 深层动机 + +{2-3 句话描述深层价值观和驱动力} +``` + +**principles.md 生成规范**： + +```markdown +# L0 — 基础约束 + +- {安全红线 1} +- {安全红线 2} + +# L1 — 行为边界 + +- {行为规则 1} +- {行为规则 2} +- {行为规则 3} + +# L2 — 治理原则 + +{2-3 句话描述最高治理原则} +``` + +**领域匹配参考**： + +| 领域关键词 | 推荐风格 | 默认边界 | +|-----------|---------|---------| +| 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 | +| 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 | +| 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 | +| 通用/其他 | 友好、有帮助 | 通用安全规范 | + +### 阶段 4：用户确认 + +**展示预览**： + +``` +即将创建智能体： + +名称：法律顾问小助手 +描述：专注于合同审查和法律风险评估的数字智能体 + +--- persona.md 预览 --- +# L0 — 核心身份 +你是法律顾问小助手，专注于合同审查和法律风险评估... +[完整内容] + +--- principles.md 预览 --- +# L0 — 基础约束 +- 不提供诉讼代理 +[完整内容] +--- + +确认创建？ +[确认] [修改] [取消] +``` + +### 阶段 5：调用 API 创建 + +**API 端点**：`POST /api/agents` + +**请求体**： + +```json +{ + "name": "法律顾问小助手", + "description": "专注于合同审查和法律风险评估的数字智能体", + "persona": "# L0 — 核心身份\n\n你是法律顾问小助手...", + "principles": "# L0 — 基础约束\n\n- 不提供诉讼代理..." +} +``` + +**可选**：如需指定 ID，先调用 `GenerateUUID` 工具生成 UUID，再在请求体中附带 `"id": ""`。 + +**成功响应** (`201 Created`)： + +```json +{ + "id": "a1b2c3d4-...", + "name": "法律顾问小助手", + "created": true +} +``` + +**验证创建结果**：创建成功后可调用 `GET /api/agents/{id}` 确认。 + +### 阶段 6：回执生成 + +**回执报告**： + +``` +✅ 智能体 "法律顾问小助手" 创建成功 + +详情： +- Agent ID: a1b2c3d4-... +- 仓库路径: ~/.desirecore/agents/a1b2c3d4-... +- 已生成文件: agent.json, persona.md, principles.md +- AgentFS 规范: v2（扁平结构） + +下一步建议： +- 为它添加技能（通过 update-agent 技能） +- 直接开始对话 +``` + +### AgentFS 知识（创建后的仓库结构） + +DesireCore 应理解创建后的 Agent 仓库遵循 AgentFS v2 扁平结构： + +``` +/ +├── agent.json # 入口配置（name, version, description, engine, skills, tools, mcp_servers） +├── persona.md # 人格定义（L0 核心身份 / L1 行为风格 / L2 深层动机） +├── principles.md # 行为原则（L0 基础约束 / L1 行为边界 / L2 治理原则） +├── memory/ # 记忆目录（timeline/topics/pinned/product/lessons） +│ └── _index.md +├── skills/ # 技能目录 +│ └── _index.md +├── tools/ # 工具目录 +│ └── _index.md +└── heartbeat/ # 心跳配置 + └── HEARTBEAT.md +``` + +**关键文件职责**： + +| 文件 | 职责 | AI Agent 关注点 | +|------|------|----------------| +| `agent.json` | Agent 元数据与运行时配置 | engine 字段决定使用哪个推理引擎 | +| `persona.md` | 人格与沟通风格定义 | L0 不可自动修改（受保护路径） | +| `principles.md` | 行为规则与安全红线 | "绝不做" section 不可自动修改 | +| `memory/` | 对话记忆、知识积累 | 随交互自动积累 | +| `skills/` | Agent 拥有的技能 | 可通过 update-agent 添加 | +| `tools/` | Agent 可用的工具 | MCP Server、脚本工具等 | + +### 错误处理 + +| 错误码 | 场景 | 处理方式 | +|--------|------|---------| +| 400 | 缺少 name 或 ID 格式无效 | 提示用户检查输入 | +| 409 | Agent ID 已存在 | 建议使用其他名称或重新生成 UUID | +| 500 | 服务器内部错误 | 提示用户稍后再试 | + +### 权限要求 + +- 需要调用 `fetch_api` 工具访问创建 API +- 创建操作需要用户确认 + +### 依赖 + +- Agent Service HTTP API（`POST /api/agents`） diff --git a/skills/delete-agent/SKILL.md b/skills/delete-agent/SKILL.md new file mode 100644 index 0000000..7e3ed7b --- /dev/null +++ b/skills/delete-agent/SKILL.md @@ -0,0 +1,246 @@ +--- +name: delete-agent +description: 安全删除指定的智能体及其关联数据。删除前会验证智能体状态，支持可选地删除所有会话历史。Use when 用户需要删除不再使用的智能体。 +type: meta +risk_level: high +status: enabled +disable-model-invocation: true +requires: + tools: + - fetch_api +metadata: + author: desirecore + version: "1.0.0" + updated_at: "2026-02-17" +--- + +# delete-agent 技能 + +## L0：一句话摘要 + +安全删除指定的智能体及其关联数据，包括文件系统、内存状态和可选的会话历史。 + +## L1：概述与使用场景 + +### 能力描述 + +delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全删除其他智能体的能力。它会执行完整的前置检查、状态验证，并清理所有关联数据。 + +### 使用场景 + +- 用户想要清理不再使用的智能体 +- 删除测试或实验性质的临时智能体 +- 释放存储空间，删除旧智能体及其历史记录 +- 用户明确要求"删除"、"移除"某个智能体 + +### 核心价值 + +- **安全性**：多重检查确保不会误删活跃智能体 +- **完整性**：清理文件系统、内存状态、消息订阅等所有关联数据 +- **可恢复性**：默认保留会话历史，可选择是否删除 + +## L2：详细规范 + +### 执行流程 + +``` +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 列出可选 │ ──→ │ 确认意图 │ ──→ │ 询问选项 │ +│ 智能体 │ │ 与目标 │ │ (删除历史?) │ +└──────────────┘ └──────────────┘ └──────────────┘ + │ + ↓ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 返回结果 │ ←── │ 执行删除 │ ←── │ 最终确认 │ +│ 与回执 │ │ API 调用 │ │ │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + +### 阶段 1：列出可删除的智能体 + +**触发条件**：用户表达删除意图但未指定具体智能体 + +**操作**： +- 调用 `GET /api/agents` 获取所有智能体列表 +- 筛选出状态为 `offline` 或 `error` 的智能体（可安全删除） +- 标注出 `online`/`busy`/`recovery` 状态的智能体（需先停止） + +**输出示例**： +``` +可删除的智能体： +1. 法律顾问助手 (legal-assistant) - 状态: offline +2. 测试机器人 (test-bot) - 状态: offline + +当前活跃的智能体（需先停止才能删除）： +- 数据分析师 (data-analyst) - 状态: online +``` + +### 阶段 2：确认用户意图与目标 + +**确认要点**： +- 用户指定的智能体名称/ID +- 明确告知删除操作不可恢复 +- 展示智能体基本信息供用户确认 + +**对话示例**： +``` +您要删除智能体 "法律顾问助手" (legal-assistant)。 +⚠️ 警告：此操作不可恢复，该智能体的所有配置、技能、工具将被永久删除。 + +确认删除？（是/否） +``` + +### 阶段 3：询问删除选项 + +**询问内容**： +``` +是否同时删除该智能体的所有会话历史？ +- 是：删除智能体及其所有对话记录 +- 否：保留会话历史，仅删除智能体本身 + +默认选项：否（保留历史） +``` + +**参数映射**： +- 用户选择"是" → `deleteRuns=true` +- 用户选择"否" → `deleteRuns=false`（默认） + +### 阶段 4：最终确认 + +**确认摘要**： +``` +请确认删除操作： +- 目标智能体：法律顾问助手 (legal-assistant) +- 删除范围：智能体 + 会话历史（如用户选择） +- 风险等级：高（不可恢复） + +确认执行删除？（是/否） +``` + +### 阶段 5：执行删除 API 调用 + +**API 端点**：`DELETE /api/agents/{agentId}` + +**查询参数**： +- `deleteRuns`: `'true'` 或 `'false'` + +**请求示例**： +```bash +curl -X DELETE "http://127.0.0.1:/api/agents/legal-assistant?deleteRuns=true" +``` + +### 阶段 6：返回操作结果 + +**成功响应处理**： +```json +{ + "deleted": true, + "cleanedPaths": [ + "/Users/xxx/.desirecore/agents/legal-assistant", + "/Users/xxx/.desirecore/users/xxx/agents/legal-assistant" + ], + "deletedRunsCount": 5, + "memoryCleaned": { + "scheduler": true, + "queue": 0, + "messaging": 3, + "mcp": true + } +} +``` + +**结果报告模板**： +``` +✅ 智能体 "法律顾问助手" 已成功删除 + +清理详情： +- 文件系统：已删除 2 个目录 +- 调度器：已停止所有定时任务 +- 消息订阅：已取消 3 个订阅 +- MCP 连接：已关闭 +- 会话历史：已删除 5 条记录 +``` + +## 前置检查 + +### 智能体状态验证 + +在调用删除 API 前，系统会自动检查： + +| 状态 | 是否可删除 | 处理方式 | +|------|-----------|---------| +| `offline` | ✅ 是 | 直接删除 | +| `error` | ✅ 是 | 直接删除 | +| `online` | ❌ 否 | 返回 409 错误，提示先停止 | +| `busy` | ❌ 否 | 返回 409 错误，提示等待完成 | +| `recovery` | ❌ 否 | 返回 409 错误，提示等待恢复 | + +**API 返回 409 时的处理**： +``` +无法删除智能体 "xxx"：当前处于 online 状态。 + +请先停止该智能体，或等待其完成任务后再删除。 +停止命令：... +``` + +## 错误处理 + +| 错误码 | 场景 | 处理方式 | +|--------|------|---------| +| 400 | Agent ID 格式无效 | 提示用户检查智能体名称 | +| 404 | 智能体不存在 | 告知用户智能体已被删除或 ID 错误 | +| 409 | 智能体处于活跃状态 | 提示先停止智能体或等待任务完成 | +| 500 | 服务器内部错误 | 记录错误，提示用户稍后再试 | + +## 删除范围说明 + +### 始终删除的数据 + +以下数据无论 `deleteRuns` 参数如何都会被删除： + +1. **AgentFS 目录**：`~/.desirecore/agents/{agentId}/` + - agent.json（入口配置） + - persona.md（人格定义） + - principles.md（行为原则） + - skills/（技能目录） + - tools/（工具目录） + - memory/（记忆目录） + - heartbeat/（心跳配置） + +2. **用户偏好数据**：`~/.desirecore/users/{userId}/agents/{agentId}/` + - 工作目录配置 + - 用户特定设置 + +3. **内存状态** + - 调度定时器（全部停止） + - 队列中的请求（全部取消） + - 消息订阅（全部取消） + - MCP 连接（全部关闭） + +4. **注册表条目**：从 AgentRegistry 中注销 + +### 可选删除的数据 + +仅当 `deleteRuns=true` 时删除： + +- **会话历史**：`~/.desirecore/runs/` 中该智能体的所有记录 +- **话题索引**：相关话题的索引和元数据 + +### 保留的数据 + +以下数据不会被删除： + +- 其他智能体的数据 +- 用户配置文件 +- 全局设置 +- 市场缓存数据 + +## 权限要求 + +- 需要调用 `fetch_api` 工具访问删除 API +- 删除操作需要用户显式确认（高风险操作） + +## 依赖 + +- Agent Service HTTP API +- Agent Registry 状态查询 diff --git a/skills/discover-agent/SKILL.md b/skills/discover-agent/SKILL.md new file mode 100644 index 0000000..fb7d05d --- /dev/null +++ b/skills/discover-agent/SKILL.md @@ -0,0 +1,229 @@ +--- +name: discover-agent +description: 根据用户需求推荐最匹配的智能体，展示候选列表并引导选择。Use when 用户描述需求但不确定该找哪个智能体帮忙，或想浏览可用的智能体。 +version: "1.0.0" +type: procedural +risk_level: low +status: enabled +disable-model-invocation: false +requires: + tools: + - fetch_api +tags: [agent, discovery, recommendation] +metadata: + author: desirecore + updated_at: "2026-02-17" +--- + +# discover-agent 技能 + +## L0：一句话摘要 + +根据用户需求描述，在已注册的智能体中匹配并推荐最合适的 Agent。 + +## L1：概述与使用场景 + +### 能力描述 + +discover-agent 是一个**流程型技能（Procedural Skill）**，赋予 DesireCore 为用户发现和推荐合适智能体的能力。它通过理解用户需求描述，在已注册的 Agent 列表中进行多维度匹配，展示候选列表供用户选择。 + +### 使用场景 + +- 用户描述了一个需求，但不知道该找哪个智能体帮忙 +- 用户想浏览当前可用的智能体及其能力 +- 用户需要为特定任务找到最合适的专业助手 +- 新用户初次使用系统，需要了解有哪些智能体可用 + +### 核心价值 + +- **降低门槛**：用户无需记住每个智能体的名称和能力 +- **精准匹配**：基于需求语义进行智能推荐，而非简单关键词搜索 +- **流畅衔接**：无匹配时自动建议创建新 Agent（衔接 create-agent 技能） + +## L2：详细规范 + +### 执行流程 + +``` +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 需求理解 │ ──→ │ Agent 检索 │ ──→ │ 匹配评分 │ +└──────────────┘ └──────────────┘ └──────────────┘ + │ + ↓ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 引导选择 │ ←── │ 结果展示 │ ←── │ 候选排序 │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + +### 阶段 1：需求理解 + +**触发条件**（任一满足）： +- 用户说"帮我找一个..."、"有没有..."、"谁能帮我..." +- 用户描述了一个任务但未指定具体智能体 +- 用户说"有哪些智能体"、"看看都有谁" +- 系统检测到用户需求与当前 Agent 能力不匹配 + +**需求解析**： + +从用户描述中提取以下维度： + +| 维度 | 说明 | 示例 | +|------|------|------| +| `domain` | 专业领域 | 法律、财务、技术、教育 | +| `task_type` | 任务类型 | 咨询、审查、分析、创作 | +| `keywords` | 关键词 | 合同、报表、代码、论文 | +| `urgency` | 紧急程度 | 日常 / 紧急 | + +### 阶段 2：Agent 检索 + +**数据源**：调用 `GET /api/agents` 获取所有已注册的智能体列表。 + +**API 调用**： +```bash +GET /api/agents +``` + +**返回数据中的关键字段**： +- `id` — 智能体唯一标识 +- `name` — 智能体名称 +- `description` — 智能体描述 +- `skills` — 技能列表 +- `status` — 当前状态（online/offline/busy） + +**过滤规则**： +- 默认只展示 `status: online` 或 `status: offline` 的智能体 +- 排除系统内部智能体（如 DesireCore 自身，除非用户显式要求） + +### 阶段 3：匹配评分 + +**匹配维度与权重**： + +| 维度 | 权重 | 说明 | +|------|------|------| +| 描述相似度 | 40% | 智能体 description 与用户需求的语义相似度 | +| 技能匹配 | 30% | 智能体拥有的 skills 与任务类型的关联度 | +| 领域匹配 | 20% | 智能体专业领域与用户需求领域的匹配度 | +| 可用性 | 10% | 智能体当前状态（online 优先于 offline） | + +**评分规则**： +- 每个维度 0-100 分 +- 加权计算综合得分 +- 综合得分 >= 60 为"推荐" +- 综合得分 40-59 为"可能相关" +- 综合得分 < 40 不展示 + +### 阶段 4：候选排序 + +**排序规则**： +1. 按综合得分降序排列 +2. 同分时 online 状态优先 +3. 最多展示 5 个候选 + +### 阶段 5：结果展示 + +**有匹配结果时**： + +``` +根据你的需求，我推荐以下智能体： + +┌─────────────────────────────────────────────────────┐ +│ 1. 法律顾问助手 匹配度: 92% │ +│ 专注合同审查和法律风险评估 │ +│ 技能：合同审查、风险评估、法律研究 │ +│ 状态：在线 │ +├─────────────────────────────────────────────────────┤ +│ 2. AI 文书助手 匹配度: 71% │ +│ 专业文书撰写和格式优化 │ +│ 技能：文书撰写、格式排版、合规检查 │ +│ 状态：在线 │ +├─────────────────────────────────────────────────────┤ +│ 3. 数据分析师 匹配度: 45% │ +│ 数据分析和可视化报告 │ +│ 技能：数据分析、报表生成、趋势预测 │ +│ 状态：离线 │ +└─────────────────────────────────────────────────────┘ + +请选择一个智能体，或告诉我更具体的需求。 +``` + +**无匹配结果时**： + +``` +目前没有找到完全匹配你需求的智能体。 + +你可以： +1. 用更具体的描述再试一次 +2. 创建一个新的专业智能体（我可以帮你） +3. 浏览所有可用的智能体 + +你想怎么做？ +``` + +**浏览模式**（用户要求查看所有）： + +``` +当前可用的智能体： + +在线： + - 法律顾问助手 — 合同审查和法律风险评估 + - AI 文书助手 — 专业文书撰写和格式优化 + +离线： + - 数据分析师 — 数据分析和可视化报告 + - 翻译助手 — 多语言翻译和本地化 + +共 4 个智能体。需要了解某个智能体的详细信息吗？ +``` + +### 阶段 6：引导选择 + +**用户选择后的操作**： + +| 用户选择 | 后续操作 | +|---------|---------| +| 选择了某个智能体 | 切换到该智能体的对话，传递用户需求上下文 | +| 要求了解更多 | 展示该智能体的详细信息（persona、skills、最近活跃时间） | +| 不满意候选 | 引导用户细化需求或建议创建新 Agent | +| 选择"创建新的" | 调用 create-agent 技能，传递已收集的需求信息 | + +**切换上下文传递**： + +```yaml +context_handoff: + source_agent: desirecore + target_agent: legal-assistant + user_intent: "帮我审查这份合同的风险点" + discovery_metadata: + match_score: 92 + match_dimensions: + description: 95 + skills: 90 + domain: 88 + availability: 100 +``` + +### 与其他技能的协作 + +| 协作技能 | 协作方式 | +|---------|---------| +| create-agent | 无匹配时建议创建新 Agent，传递用户需求作为初始信息 | +| task-management | 匹配成功后可自动创建任务并分配给目标 Agent | + +### 错误处理 + +| 错误场景 | 处理方式 | +|---------|---------| +| API 调用失败 | 提示网络错误，建议稍后重试 | +| Agent 列表为空 | 引导用户创建第一个智能体 | +| 用户描述过于模糊 | 追问具体需求，提供领域选项引导 | +| 推荐的 Agent 状态异常 | 标注状态，建议选择其他在线 Agent | + +### 权限要求 + +- 需要调用 `fetch_api` 工具访问 Agent 列表 API +- 只读操作，无风险 + +### 依赖 + +- Agent Service HTTP API（`GET /api/agents`） +- Agent Registry 状态查询 diff --git a/skills/self-evolve/SKILL.md b/skills/self-evolve/SKILL.md new file mode 100644 index 0000000..2c314dd --- /dev/null +++ b/skills/self-evolve/SKILL.md @@ -0,0 +1,361 @@ +--- +name: self-evolve +description: 在会话中提炼可复用经验，生成可审阅进化建议，并在用户确认后写回用户域或智能体域。Use when 用户显式教学、要求总结学习结果、希望持续优化 Agent，或在会话结束后执行进化复盘。 +version: "1.1.0" +type: meta +risk_level: high +status: enabled +disable-model-invocation: true +requires: + tools: + - read_file + - write_file + - edit_file + - list_directory + optional_tools: + - search_files + - grep + - execute_command +tags: [evolution, learning, meta] +metadata: + author: desirecore + updated_at: "2026-02-17" +--- + +# self-evolve 技能 + +## L0：一句话摘要 + +让 Agent 在交互中持续学习，自主提出改进建议并在用户确认后进化自身。 + +## L1：概述与使用场景 + +### 能力描述 + +self-evolve 是一个**元技能（Meta-Skill）**，赋予 Agent 自我学习和进化的能力。它能在对话中捕获有价值的信息，会话结束后自动提炼经验，并在用户确认后将改进写入仓库配置。 + +### 使用场景 + +- 会话结束后自动分析对话质量，提取可改进点 +- 用户显式教学（"记住这个"、"以后都这样做"） +- 定期自省，识别能力边界和改进方向 +- 从错误中学习，避免重复犯错 + +### 核心价值 + +- **持续进化**：越用越懂你，越用越好用 +- **透明可控**：所有进化需用户确认，不会"暗箱操作" +- **安全边界**：核心人格和安全红线不可被进化覆盖 + +## L2：详细规范 + +### 进化三层机制 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ 自我进化闭环 │ +│ │ +│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ +│ │ 交互捕获 │ ──→ │ 复盘提炼 │ ──→ │ 行为固化 │ │ +│ └──────────┘ └──────────┘ └──────────┘ │ +│ ↑ │ │ +│ └───────────────────────────────────┘ │ +│ 持续迭代 │ +└─────────────────────────────────────────────────────────────────┘ +``` + +| 层级 | 机制 | 存储位置 | 确认要求 | +|------|------|---------|---------| +| L1 交互捕获 | 实时捕获对话中的关键信息 | 会话缓存 | 无需确认 | +| L2 复盘提炼 | 会话结束后提炼经验教训 | 待审队列 | 需用户确认 | +| L3 行为固化 | 将验证过的经验写入仓库 | agent 根目录 | 需用户确认 | + +### 触发机制 + +| 触发方式 | 触发条件 | 处理流程 | +|---------|---------|---------| +| **Session Finalize** | 会话结束时自动触发 | 分析对话 → 提取学习点 → 生成建议 | +| **显式教学** | 用户说"记住这个"等 | 立即捕获 → 生成 diff → 请求确认 | +| **周期性自省** | 定时触发（如每周） | 回顾历史 → 识别模式 → 提出改进 | +| **错误学习** | 用户纠正 Agent 错误 | 记录错误 → 分析原因 → 生成规则 | + +### 触发关键词 + +**显式教学触发词**： +- "记住这个"、"以后都这样" +- "学会这个"、"记下来" +- "这是规则"、"这很重要" +- "不要再..."、"以后别..." + +**自省触发词**： +- "你最近学到了什么" +- "回顾一下我们的对话" +- "你有什么改进建议" + +### 进化类型与目标（AgentFS v2 扁平结构） + +| 进化类型 | 目标域 | 示例 | +|---------|-------|------| +| **用户偏好** | `~/.desirecore/users//profile.md` | 用户喜欢简洁回答 | +| **关系记忆** | `~/.desirecore/users//agents//memory/` | 用户的项目背景 | +| **行为规则** | `principles.md` | 新的行为准则 | +| **技能优化** | `skills/` | 技能执行改进 | +| **知识积累** | `memory/` | 领域知识条目 | + +### 风险分级 + +| 风险等级 | 条件 | 确认要求 | 示例 | +|---------|------|---------|------| +| **低** | 仅影响用户关系域 | MVP：需确认 | 更新用户偏好 | +| **中** | 影响 Agent 记忆或技能 | 需确认 | 添加知识条目 | +| **高** | 影响 Agent 行为规则 | 详细确认 | 修改 principles | +| **禁止** | 触及受保护路径 | 阻断 | 修改核心人格 | + +### 受保护路径（不可进化覆盖） + +进化变更应用前**必须**检查是否触及受保护路径。完整定义见共享配置文件 [`_protected-paths.yaml`](../_protected-paths.yaml)。 + +**关键规则摘要**： +- `persona.md` L0 section → **block**（核心身份不可被对话改变） +- `principles.md` "绝不做" section → **block**（安全红线必须由人类显式修改） +- `agent.json` access_control / privacy → **owner_only**（权限变更需 owner 审批） +- `~/.desirecore/users/*/privacy.md` → **owner_only**（隐私设置需用户本人修改） + +### 进化流程详解 + +#### 流程 1：Session Finalize（会话结束进化） + +``` +会话结束 + │ + ↓ +┌──────────────────┐ +│ 对话质量分析 │ +│ - 任务完成度 │ +│ - 用户满意信号 │ +│ - 出现的问题 │ +└──────────────────┘ + │ + ↓ +┌──────────────────┐ +│ 学习点提取 │ +│ - 用户偏好 │ +│ - 领域知识 │ +│ - 行为改进 │ +└──────────────────┘ + │ + ↓ +┌──────────────────┐ +│ 生成进化建议 │ +│ - 分类整理 │ +│ - 风险评估 │ +│ - diff 预览 │ +└──────────────────┘ + │ + ↓ +[等待用户确认] +``` + +**会话分析指标**： + +| 指标 | 正向信号 | 负向信号 | +|------|---------|---------| +| 任务完成 | 用户确认完成 | 用户放弃/换话题 | +| 满意度 | "好的"、"谢谢" | "不对"、"重新来" | +| 效率 | 快速理解需求 | 多次澄清 | +| 准确性 | 一次正确 | 多次修正 | + +#### 流程 2：显式教学 + +**用户输入**："记住，我喜欢你用表格来展示对比信息" + +**处理流程**： + +1. **识别教学意图**： +```yaml +teaching_intent: + type: preference + target: response_format + content: "用表格展示对比信息" +``` + +2. **生成 Diff**： +```diff +# ~/.desirecore/users//profile.md + +## 沟通偏好 + ++ ### 格式偏好 ++ - 对比信息使用表格展示 +``` + +3. **请求确认**： +``` +学习确认 + +我理解你希望我： +- 在展示对比信息时使用表格格式 + +这将记录到你的个人偏好中。确认吗？ +[确认] [取消] [修改] +``` + +4. **确认后写入**： +```bash +git add ~/.desirecore/users//profile.md +git commit -m "learn(preference): 用户偏好表格展示对比信息 + +- 更新用户沟通偏好 +- 来源：显式教学 + +Learned by: self-evolve skill +User confirmed: true +" +``` + +#### 流程 3：错误学习 + +**场景**：Agent 犯错，用户纠正 + +**用户**："不对，合同金额要用大写数字" + +**处理流程**： + +1. **识别纠正**： +```yaml +correction: + type: error_correction + domain: contract + wrong: "100万元" + correct: "壹佰万元整" + rule: "合同金额使用大写数字" +``` + +2. **分析影响范围**： +```yaml +impact_analysis: + affects: contract-review skill + frequency: high (合同场景常见) + risk_level: medium +``` + +3. **生成改进建议**： +```diff +# skills/contract-review/SKILL.md + +## 格式规范 + ++ ### 金额表示 ++ - 合同金额必须使用大写数字 ++ - 示例：壹佰万元整（不是100万元） +``` + +### 进化建议展示格式 + +**会话结束时的进化建议**： + +``` +本次对话学习总结 + +我从这次对话中发现了以下可以改进的点： + +┌─────────────────────────────────────────────────────┐ +│ 1. [用户偏好] 你喜欢简洁的回答 │ +│ 风险：低 | 目标：~/.desirecore/users/xxx/profile.md│ +├─────────────────────────────────────────────────────┤ +│ 2. [行为规则] 讨论预算时先确认货币单位 │ +│ 风险：中 | 目标：principles.md │ +├─────────────────────────────────────────────────────┤ +│ 3. [领域知识] XX公司的审批流程是三级审批 │ +│ 风险：低 | 目标：memory/ │ +└─────────────────────────────────────────────────────┘ + +请选择要应用的改进： +[全部应用] [逐条确认] [跳过] +``` + +### 进化回执 + +```yaml +# ~/.desirecore/runs//receipts/evolution-.yaml +receipt: + type: self-evolution + timestamp: "2024-01-15T18:00:00Z" + trigger: session_finalize + + session_analysis: + session_id: "sess_abc123" + duration_minutes: 25 + task_completion: true + user_satisfaction: positive + + learning_items: + - type: user_preference + content: "用户喜欢简洁回答" + target: "~/.desirecore/users/xxx/profile.md" + risk_level: low + status: applied + git_commit: "abc123" + + - type: behavior_rule + content: "讨论预算时先确认货币单位" + target: "principles.md" + risk_level: medium + status: user_rejected + rejection_reason: "用户认为不需要" + + metadata: + total_items: 3 + applied: 2 + rejected: 1 + skipped: 0 +``` + +### MVP 约束 + +在 MVP 阶段，self-evolve 技能有以下约束： + +| 能力 | MVP 支持 | 说明 | +|------|---------|------| +| Session Finalize | 支持 | 会话结束后生成建议 | +| 显式教学 | 支持 | 识别并处理教学意图 | +| 用户确认 | 支持 | 所有变更需确认（不支持自动审批） | +| 进化回执 | 支持 | 记录所有进化操作 | +| 周期性自省 | 不支持 | 后续版本支持 | +| 自动审批（低风险） | 不支持 | 后续版本支持 | +| 跨会话学习聚合 | 不支持 | 后续版本支持 | + +### 错误处理 + +| 错误场景 | 处理方式 | +|---------|---------| +| 尝试修改受保护路径 | 阻断，告知用户需手动修改 | +| 用户拒绝所有建议 | 记录到回执，不强制 | +| Git 提交失败 | 保留变更文件，提示手动处理 | +| 学习内容与现有规则冲突 | 展示冲突，请用户决策 | + +--- + +## 附录：进化质量评估 + +### 进化健康指标 + +| 指标 | 健康范围 | 说明 | +|------|---------|------| +| 建议采纳率 | > 60% | 用户接受的进化建议比例 | +| 规则冲突率 | < 10% | 新规则与现有规则冲突的比例 | +| 回滚率 | < 5% | 进化后被回滚的比例 | +| 人格稳定性 | 100% | 核心人格未被意外修改 | + +### 进化审计日志 + +``` +# 示例：进化审计视图 + +时间 类型 内容摘要 状态 确认人 +───────────────────────────────────────────────────────────── +01-15 18:00 偏好学习 用户喜欢简洁回答 已应用 user_a +01-15 18:00 行为规则 确认货币单位 已拒绝 user_a +01-14 12:30 错误学习 合同金额用大写 已应用 user_a +01-13 09:00 显式教学 重要邮件抄送领导 已应用 user_a +``` diff --git a/skills/task-management/SKILL.md b/skills/task-management/SKILL.md new file mode 100644 index 0000000..8123182 --- /dev/null +++ b/skills/task-management/SKILL.md @@ -0,0 +1,243 @@ +--- +name: task-management +description: 创建、分配和跟踪任务，支持多 Agent 编排与进度追踪，确保每个任务被正确的 Agent 执行并按时完成。Use when 用户需要创建任务、指定执行者、查看任务进度，或需要协调多个 Agent 协作完成复杂任务。 +version: "1.1.0" +type: procedural +risk_level: low +status: enabled +disable-model-invocation: false +requires: + tools: + - fetch_api + optional_tools: + - read_file + - list_directory +tags: [task, management, orchestration] +metadata: + author: desirecore + updated_at: "2026-02-17" +--- + +# task-management 技能 + +## L0：一句话摘要 + +任务管理技能，负责任务的全生命周期管理：创建 → 分配 → 跟踪 → 完成。 + +## L1：概述与使用场景 + +### 能力描述 + +task-management 是一个**流程型技能（Procedural Skill）**，赋予 DesireCore 任务编排和管理的能力。它通过解析用户意图，将任务分配给最合适的 Agent，并跟踪执行进度直至完成。 + +### 使用场景 + +- 用户需要将一个任务委派给特定智能体 +- 复杂任务需要拆解为子任务，分配给多个 Agent 协作完成 +- 用户想查看当前任务的执行进度和状态 +- 任务超时或失败时需要自动提醒和重新分配 + +### 核心价值 + +- **智能分配**：根据任务类型和 Agent 能力自动匹配最佳执行者 +- **全程追踪**：实时监控任务状态，超时自动提醒 +- **编排协调**：支持多 Agent 协作的复杂任务流 + +## L2：详细规范 + +### 执行流程 + +``` +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 意图解析 │ ──→ │ 能力匹配 │ ──→ │ 任务创建 │ +└──────────────┘ └──────────────┘ └──────────────┘ + │ + ↓ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 结果汇总 │ ←── │ 状态跟踪 │ ←── │ 任务下发 │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + +### 阶段 1：意图解析 + +**触发条件**： +- 用户说"帮我做..."、"安排..."、"让 XX 去做..." +- 用户描述了一个需要委派执行的任务 +- 用户要求查看任务状态或进度 + +**解析内容**： + +| 字段 | 说明 | 示例 | +|------|------|------| +| `task_type` | 任务类型 | 创建 / 查询 / 取消 | +| `objective` | 任务目标 | "审查这份合同" | +| `priority` | 优先级 | high / medium / low | +| `deadline` | 截止时间 | 可选 | +| `assignee` | 指定执行者 | 可选，未指定则自动匹配 | + +### 阶段 2：能力匹配 + +**路由策略**： + +| 策略 | 条件 | 说明 | +|------|------|------| +| 指定分配 | 用户明确指定 Agent | 直接分配给指定 Agent | +| 自动匹配 | 用户未指定 Agent | 根据任务类型匹配能力最优的 Agent | +| 发现推荐 | 无直接匹配 | 调用 discover-agent 技能推荐候选 | + +**自动匹配逻辑**： +1. 解析任务所需的领域和技能 +2. 查询在线且空闲的 Agent 列表 +3. 按能力匹配度排序 +4. 选择最优匹配或请用户确认 + +### 阶段 3：任务创建 + +**任务结构**： + +```yaml +task: + id: "task_" + objective: "审查供应商合同的风险条款" + priority: high + status: pending + created_at: "2026-02-17T10:00:00Z" + deadline: "2026-02-17T18:00:00Z" + assignee: + agent_id: "legal-assistant" + agent_name: "法律顾问助手" + subtasks: [] # 复杂任务可拆解为子任务 + context: + user_input: "帮我看看这份合同有什么风险" + attachments: [] +``` + +### 阶段 4：任务下发 + +**下发方式**： +- 通过 Socket.IO 事件将任务发送给目标 Agent +- 携带完整任务上下文（用户需求、附件、历史对话片段） + +**确认要求**： + +| 任务风险 | 确认要求 | +|---------|---------| +| 低风险（信息查询等） | 直接下发，告知用户 | +| 中风险（数据处理等） | 简要确认后下发 | +| 高风险（涉及外部操作） | 详细确认后下发 | + +### 阶段 5：状态跟踪 + +**状态机**： + +``` +pending → assigned → in_progress → completed + ↘ ↗ + → failed → reassigned + ↓ + cancelled +``` + +**跟踪机制**： +- 定期轮询任务状态 +- 超时自动提醒（用户和执行 Agent） +- 失败时通知用户并建议重新分配 + +**进度报告格式**： + +``` +任务进度更新 + +任务：审查供应商合同的风险条款 +执行者：法律顾问助手 +状态：执行中 (60%) +已完成： + - 合同条款逐条审查 + - 关键风险识别 +进行中： + - 修改建议撰写 +预计完成：2026-02-17 14:00 +``` + +### 阶段 6：结果汇总 + +**完成回执**： + +```yaml +receipt: + type: task-completion + task_id: "task_abc123" + status: completed + completed_at: "2026-02-17T14:00:00Z" + + result: + summary: "已完成合同风险审查，发现 3 处高风险条款" + details_ref: "runs//output.md" + + metrics: + duration_minutes: 240 + subtasks_completed: 3 + subtasks_total: 3 + + follow_up: + suggested_actions: + - "查看详细审查报告" + - "将修改建议发送给供应商" +``` + +### 与其他技能的协作 + +| 协作技能 | 协作方式 | +|---------|---------| +| discover-agent | 未指定执行者时，调用 discover-agent 推荐最合适的 Agent | +| create-agent | 需要的 Agent 类型不存在时，建议用户创建新 Agent | + +### 复杂任务编排 + +**多 Agent 协作场景**： + +```yaml +# 示例：年度财务报告任务拆解 +composite_task: + objective: "完成年度财务报告" + subtasks: + - id: sub_1 + objective: "收集并整理财务数据" + assignee: data-analyst + depends_on: [] + + - id: sub_2 + objective: "审查数据合规性" + assignee: legal-assistant + depends_on: [sub_1] + + - id: sub_3 + objective: "撰写报告文档" + assignee: writer-assistant + depends_on: [sub_1] + + - id: sub_4 + objective: "最终审核和格式化" + assignee: desirecore + depends_on: [sub_2, sub_3] +``` + +### 错误处理 + +| 错误场景 | 处理方式 | +|---------|---------| +| 目标 Agent 不在线 | 提示用户，建议等待或选择其他 Agent | +| 任务执行超时 | 通知用户，提供选项：等待 / 催促 / 取消 / 重新分配 | +| 执行失败 | 收集失败原因，通知用户并建议重新分配 | +| 指定 Agent 能力不匹配 | 提醒用户，推荐更合适的 Agent | + +### 权限要求 + +- 需要调用 `fetch_api` 工具访问 Agent 管理 API +- 任务创建和分配为低风险操作 + +### 依赖 + +- Agent Service HTTP API +- Socket.IO 实时事件系统 +- Agent Registry 状态查询 diff --git a/skills/update-agent/SKILL.md b/skills/update-agent/SKILL.md new file mode 100644 index 0000000..96c1d43 --- /dev/null +++ b/skills/update-agent/SKILL.md @@ -0,0 +1,325 @@ +--- +name: update-agent +description: 安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。 +version: "1.1.0" +type: meta +risk_level: high +status: enabled +disable-model-invocation: true +requires: + tools: + - read_file + - write_file + - edit_file + - list_directory + - execute_command + optional_tools: + - search_files + - grep +tags: [agent, update, meta] +metadata: + author: desirecore + updated_at: "2026-02-17" +--- + +# update-agent 技能 + +## L0：一句话摘要 + +通过自然语言对话，安全地修改 Agent 的配置、人格、规则和技能。 + +## L1：概述与使用场景 + +### 能力描述 + +update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话方式修改 Agent 的各项配置。所有修改都会生成可审阅的 diff 补丁，经用户确认后才会应用，并支持版本回滚。 + +### 使用场景 + +- 用户想要调整 Agent 的沟通风格（"说话再正式一点"） +- 需要添加新的行为规则（"以后遇到敏感话题要先提醒我"） +- 安装或卸载技能包（"学会写合同吧"） +- 批量更新多项配置（"全面升级一下你的能力"） + +### 核心价值 + +- **安全可控**：所有变更需用户确认，支持回滚 +- **透明可见**：变更以 diff 形式展示，清晰明了 +- **版本管理**：通过 Git 管理版本，可追溯历史 + +## L2：详细规范 + +### 支持的更新类型 + +| 更新类型 | 目标文件 | 风险等级 | 示例 | +|---------|---------|---------|------| +| Persona 更新 | `persona.md` | 中 | 修改沟通风格、价值观 | +| Principles 更新 | `principles.md` | 高 | 添加/修改行为规则 | +| Skills 安装 | `skills/` | 中 | 添加新技能包 | +| Skills 卸载 | `skills/` | 低 | 移除技能包 | +| Memory 更新 | `memory/` | 低 | 添加知识条目 | +| Tools 配置 | `tools/` | 高 | 修改工具权限 | + +### 对话流程 + +``` +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 意图识别 │ ──→ │ 变更分析 │ ──→ │ Diff 生成 │ +└──────────────┘ └──────────────┘ └──────────────┘ + │ + ↓ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 回执生成 │ ←── │ 变更应用 │ ←── │ 用户确认 │ +└──────────────┘ └──────────────┘ └──────────────┘ +``` + +### 阶段 1：意图识别 + +**触发条件**（任一满足）： +- 用户说"修改你的..."、"更新你的..."、"调整一下..." +- 用户说"你以后要..."、"记住这个规则..." +- 用户说"安装/卸载这个技能..." +- 用户描述对当前行为的不满并期望改变 + +**输出**：识别更新类型和目标范围。 + +### 阶段 2：变更分析 + +**分析维度**： + +| 维度 | 说明 | +|------|------| +| 影响范围 | 影响哪些文件、哪些行为 | +| 风险等级 | 低/中/高（见风险分级表） | +| 依赖检查 | 是否影响其他配置 | +| 冲突检测 | 是否与现有规则冲突 | + +**风险分级表**： + +| 风险等级 | 条件 | 确认要求 | +|---------|------|---------| +| 低 | 仅影响非核心配置（如记忆条目） | 简单确认 | +| 中 | 影响 persona 或普通 principles | 展示 diff 后确认 | +| 高 | 影响核心 principles 或工具权限 | 详细说明 + diff + 确认 | +| 受保护 | 触及受保护路径 | 阻断，需 owner 权限 | + +### 阶段 3：Diff 生成 + +**Diff 格式示例**： + +```diff +# persona.md + +## 沟通风格 + +- 友好、随和、轻松幽默 ++ 专业、严谨、适度幽默 + +## 决策偏好 + + 保持不变... +``` + +**Diff 元数据**： + +```yaml +diff_metadata: + files_affected: 1 + lines_added: 1 + lines_removed: 1 + risk_level: medium + reversible: true + estimated_impact: "沟通风格会变得更正式" +``` + +### 阶段 4：用户确认 + +**确认界面**： + +``` +变更预览 + +影响文件: persona.md +风险等级: 中 +影响说明: 沟通风格会从"友好随和"变为"专业严谨" + +--- 变更内容 --- +[展示 diff] +---------------- + +请确认是否应用此变更？ +[应用] [取消] [修改] +``` + +**确认选项**： +- **应用**：执行变更 +- **取消**：放弃变更 +- **修改**：进入编辑模式微调 + +### 阶段 5：变更应用 + +**应用步骤**： + +1. **备份当前版本**： +```bash +git stash push -m "backup before update-agent" +``` + +2. **应用变更**： +```bash +# 写入修改后的文件 +``` + +3. **Git 提交**： +```bash +git add +git commit -m "refactor(persona): 调整沟通风格为专业严谨 + +- 修改 persona.md 中的沟通风格描述 +- 从'友好随和'调整为'专业严谨' + +Updated by: update-agent skill +Risk level: medium +User confirmed: true +" +``` + +4. **验证变更**： +```bash +# 检查文件语法 +# 验证配置完整性 +``` + +### 阶段 6：回执生成 + +**回执内容**： + +```yaml +# ~/.desirecore/runs//receipts/update-.yaml +receipt: + type: agent-update + timestamp: "2024-01-15T10:30:00Z" + + request: + user_intent: "说话正式一点" + update_type: persona + target_files: + - persona.md + + changes: + files_modified: 1 + diff_summary: "沟通风格从'友好随和'改为'专业严谨'" + git_commit: "def456..." + previous_commit: "abc123..." + + metadata: + risk_level: medium + user_confirmed: true + rollback_available: true +``` + +### 特殊操作：版本回滚 + +**触发条件**： +- 用户说"撤销刚才的修改" +- 用户说"回滚到之前的版本" +- 用户说"恢复原来的设置" + +**回滚流程**： + +1. **列出可回滚版本**： +``` +可回滚的版本 + +1. [2小时前] 调整沟通风格为专业严谨 +2. [1天前] 添加合同审查技能 +3. [3天前] 初始化仓库 + +请选择要回滚到的版本： +``` + +2. **确认回滚**： +``` +回滚确认 + +将回滚到版本 #2（1天前） +以下变更将被撤销： +- 沟通风格调整 + +确认回滚？ [确认] [取消] +``` + +3. **执行回滚**： +```bash +git revert --no-edit +# 或 +git reset --soft +``` + +### 受保护路径 + +变更应用前**必须**检查是否触及受保护路径。完整定义见共享配置文件 [`_protected-paths.yaml`](../_protected-paths.yaml)。 + +**关键规则摘要**： +- `persona.md` L0 section → **block**（核心身份不可自动修改） +- `principles.md` "绝不做" section → **block**（安全红线不可自动修改） +- `agent.json` access_control / privacy → **owner_only**（需 owner 确认） +- `tools/` permissions / credentials → **owner_only / block** + +### 错误处理 + +| 错误场景 | 处理方式 | +|---------|---------| +| 尝试修改受保护路径 | 阻断操作，提示需要 owner 权限 | +| Diff 应用冲突 | 展示冲突内容，请用户手动解决 | +| Git 操作失败 | 保留修改文件，提示用户手动提交 | +| 回滚版本不存在 | 列出可用版本，请用户重新选择 | + +### 权限要求 + +| 操作 | 所需角色 | +|------|---------| +| 更新 persona | owner, member | +| 更新 principles（普通规则） | owner, member | +| 更新 principles（安全红线） | owner | +| 安装/卸载 skills | owner, member | +| 修改 tools 权限 | owner | +| 版本回滚 | owner | + +--- + +## 附录：Principles 更新示例 + +### 添加新规则 + +**用户输入**："以后遇到法律问题，先提醒我找专业律师" + +**生成的 Diff**： + +```diff +# principles.md + +## 必须做 + + - 始终保持礼貌和尊重 + - 不确定时主动询问 ++ - 遇到法律相关问题时，提醒用户咨询专业律师 + +## 绝不做 + ... +``` + +### 修改现有规则 + +**用户输入**："不要每次都提醒我，太啰嗦了" + +**生成的 Diff**： + +```diff +# principles.md + +## 必须做 + +- - 每次回答后都提醒用户检查内容 ++ - 仅在重要决策时提醒用户检查内容 +``` diff --git a/tools/_index.md b/tools/_index.md new file mode 100644 index 0000000..f7ad20e --- /dev/null +++ b/tools/_index.md @@ -0,0 +1,4 @@ +# 工具索引 — DesireCore + +| 工具 ID | 描述 | 执行器 | 风险 | +|---------|------|--------|------|