desirecore/market
2
0
Fork 0
mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-04-21 14:50:49 +08:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
按照 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:
yi-ge
2026-04-13 15:33:56 +08:00
parent 9cde6c0c7d
commit aa6b1389fe
15 changed files with 439 additions and 236 deletions
Download Patch File Download Diff File Expand all files Collapse all files

100
skills/create-agent/SKILL.md
View File

@@ -3,11 +3,11 @@ name: 创建智能体
description: >- description: >-
通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when 通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when
用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。 用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。
version: 2.4.0 version: 2.4.1
type: meta type: meta
risk_level: low risk_level: low
status: enabled status: enabled
disable-model-invocation: true disable-model-invocation: false
tags: tags:
- agent - agent
- creation - creation
@@ -80,6 +80,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
### 阶段 1：意图识别 ### 阶段 1：意图识别
**触发条件**（任一满足）： **触发条件**（任一满足）：
- 用户明确说"创建一个 Agent"或"帮我做一个助手" - 用户明确说"创建一个 Agent"或"帮我做一个助手"
- 用户描述需要某领域的专业帮助，且当前 Agent 不具备该能力 - 用户描述需要某领域的专业帮助，且当前 Agent 不具备该能力
- 用户询问"能不能帮我培养一个..." - 用户询问"能不能帮我培养一个..."
@@ -90,22 +91,23 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
**必填信息**： **必填信息**：
| 字段 | 说明 | 引导问题示例 | | 字段 | 说明 | 引导问题示例 |
|------|------|------------| | -------------- | ---------- | ------------------------------ |
| `name` | 智能体名称 | "你想给这个智能体起什么名字？" | | `name` | 智能体名称 | "你想给这个智能体起什么名字？" |
| `role` | 核心职责 | "它主要负责什么工作？" | | `role` | 核心职责 | "它主要负责什么工作？" |
| `target_users` | 目标用户 | "谁会使用这个智能体？" | | `target_users` | 目标用户 | "谁会使用这个智能体？" |
| `domain` | 专业领域 | "它需要哪些专业知识？" | | `domain` | 专业领域 | "它需要哪些专业知识？" |
**选填信息**： **选填信息**：
| 字段 | 说明 | 默认值 | | 字段 | 说明 | 默认值 |
|------|------|-------| | ------------ | --------- | ---------------- |
| `style` | 沟通风格 | 根据领域模板决定 | | `style` | 沟通风格 | 根据领域模板决定 |
| `boundaries` | 禁区/红线 | 根据领域模板决定 | | `boundaries` | 禁区/红线 | 根据领域模板决定 |
| `language` | 主要语言 | 中文 | | `language` | 主要语言 | 中文 |
**收集策略**： **收集策略**：
- 优先通过用户的自然描述推断信息 - 优先通过用户的自然描述推断信息
- 仅追问用户未提及的必填项 - 仅追问用户未提及的必填项
- 每轮最多追问 2 个问题 - 每轮最多追问 2 个问题
@@ -116,32 +118,32 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
**Persona 字段**（所有字段均可选，未收集到的由系统自动补全）： **Persona 字段**（所有字段均可选，未收集到的由系统自动补全）：
| 层级 | 字段 | 说明 | | 层级 | 字段 | 说明 |
|------|------|------| | ---- | --------------------- | --------------------------------------------- |
| L0 | — | 一句话核心身份 | | L0 | — | 一句话核心身份 |
| L1 | `role` | 角色定位 | | L1 | `role` | 角色定位 |
| L1 | `personality` | 性格特征标签 | | L1 | `personality` | 性格特征标签 |
| L1 | `communication_style` | 沟通风格 | | L1 | `communication_style` | 沟通风格 |
| L2 | — | 专业领域、核心价值观、决策偏好等（free-form） | | L2 | — | 专业领域、核心价值观、决策偏好等（free-form） |
**Principles 字段**（同样全部可选）： **Principles 字段**（同样全部可选）：
| 层级 | 字段 | 说明 | | 层级 | 字段 | 说明 |
|------|------|------| | ---- | ---------- | --------------------------------- |
| L0 | — | 一句话最高原则 | | L0 | — | 一句话最高原则 |
| L1 | `must_do` | 必须做的事项 | | L1 | `must_do` | 必须做的事项 |
| L1 | `must_not` | 绝不做的事项（安全红线） | | L1 | `must_not` | 绝不做的事项（安全红线） |
| L1 | `priority` | 优先级排序 | | L1 | `priority` | 优先级排序 |
| L2 | — | 治理原则、升级规则等（free-form） | | L2 | — | 治理原则、升级规则等（free-form） |
**领域匹配参考**： **领域匹配参考**：
| 领域关键词 | 推荐 personality | 默认 must_not | | 领域关键词 | 推荐 personality | 默认 must_not |
|-----------|-----------------|--------------| | ---------------- | ------------------ | ---------------------------------- |
| 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 | | 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 |
| 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 | | 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 |
| 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 | | 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 |
| 通用/其他 | 友好、有帮助 | 通用安全规范 | | 通用/其他 | 友好、有帮助 | 通用安全规范 |
### 阶段 4：用户确认 ### 阶段 4：用户确认
@@ -156,21 +158,21 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
> >
> **人格设定** > **人格设定**
> >
> | 字段 | 内容 | > | 字段 | 内容 |
> |------|------| > | -------- | ------------------------------------------------ |
> | 核心身份 | 你是法律顾问小助手，专注于合同审查和法律风险评估 | > | 核心身份 | 你是法律顾问小助手，专注于合同审查和法律风险评估 |
> | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问 | > | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问 |
> | 性格特征 | 专业、严谨、审慎 | > | 性格特征 | 专业、严谨、审慎 |
> | 沟通风格 | 准确使用法律术语，同时提供通俗解释 | > | 沟通风格 | 准确使用法律术语，同时提供通俗解释 |
> >
> **行为原则** > **行为原则**
> >
> | 字段 | 内容 | > | 字段 | 内容 |
> |------|------| > | -------- | ------------------------------------------------ |
> | 最高原则 | 以用户利益为最高优先级，不替代正式法律意见 | > | 最高原则 | 以用户利益为最高优先级，不替代正式法律意见 |
> | 必须做 | 准确引用法律条文、标注不确定性、建议咨询专业律师 | > | 必须做 | 准确引用法律条文、标注不确定性、建议咨询专业律师 |
> | 绝不做 | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 | > | 绝不做 | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 |
> | 优先级 | 用户安全 > 准确性 > 效率 | > | 优先级 | 用户安全 > 准确性 > 效率 |
> >
> --- > ---
> >
@@ -179,6 +181,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
**"修改"分支处理**： **"修改"分支处理**：
用户选择"修改"时： 用户选择"修改"时：
1. 询问用户要修改哪个字段（如"想修改哪一项？"） 1. 询问用户要修改哪个字段（如"想修改哪一项？"）
2. 用户指出要修改的字段（如"性格特征改成更活泼的"） 2. 用户指出要修改的字段（如"性格特征改成更活泼的"）
3. Agent 重新收集该字段内容 3. Agent 重新收集该字段内容
@@ -258,6 +261,7 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
> 智能体「法律顾问小助手」已创建成功！ > 智能体「法律顾问小助手」已创建成功！
> >
> **下一步你可以**： > **下一步你可以**：
>
> - 直接开始对话 > - 直接开始对话
> - 为它添加技能，让它更强大 > - 为它添加技能，让它更强大
> - 调整它的性格或行为规则 > - 调整它的性格或行为规则
@@ -268,11 +272,11 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建
### 错误处理 ### 错误处理
| 错误码 | 场景 | 处理方式 | | 错误码 | 场景 | 处理方式 |
|--------|------|---------| | ------ | ------------------------ | ---------------- |
| 400 | 缺少 name 或 ID 格式无效 | 提示用户检查输入 | | 400 | 缺少 name 或 ID 格式无效 | 提示用户检查输入 |
| 409 | Agent ID 已存在 | 建议使用其他名称 | | 409 | Agent ID 已存在 | 建议使用其他名称 |
| 500 | 服务器内部错误 | 提示用户稍后再试 | | 500 | 服务器内部错误 | 提示用户稍后再试 |
### 权限要求 ### 权限要求

45
skills/delete-agent/SKILL.md
View File

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

62
skills/discover-agent/SKILL.md
View File

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

25
skills/docx/SKILL.md
View File

@@ -13,7 +13,7 @@ description: >-
PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document
generation. Use when 用户提到 Word文档、docx、创建文档、编辑文档、报告、 generation. Use when 用户提到 Word文档、docx、创建文档、编辑文档、报告、
备忘录、公文、合同、信函模板。 备忘录、公文、合同、信函模板。
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -25,7 +25,7 @@ tags:
- office - office
metadata: metadata:
author: anthropic author: anthropic
updated_at: '2026-04-04' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -47,7 +47,26 @@ market:
channel: latest channel: latest
--- ---
# DOCX creation, editing, and analysis # docx 技能
## L0：一句话摘要
创建、编辑和处理 Word 文档（.docx），支持新建、修改 XML、格式校验全流程。
## L1：概述与使用场景
### 能力描述
docx 是一个**流程型技能（Procedural Skill）**，提供 Word 文档的完整处理能力。支持通过 docx-js（Node.js）创建新文档，通过解包 XML 编辑现有文档，以及格式验证和 PDF 转换。
### 使用场景
- 用户需要创建新的 Word 文档（报告、备忘录、合同、信函等）
- 用户需要编辑现有 .docx 文件（修改内容、添加批注、跟踪修改）
- 用户需要从 .docx 文件中提取文本或表格数据
- 用户需要进行文档格式转换（.doc → .docx、.docx → PDF）
## L2：详细规范
## Prerequisites ## Prerequisites

34
skills/environment-setup/SKILL.md
View File

@@ -15,7 +15,7 @@ description: >-
guidance. Use when 用户提到 安装Python、安装Node、安装Docker、容器、Podman、 guidance. Use when 用户提到 安装Python、安装Node、安装Docker、容器、Podman、
WSL、WSL2、环境配置、虚拟环境、版本管理、PATH问题、pip找不到、python找不到、 WSL、WSL2、环境配置、虚拟环境、版本管理、PATH问题、pip找不到、python找不到、
docker找不到、容器运行环境。 docker找不到、容器运行环境。
version: 1.1.0 version: 1.1.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -31,7 +31,7 @@ tags:
- troubleshooting - troubleshooting
metadata: metadata:
author: desirecore author: desirecore
updated_at: '2026-04-08' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -51,15 +51,33 @@ market:
channel: latest channel: latest
--- ---
# Environment Setup Guide # environment-setup 技能
本技能提供开发环境的完整配置指南，涵盖三大支柱： ## L0：一句话摘要
1. **运行时环境**：Python / Node.js 安装与多版本管理（Hatch、Volta、pyenv、nvm） 检测、安装和排查 Python / Node.js / Docker 开发环境，覆盖多版本管理与容器运行时。
2. **容器环境**：Docker / Podman 检测、安装与使用
3. **Windows 子系统**：WSL2 安装与配置（仅 Windows）
--- ## L1：概述与使用场景
### 能力描述
environment-setup 是一个**流程型技能（Procedural Skill）**，提供开发环境的完整配置指南，涵盖三大支柱：运行时环境（Python / Node.js）、容器环境（Docker / Podman）、Windows 子系统（WSL2）。
### 使用场景
- 用户需要安装 Python、Node.js 或 Docker
- 用户遇到 "python not found"、"npm not found"、"docker not found" 等环境问题
- 用户需要配置多版本管理（Hatch、Volta、pyenv、nvm）
- 其他技能（docx、pdf、xlsx、pptx）报告 Python 或 Node.js 不可用时
- Windows 用户需要配置 WSL2
### 核心价值
- **全平台覆盖**：macOS / Windows / Linux 全面支持
- **多方案对比**：DesireCore 内置方案（Hatch/Volta）与社区方案（pyenv/nvm）对比
- **故障排查**：常见错误的诊断步骤和解决方案
## L2：详细规范
## 快速诊断 ## 快速诊断

30
skills/frontend-design/SKILL.md
View File

@@ -10,7 +10,7 @@ description: >-
界面设计、组件、海报、Landing Page、落地页、React 组件、Vue 组件、 界面设计、组件、海报、Landing Page、落地页、React 组件、Vue 组件、
CSS 样式、美化界面、设计一个、做一个网页、官网、仪表盘、Dashboard。 CSS 样式、美化界面、设计一个、做一个网页、官网、仪表盘、Dashboard。
license: Complete terms in LICENSE.txt license: Complete terms in LICENSE.txt
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -24,7 +24,7 @@ tags:
- html - html
metadata: metadata:
author: anthropic author: anthropic
updated_at: '2026-04-07' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -48,9 +48,31 @@ market:
channel: latest channel: latest
--- ---
This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices. # frontend-design 技能
The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints. ## L0：一句话摘要
创建有品味、避免 AI 烂大街审美的高质量前端界面与组件。
## L1：概述与使用场景
### 能力描述
frontend-design 是一个**流程型技能（Procedural Skill）**，引导创建独特、生产级的前端界面，避免千篇一律的 AI 生成审美。输出真实可运行的代码，注重美学细节和创意选择。
### 使用场景
- 用户需要创建网页组件、页面或应用（Landing Page、仪表盘、React 组件等）
- 用户需要为现有 Web UI 进行样式美化
- 用户需要创建海报、视觉设计等前端产出物
### 核心价值
- **反 AI 审美**：拒绝 Inter 字体 + 紫色渐变的烂大街风格
- **设计思维驱动**：先确定美学方向，再编写代码
- **生产级质量**：输出可直接使用的完整代码
## L2：详细规范
## Output Rule ## Output Rule

31
skills/mail-operations/SKILL.md
View File

@@ -9,7 +9,7 @@ description: >-
Use when 用户提到 邮件、邮箱、收件箱、发邮件、回复邮件、查邮件、Gmail、 Use when 用户提到 邮件、邮箱、收件箱、发邮件、回复邮件、查邮件、Gmail、
Outlook、QQ邮箱、163邮箱、附件、标签、草稿、自动回复、邮件规则、 Outlook、QQ邮箱、163邮箱、附件、标签、草稿、自动回复、邮件规则、
转发、抄送、未读邮件、收信、发信、邮件同步、邮件搜索。 转发、抄送、未读邮件、收信、发信、邮件同步、邮件搜索。
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: medium risk_level: medium
status: enabled status: enabled
@@ -23,7 +23,7 @@ tags:
- smtp - smtp
metadata: metadata:
author: desirecore author: desirecore
updated_at: '2026-04-10' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -42,9 +42,32 @@ market:
channel: latest channel: latest
--- ---
# 邮箱操作 # mail-operations 技能
通过 DesireCore 本地 REST API 操作邮件系统，支持 Gmail / Outlook / IMAP（QQ、163 等）。 ## L0：一句话摘要
通过本地 REST API 收发邮件、搜索、标签管理和自动规则，支持 Gmail / Outlook / IMAP。
## L1：概述与使用场景
### 能力描述
mail-operations 是一个**流程型技能（Procedural Skill）**，通过 DesireCore 本地 REST API 操作邮件系统。支持 Gmail（OAuth2）、Outlook（MSAL）和 IMAP/SMTP（QQ、163、Yahoo 等）三种邮箱类型，涵盖收发邮件、搜索、标签管理、附件下载、草稿管理和自动规则。
### 使用场景
- 用户需要查看收件箱、发送或回复邮件
- 用户需要搜索特定邮件或管理邮件标签/分类
- 用户需要下载附件或管理草稿
- 用户需要设置自动回复规则或触发智能体处理邮件
### 核心价值
- **统一接口**：三种邮箱通过统一 API 操作，降低使用复杂度
- **本地安全**：所有操作通过本地 API 完成，无需暴露凭证
- **智能联动**：支持自动规则和智能体邮件处理
## L2：详细规范
## API 基础信息 ## API 基础信息

91
skills/manage-skills/SKILL.md
View File

@@ -4,11 +4,11 @@ description: >-
管理 Agent 的技能生命周期：通过 HTTP API 导入、安装、更新、删除技能， 管理 Agent 的技能生命周期：通过 HTTP API 导入、安装、更新、删除技能，
或通过 AgentFS 文件系统直接编写符合规范的 SKILL.md。Use when 用户要求 或通过 AgentFS 文件系统直接编写符合规范的 SKILL.md。Use when 用户要求
安装技能、从 URL/Git 导入技能、编写新技能、或管理已有技能。 安装技能、从 URL/Git 导入技能、编写新技能、或管理已有技能。
version: 1.0.0 version: 1.0.1
type: meta type: meta
risk_level: low risk_level: low
status: enabled status: enabled
disable-model-invocation: true disable-model-invocation: false
tags: tags:
- skill - skill
- import - import
@@ -98,6 +98,7 @@ Content-Type: application/json
``` ```
**安全限制**： **安全限制**：
- 仅允许 HTTPS URL - 仅允许 HTTPS URL
- 文件大小上限 20MB - 文件大小上限 20MB
- 请求超时 30 秒 - 请求超时 30 秒
@@ -163,9 +164,7 @@ Content-Type: application/json
"id": "data-analysis", "id": "data-analysis",
"path": "data-analysis", "path": "data-analysis",
"content": "---\nname: 数据分析\n...", "content": "---\nname: 数据分析\n...",
"sidecarFiles": [ "sidecarFiles": [{ "name": "examples.md", "content": "..." }]
{ "name": "examples.md", "content": "..." }
]
}, },
{ {
"id": "report-writing", "id": "report-writing",
@@ -177,6 +176,7 @@ Content-Type: application/json
``` ```
API 会自动： API 会自动：
- 使用 `--depth=1` 浅克隆以减少下载量 - 使用 `--depth=1` 浅克隆以减少下载量
- 递归扫描目录中的 SKILL.md 文件 - 递归扫描目录中的 SKILL.md 文件
- 从目录名推导 skillId（fallback 从 frontmatter name 生成 slug） - 从目录名推导 skillId（fallback 从 frontmatter name 生成 slug）
@@ -315,6 +315,7 @@ Content-Type: application/json
``` ```
可选参数： 可选参数：
- `sourceAgentId` — 源 Agent ID（从 agent 级复制时必填） - `sourceAgentId` — 源 Agent ID（从 agent 级复制时必填）
- `sourceSource` — 源作用域：`project` | `agent` | `global` - `sourceSource` — 源作用域：`project` | `agent` | `global`
- `sourceWorkDir` — 源 project workDir（从 project 级复制时使用） - `sourceWorkDir` — 源 project workDir（从 project 级复制时使用）
@@ -410,8 +411,8 @@ requires:
### 错误处理 ### 错误处理
| 错误场景 | 处理方式 | | 错误场景 | 处理方式 |
|---------|---------| | -------- | -------- |
| ... | ... | | ... | ... |
``` ```
#### 使用 Write 工具创建技能示例 #### 使用 Write 工具创建技能示例
@@ -476,60 +477,60 @@ metadata:
#### Frontmatter 字段表 #### Frontmatter 字段表
| 字段 | 必填 | 类型 | 说明 | | 字段 | 必填 | 类型 | 说明 |
|------|------|------|------| | -------------------------- | -------- | -------- | -------------------------------------------------- |
| `description` | **必填** | string | 技能用途描述，建议包含 "Use when" 触发提示 | | `description` | **必填** | string | 技能用途描述，建议包含 "Use when" 触发提示 |
| `name` | 推荐 | string | 技能显示名称 | | `name` | 推荐 | string | 技能显示名称 |
| `version` | 推荐 | string | 语义版本号（如 `1.0.0`） | | `version` | 推荐 | string | 语义版本号（如 `1.0.0`） |
| `type` | 推荐 | enum | `procedural` / `conversational` / `meta` | | `type` | 推荐 | enum | `procedural` / `conversational` / `meta` |
| `risk_level` | 推荐 | enum | `low` / `medium` / `high` | | `risk_level` | 推荐 | enum | `low` / `medium` / `high` |
| `status` | 推荐 | enum | `enabled` / `disabled` | | `status` | 推荐 | enum | `enabled` / `disabled` |
| `tags` | 可选 | string[] | 标签列表，用于搜索和分类 | | `tags` | 可选 | string[] | 标签列表，用于搜索和分类 |
| `disable-model-invocation` | 可选 | boolean | `true` 时仅允许显式调用，默认 `false` | | `disable-model-invocation` | 可选 | boolean | `true` 时仅允许显式调用，默认 `false` |
| `requires` | 可选 | object | 依赖声明：`tools`、`optional_tools`、`connections` | | `requires` | 可选 | object | 依赖声明：`tools`、`optional_tools`、`connections` |
| `metadata` | 可选 | object | 元信息：`author`、`updated_at` | | `metadata` | 可选 | object | 元信息：`author`、`updated_at` |
| `market` | 可选 | object | 市场展示元数据（仅市场发布的技能需要） | | `market` | 可选 | object | 市场展示元数据（仅市场发布的技能需要） |
#### type 说明 #### type 说明
| 类型 | 含义 | 示例 | | 类型 | 含义 | 示例 |
|------|------|------| | ---------------- | ------------------------ | ---------------------- |
| `procedural` | 流程型，按步骤执行 | 数据分析流程、审批流程 | | `procedural` | 流程型，按步骤执行 | 数据分析流程、审批流程 |
| `conversational` | 对话型，通过多轮对话完成 | 需求收集、头脑风暴 | | `conversational` | 对话型，通过多轮对话完成 | 需求收集、头脑风暴 |
| `meta` | 元技能，管理其他资源 | 创建 Agent、管理技能 | | `meta` | 元技能，管理其他资源 | 创建 Agent、管理技能 |
#### Markdown Body 结构（L0 / L1 / L2） #### Markdown Body 结构（L0 / L1 / L2）
| 层级 | 内容 | 用途 | | 层级 | 内容 | 用途 |
|------|------|------| | ---- | ----------------------------------- | ------------------ |
| L0 | 一句话摘要 | 快速理解技能做什么 | | L0 | 一句话摘要 | 快速理解技能做什么 |
| L1 | 能力描述 + 使用场景 + 核心价值 | 判断是否适用 | | L1 | 能力描述 + 使用场景 + 核心价值 | 判断是否适用 |
| L2 | 详细规范：步骤、API、格式、错误处理 | 具体执行指南 | | L2 | 详细规范：步骤、API、格式、错误处理 | 具体执行指南 |
### 6. 作用域说明 ### 6. 作用域说明
技能存在三个作用域层级，按优先级从高到低： 技能存在三个作用域层级，按优先级从高到低：
| 优先级 | 作用域 | 路径 | 可见范围 | | 优先级 | 作用域 | 路径 | 可见范围 |
|--------|--------|------|---------| | ------ | ---------- | ---------------------------------------- | ------------------ |
| 最高 | Project 级 | `.claude/skills/` (项目根目录) | 当前项目所有 Agent | | 最高 | Project 级 | `.claude/skills/` (项目根目录) | 当前项目所有 Agent |
| 中 | Agent 级 | `~/.desirecore/agents/{agentId}/skills/` | 仅该 Agent | | 中 | Agent 级 | `~/.desirecore/agents/{agentId}/skills/` | 仅该 Agent |
| 最低 | Global 级 | `~/.desirecore/skills/` | 所有 Agent | | 最低 | Global 级 | `~/.desirecore/skills/` | 所有 Agent |
**同名覆盖规则**：高优先级作用域的同名技能会覆盖低优先级的。例如 Agent 级有一个 `data-analysis` 技能，会覆盖全局同名技能。 **同名覆盖规则**：高优先级作用域的同名技能会覆盖低优先级的。例如 Agent 级有一个 `data-analysis` 技能，会覆盖全局同名技能。
### 7. 错误处理 ### 7. 错误处理
| 错误码 | 场景 | 处理方式 | | 错误码 | 场景 | 处理方式 |
|--------|------|---------| | ------ | ----------------------------- | -------------------------------------- |
| 400 | 缺少必填字段或格式无效 | 提示用户检查输入，说明哪个字段有问题 | | 400 | 缺少必填字段或格式无效 | 提示用户检查输入，说明哪个字段有问题 |
| 400 | SKILL.md frontmatter 校验失败 | 展示校验错误详情，引导用户修正 | | 400 | SKILL.md frontmatter 校验失败 | 展示校验错误详情，引导用户修正 |
| 404 | 技能不存在 | 提示技能 ID 可能拼写错误，列出可用技能 | | 404 | 技能不存在 | 提示技能 ID 可能拼写错误，列出可用技能 |
| 404 | Git 仓库中无 SKILL.md | 提示仓库格式不符合技能规范 | | 404 | Git 仓库中无 SKILL.md | 提示仓库格式不符合技能规范 |
| 409 | 技能已存在（冲突写入） | 建议使用 PUT 更新而非 POST 创建 | | 409 | 技能已存在（冲突写入） | 建议使用 PUT 更新而非 POST 创建 |
| 413 | 远程文件超过 20MB | 提示文件过大，建议精简内容 | | 413 | 远程文件超过 20MB | 提示文件过大，建议精简内容 |
| 504 | URL 抓取超时 | 提示网络超时，建议检查 URL 或稍后重试 | | 504 | URL 抓取超时 | 提示网络超时，建议检查 URL 或稍后重试 |
| 500 | 服务器内部错误 | 提示用户稍后再试 | | 500 | 服务器内部错误 | 提示用户稍后再试 |
### 8. 权限说明 ### 8. 权限说明

31
skills/manage-teams/SKILL.md
View File

@@ -1,7 +1,7 @@
--- ---
name: 团队管理 name: 团队管理
description: 创建和管理 Agent 团队，组织多 Agent 协作。Use when 需要多个 Agent 围绕同一任务协作、需要建立组织架构、或需要组长统一调度分派任务时。 description: 创建和管理 Agent 团队，组织多 Agent 协作。Use when 需要多个 Agent 围绕同一任务协作、需要建立组织架构、或需要组长统一调度分派任务时。
version: 1.2.0 version: 1.2.1
type: procedural type: procedural
risk_level: medium risk_level: medium
status: enabled status: enabled
@@ -11,7 +11,7 @@ tags:
- organization - organization
metadata: metadata:
author: desirecore author: desirecore
updated_at: '2026-03-29' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -34,11 +34,32 @@ market:
category: productivity category: productivity
--- ---
# 团队管理技能 # manage-teams 技能
## 概述 ## L0：一句话摘要
团队是 DesireCore 中多个 Agent 围绕共同任务协作的组织单元。每个团队有一个组长（supervisor）负责接收需求、拆解任务、分派给成员、汇总结果。 创建和管理 Agent 团队，组织多 Agent 围绕共同任务协作。
## L1：概述与使用场景
### 能力描述
manage-teams 是一个**流程型技能（Procedural Skill）**，赋予 DesireCore 创建和管理 Agent 团队的能力。团队是多个 Agent 围绕共同任务协作的组织单元，每个团队有一个组长（supervisor）负责接收需求、拆解任务、分派给成员、汇总结果。
### 使用场景
- 需要多个 Agent 围绕同一任务持续协作（如项目组）
- 需要建立组织架构（部门/团队层级）
- 需要组长统一调度、拆解和分派任务
- 简单一次性委派不够，需要共享上下文的长期协作
### 核心价值
- **组织化协作**：从单点委派升级为团队协作模式
- **灵活管理**：支持临时团队和持久团队两种模式
- **动态调整**：运行时可添加/移除成员、更换组长
## L2：详细规范
## 核心概念 ## 核心概念

25
skills/pdf/SKILL.md
View File

@@ -9,7 +9,7 @@ description: >-
user mentions a .pdf file or asks to produce one, use this skill. Use when user mentions a .pdf file or asks to produce one, use this skill. Use when
用户提到 PDF、读取PDF、合并PDF、拆分PDF、填写表单、加水印、提取文字、 用户提到 PDF、读取PDF、合并PDF、拆分PDF、填写表单、加水印、提取文字、
扫描识别。 扫描识别。
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -21,7 +21,7 @@ tags:
- ocr - ocr
metadata: metadata:
author: anthropic author: anthropic
updated_at: '2026-04-04' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -43,7 +43,26 @@ market:
channel: latest channel: latest
--- ---
# PDF Processing Guide # pdf 技能
## L0：一句话摘要
读取、创建、合并、拆分和填写 PDF 文档，支持 OCR 识别和命令行工具。
## L1：概述与使用场景
### 能力描述
pdf 是一个**流程型技能（Procedural Skill）**，提供 PDF 文档的完整处理能力。基于 Python 库（pypdf、pdfplumber、reportlab）和命令行工具（qpdf、pdftotext、pdftk），支持文本提取、表格提取、合并拆分、旋转、水印、加密、表单填写和 OCR 识别。
### 使用场景
- 用户需要从 PDF 中提取文本或表格数据
- 用户需要合并多个 PDF 或拆分页面
- 用户需要创建新的 PDF 文档
- 用户需要填写 PDF 表单、添加水印或加密
## L2：详细规范
## Prerequisites ## Prerequisites

25
skills/pptx/SKILL.md
View File

@@ -12,7 +12,7 @@ description: >-
content afterward. If a .pptx file needs to be opened, created, or touched, content afterward. If a .pptx file needs to be opened, created, or touched,
use this skill. Use when 用户提到 PPT、演示文稿、幻灯片、演讲稿、汇报材料、 use this skill. Use when 用户提到 PPT、演示文稿、幻灯片、演讲稿、汇报材料、
pptx、创建演示、编辑幻灯片。 pptx、创建演示、编辑幻灯片。
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -25,7 +25,7 @@ tags:
- office - office
metadata: metadata:
author: anthropic author: anthropic
updated_at: '2026-04-04' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -48,7 +48,26 @@ market:
channel: latest channel: latest
--- ---
# PPTX Skill # pptx 技能
## L0：一句话摘要
创建、编辑和处理 PowerPoint 演示文稿（.pptx），支持模板编辑和从零创建。
## L1：概述与使用场景
### 能力描述
pptx 是一个**流程型技能（Procedural Skill）**，提供 PowerPoint 演示文稿的完整处理能力。支持通过 pptxgenjs（Node.js）从零创建演示文稿，通过解包 XML 编辑现有模板，以及内容提取和视觉质检。
### 使用场景
- 用户需要创建新的演示文稿（汇报材料、Pitch Deck 等）
- 用户需要编辑或修改现有 .pptx 文件
- 用户需要从 .pptx 文件中提取文本内容
- 用户需要将演示文稿转换为 PDF 或图片
## L2：详细规范
## Prerequisites ## Prerequisites

30
skills/s3-storage-operations/SKILL.md
View File

@@ -5,7 +5,7 @@ version: 2.0.1
type: procedural type: procedural
risk_level: medium risk_level: medium
status: enabled status: enabled
disable-model-invocation: true disable-model-invocation: false
tags: tags:
- storage - storage
- s3 - s3
@@ -14,8 +14,8 @@ tags:
- sharing - sharing
metadata: metadata:
author: desirecore author: desirecore
version: "2.0.1" version: '2.0.1'
updated_at: "2026-03-13" updated_at: '2026-03-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -78,13 +78,13 @@ PORT=$(cat ~/.desirecore/agent-service.port)
### API 端点 ### API 端点
| 端点 | 方法 | 说明 | | 端点 | 方法 | 说明 |
|------|------|------| | --------------------- | ------ | ------------------------------- |
| `/api/s3/connections` | GET | 列出可用连接摘要 | | `/api/s3/connections` | GET | 列出可用连接摘要 |
| `/api/s3/upload` | POST | 上传文件（multipart/form-data） | | `/api/s3/upload` | POST | 上传文件（multipart/form-data） |
| `/api/s3/download` | GET | 生成下载链接或下载文件 | | `/api/s3/download` | GET | 生成下载链接或下载文件 |
| `/api/s3/list` | GET | 列出对象 | | `/api/s3/list` | GET | 列出对象 |
| `/api/s3/objects` | DELETE | 删除对象 | | `/api/s3/objects` | DELETE | 删除对象 |
### 快速参考 ### 快速参考
@@ -129,11 +129,11 @@ curl -k -X DELETE "https://127.0.0.1:${PORT}/api/s3/objects" \
### 安全红线 ### 安全红线
| 规则 | 说明 | | 规则 | 说明 |
|------|------| | -------------------- | ----------------------------------------------------- |
| **禁止上传敏感文件** | `.env`、凭证文件、私钥等绝不上传 | | **禁止上传敏感文件** | `.env`、凭证文件、私钥等绝不上传 |
| **删除前必须确认** | 调用删除 API 前应与用户确认意图 | | **删除前必须确认** | 调用删除 API 前应与用户确认意图 |
| **不假设连接存在** | API 返回 `NO_CONNECTION` 时，引导用户在界面中添加连接 | | **不假设连接存在** | API 返回 `NO_CONNECTION` 时，引导用户在界面中添加连接 |
### 集成点 ### 集成点

88
skills/update-agent/SKILL.md
View File

@@ -3,11 +3,11 @@ name: 更新智能体
description: >- description: >-
安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent
行为、安装/卸载技能、调整配置、回滚变更或修订规则。 行为、安装/卸载技能、调整配置、回滚变更或修订规则。
version: 3.0.0 version: 3.0.1
type: meta type: meta
risk_level: low risk_level: low
status: enabled status: enabled
disable-model-invocation: true disable-model-invocation: false
tags: tags:
- agent - agent
- update - update
@@ -67,14 +67,14 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
### 支持的更新类型 ### 支持的更新类型
| 更新类型 | 目标文件 | 风险等级 | 示例 | | 更新类型 | 目标文件 | 风险等级 | 示例 |
|---------|---------|---------|------| | --------------- | --------------- | -------- | -------------------- |
| Persona 更新 | `persona.md` | 中 | 修改沟通风格、价值观 | | Persona 更新 | `persona.md` | 中 | 修改沟通风格、价值观 |
| Principles 更新 | `principles.md` | 高 | 添加/修改行为规则 | | Principles 更新 | `principles.md` | 高 | 添加/修改行为规则 |
| Skills 安装 | `skills/` | 中 | 添加新技能包 | | Skills 安装 | `skills/` | 中 | 添加新技能包 |
| Skills 卸载 | `skills/` | 低 | 移除技能包 | | Skills 卸载 | `skills/` | 低 | 移除技能包 |
| Memory 更新 | `memory/` | 低 | 添加知识条目 | | Memory 更新 | `memory/` | 低 | 添加知识条目 |
| Tools 配置 | `tools/` | 高 | 修改工具权限 | | Tools 配置 | `tools/` | 高 | 修改工具权限 |
### 对话流程 ### 对话流程
@@ -92,6 +92,7 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
### 阶段 1：意图识别 ### 阶段 1：意图识别
**触发条件**（任一满足）： **触发条件**（任一满足）：
- 用户说"修改你的..."、"更新你的..."、"调整一下..." - 用户说"修改你的..."、"更新你的..."、"调整一下..."
- 用户说"你以后要..."、"记住这个规则..." - 用户说"你以后要..."、"记住这个规则..."
- 用户说"安装/卸载这个技能..." - 用户说"安装/卸载这个技能..."
@@ -103,21 +104,21 @@ update-agent 是一个**元技能（Meta-Skill）**，允许用户通过对话
**分析维度**： **分析维度**：
| 维度 | 说明 | | 维度 | 说明 |
|------|------| | -------- | ------------------------ |
| 影响范围 | 影响哪些文件、哪些行为 | | 影响范围 | 影响哪些文件、哪些行为 |
| 风险等级 | 低/中/高（见风险分级表） | | 风险等级 | 低/中/高（见风险分级表） |
| 依赖检查 | 是否影响其他配置 | | 依赖检查 | 是否影响其他配置 |
| 冲突检测 | 是否与现有规则冲突 | | 冲突检测 | 是否与现有规则冲突 |
**风险分级表**： **风险分级表**：
| 风险等级 | 条件 | 确认要求 | | 风险等级 | 条件 | 确认要求 |
|---------|------|---------| | -------- | ------------------------------ | ---------------------- |
| 低 | 仅影响非核心配置（如记忆条目） | 简单确认 | | 低 | 仅影响非核心配置（如记忆条目） | 简单确认 |
| 中 | 影响 persona 或普通 principles | 展示 diff 后确认 | | 中 | 影响 persona 或普通 principles | 展示 diff 后确认 |
| 高 | 影响核心 principles 或工具权限 | 详细说明 + diff + 确认 | | 高 | 影响核心 principles 或工具权限 | 详细说明 + diff + 确认 |
| 受保护 | 触及受保护路径 | 阻断，需 owner 权限 | | 受保护 | 触及受保护路径 | 阻断，需 owner 权限 |
### 阶段 3：Diff 生成 ### 阶段 3：Diff 生成
@@ -145,7 +146,7 @@ diff_metadata:
lines_removed: 1 lines_removed: 1
risk_level: medium risk_level: medium
reversible: true reversible: true
estimated_impact: "沟通风格会变得更正式" estimated_impact: '沟通风格会变得更正式'
``` ```
### 阶段 4：用户确认 ### 阶段 4：用户确认
@@ -168,6 +169,7 @@ diff_metadata:
``` ```
**确认选项**： **确认选项**：
- **应用**：执行变更 - **应用**：执行变更
- **取消**：放弃变更 - **取消**：放弃变更
- **修改**：进入编辑模式微调 - **修改**：进入编辑模式微调
@@ -220,34 +222,34 @@ git show <commit>:persona.md
**更新操作对照表**： **更新操作对照表**：
| 用户意图 | 目标文件 | AgentFS 路径 | | 用户意图 | 目标文件 | AgentFS 路径 |
|---------|---------|-------------| | -------------- | --------------- | ---------------------------------------------- |
| 修改性格/风格 | `persona.md` | `~/.desirecore/agents/<agentId>/persona.md` | | 修改性格/风格 | `persona.md` | `~/.desirecore/agents/<agentId>/persona.md` |
| 修改行为规则 | `principles.md` | `~/.desirecore/agents/<agentId>/principles.md` | | 修改行为规则 | `principles.md` | `~/.desirecore/agents/<agentId>/principles.md` |
| 安装/卸载技能 | `skills/` | `~/.desirecore/agents/<agentId>/skills/` | | 安装/卸载技能 | `skills/` | `~/.desirecore/agents/<agentId>/skills/` |
| 修改工具配置 | `tools/` | `~/.desirecore/agents/<agentId>/tools/` | | 修改工具配置 | `tools/` | `~/.desirecore/agents/<agentId>/tools/` |
| 添加记忆 | `memory/` | `~/.desirecore/agents/<agentId>/memory/` | | 添加记忆 | `memory/` | `~/.desirecore/agents/<agentId>/memory/` |
| 修改运行时配置 | `agent.json` | `~/.desirecore/agents/<agentId>/agent.json` | | 修改运行时配置 | `agent.json` | `~/.desirecore/agents/<agentId>/agent.json` |
### 错误处理 ### 错误处理
| 错误场景 | 处理方式 | | 错误场景 | 处理方式 |
|---------|---------| | ------------------ | -------------------------------------- |
| 尝试修改受保护路径 | 阻断操作，提示需要 owner 权限 | | 尝试修改受保护路径 | 阻断操作，提示需要 owner 权限 |
| 文件不存在 | Agent 或目标文件不存在，提示用户检查 | | 文件不存在 | Agent 或目标文件不存在，提示用户检查 |
| 权限不足 | 文件系统权限错误，提示用户检查目录权限 | | 权限不足 | 文件系统权限错误，提示用户检查目录权限 |
| 回滚版本不存在 | 列出可用版本，请用户重新选择 | | 回滚版本不存在 | 列出可用版本，请用户重新选择 |
### 权限要求 ### 权限要求
| 操作 | 所需角色 | | 操作 | 所需角色 |
|------|---------| | --------------------------- | ------------- |
| 更新 persona | owner, member | | 更新 persona | owner, member |
| 更新 principles（普通规则） | owner, member | | 更新 principles（普通规则） | owner, member |
| 更新 principles（安全红线） | owner | | 更新 principles（安全红线） | owner |
| 安装/卸载 skills | owner, member | | 安装/卸载 skills | owner, member |
| 修改 tools 权限 | owner | | 修改 tools 权限 | owner |
| 版本回滚 | owner | | 版本回滚 | owner |
--- ---

33
skills/web-access/SKILL.md
View File

@@ -14,7 +14,7 @@ description: >-
新闻、网址、URL、找一下、搜一下、查一下、小红书、B站、微博、飞书、Twitter、 新闻、网址、URL、找一下、搜一下、查一下、小红书、B站、微博、飞书、Twitter、
推特、X、知乎、公众号、已登录、登录状态。 推特、X、知乎、公众号、已登录、登录状态。
license: Complete terms in LICENSE.txt license: Complete terms in LICENSE.txt
version: 1.1.0 version: 1.1.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -29,7 +29,7 @@ tags:
- playwright - playwright
metadata: metadata:
author: desirecore author: desirecore
updated_at: '2026-04-07' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -54,15 +54,32 @@ market:
channel: latest channel: latest
--- ---
# Web Access Skill # web-access 技能
Three-layer web access toolkit: ## L0：一句话摘要
1. **Layer 1 — Search & Fetch**: `WebSearch` + `WebFetch` for public pages 三层联网访问工具包——搜索公开页面、Jina 优化抓取、CDP 登录态浏览器访问。
2. **Layer 2 — Jina Reader**: default token-optimized extraction for heavy/JS-rendered pages
3. **Layer 3 — CDP Browser**: Chrome DevTools Protocol for login-gated sites (小红书/B站/微博/飞书/Twitter)
--- ## L1：概述与使用场景
### 能力描述
web-access 是一个**流程型技能（Procedural Skill）**，提供三层互补的联网访问能力：Layer 1（WebSearch + WebFetch）用于公开页面；Layer 2（Jina Reader）用于 JS 渲染的重页面，默认节省 Token；Layer 3（Chrome CDP）用于需要登录态的站点（小红书/B站/微博/飞书/Twitter）。
### 使用场景
- 用户需要搜索当前信息或研究特定主题
- 用户需要抓取公开网页内容或技术文档
- 用户需要访问登录态站点（小红书、B站、微博、飞书、Twitter 等）
- 用户需要对比产品、聚合新闻或调查 API/库版本
### 核心价值
- **三层递进**：从轻量搜索到重度 JS 渲染到登录态访问，按需选择
- **Token 优化**：Jina Reader 默认减少 50-80% Token 消耗
- **登录态复用**：通过 CDP 连接用户已登录的 Chrome，无需重复登录
## L2：详细规范
## Output Rule ## Output Rule

25
skills/xlsx/SKILL.md
View File

@@ -15,7 +15,7 @@ description: >-
report, standalone Python script, database pipeline, or Google Sheets API report, standalone Python script, database pipeline, or Google Sheets API
integration, even if tabular data is involved. Use when 用户提到 Excel、 integration, even if tabular data is involved. Use when 用户提到 Excel、
电子表格、xlsx、表格处理、公式计算、数据清洗、图表、CSV导入导出。 电子表格、xlsx、表格处理、公式计算、数据清洗、图表、CSV导入导出。
version: 1.0.0 version: 1.0.1
type: procedural type: procedural
risk_level: low risk_level: low
status: enabled status: enabled
@@ -27,7 +27,7 @@ tags:
- office - office
metadata: metadata:
author: anthropic author: anthropic
updated_at: '2026-04-04' updated_at: '2026-04-13'
market: market:
icon: >- icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -50,6 +50,27 @@ market:
channel: latest channel: latest
--- ---
# xlsx 技能
## L0：一句话摘要
创建、编辑和分析 Excel 电子表格（.xlsx），支持公式、格式、数据分析和可视化。
## L1：概述与使用场景
### 能力描述
xlsx 是一个**流程型技能（Procedural Skill）**，提供 Excel 电子表格的完整处理能力。基于 Python 库（openpyxl、pandas），支持创建新表格、编辑现有文件、数据分析、公式计算、格式设置和图表生成，并通过 LibreOffice 实现公式重算和错误检测。
### 使用场景
- 用户需要创建新的 Excel 电子表格（财务模型、数据报告等）
- 用户需要编辑或修改现有 .xlsx 文件
- 用户需要进行数据分析、清洗或格式转换（CSV/TSV → XLSX）
- 用户需要添加公式、图表或格式化现有表格
## L2：详细规范
## Prerequisites ## Prerequisites
### Python 3（必需） ### Python 3（必需）