mirror of
https://gitcode.com/JianFeeeee/TrulyMEM-TrueHumanMEM.git
synced 2026-10-30 13:59:11 +00:00
P1: 完善 skill 文档 - 强调增强而非替换
- 更新 graph-memory/SKILL.md：添加与 memory-core 关系对比表 - 更新 graph-memory-persona/SKILL.md：添加定位声明和使用建议 - 更新 graph-memory-task/SKILL.md：添加定位声明和使用建议 - 更新 bundled-skills/ 下对应文件
This commit is contained in:
root
@ -1,6 +1,6 @@
|
||||
---
|
||||
name: graph-memory-persona
|
||||
description: "管理 AI 人设 - 更新或清除 AI 角色特征。使用 persona_update 更新、persona_clear 清除"
|
||||
description: "管理 AI 人设 - 更新或清除 AI 角色特征。作为增强工具，通过 graph_memory 的 persona_update/clear 操作实现"
|
||||
metadata: {"openclaw": {"requires": {"bins": ["node"]}}}
|
||||
user-invocable: true
|
||||
---
|
||||
@ -9,6 +9,14 @@ user-invocable: true
|
||||
|
||||
管理 AI 的人设/角色特征。
|
||||
|
||||
> **定位声明**：本 skill 通过 `graph_memory` 工具的 `persona_update`/`persona_clear` 操作实现。是 **OpenClaw 的增强功能**，不替代任何核心机制。LLM 可自主选择是否查询/更新人设。
|
||||
|
||||
## 与主系统的关系
|
||||
|
||||
- **不强制**：不会每轮自动查询人设，由 LLM 根据上下文决定
|
||||
- **可选调用**：当用户提到"记住我是..."、"你的角色是..."等场景时触发
|
||||
- **数据存储**：人设数据以三元组形式存储在图数据库中（subject=AI）
|
||||
|
||||
## 操作
|
||||
|
||||
### 1. persona_update - 更新人设
|
||||
@ -16,18 +24,19 @@ user-invocable: true
|
||||
更新 AI 的角色特征。
|
||||
|
||||
**参数:**
|
||||
- `attributes`: 属性数组，每个包含 attribute 和 value
|
||||
- `mode`: 更新模式（merge 合并或 replace 替换）
|
||||
- `attributes`: 属性数组，每个包含 `attribute`（属性名）和 `value`（属性值）
|
||||
- `mode`: 更新模式，`merge`（合并，默认）或 `replace`（替换）
|
||||
|
||||
**示例:**
|
||||
```
|
||||
```yaml
|
||||
action: persona_update
|
||||
attributes:
|
||||
- attribute: "角色"
|
||||
value: "猫娘"
|
||||
- attribute: "性格"
|
||||
value: "活泼"
|
||||
mode: "merge"
|
||||
params:
|
||||
attributes:
|
||||
- attribute: "角色"
|
||||
value: "猫娘"
|
||||
- attribute: "性格"
|
||||
value: "活泼"
|
||||
mode: "merge"
|
||||
```
|
||||
|
||||
### 2. persona_clear - 清除人设
|
||||
@ -35,10 +44,17 @@ mode: "merge"
|
||||
清除 AI 的所有角色特征。
|
||||
|
||||
**参数:**
|
||||
- `confirm`: 确认为 true 才能执行清除
|
||||
- `confirm`: 必须为 `true` 才能执行清除（安全措施）
|
||||
|
||||
**示例:**
|
||||
```
|
||||
```yaml
|
||||
action: persona_clear
|
||||
confirm: true
|
||||
params:
|
||||
confirm: true
|
||||
```
|
||||
|
||||
## 使用建议
|
||||
|
||||
1. 人设信息应简洁、持久（如"用户喜欢Python"、"我是技术助手"）
|
||||
2. 避免存储临时性、易变的信息到人设图
|
||||
3. 与 memory-core 配合：人设由 GraphMemory 管理，对话风格由系统提示管理
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
---
|
||||
name: graph-memory-task
|
||||
description: "管理连续性任务 - 创建、更新、删除任务节点。使用 task_create 创建、task_set_state 更新状态"
|
||||
description: "管理连续性任务 - 创建、更新、删除任务节点。作为增强工具，通过 graph_memory 的 task_* 操作实现"
|
||||
metadata: {"openclaw": {"requires": {"bins": ["node"]}}}
|
||||
user-invocable: true
|
||||
---
|
||||
@ -9,6 +9,14 @@ user-invocable: true
|
||||
|
||||
管理长期/连续性任务。
|
||||
|
||||
> **定位声明**：本 skill 通过 `graph_memory` 工具的 `task_create`/`task_set_state`/`task_delete`/`task_link_info` 操作实现。是 **OpenClaw 的增强功能**，提供任务追踪能力，不替代任何核心机制。
|
||||
|
||||
## 与主系统的关系
|
||||
|
||||
- **不强制**：不会每轮自动查询任务状态，由 LLM 根据用户请求决定
|
||||
- **可选调用**：当用户提到"帮我记住这个任务"、"完成这个任务"等场景时触发
|
||||
- **数据存储**：任务数据以三元组形式存储在图数据库中（subject=task_id）
|
||||
|
||||
## 操作
|
||||
|
||||
### 1. task_create - 创建任务
|
||||
@ -16,16 +24,17 @@ user-invocable: true
|
||||
创建新的任务节点。
|
||||
|
||||
**参数:**
|
||||
- `task_id`: 唯一任务标识
|
||||
- `description`: 任务描述
|
||||
- `info_nodes`: 可选的相关信息节点
|
||||
- `task_id`: 唯一任务标识（必需）
|
||||
- `description`: 任务描述（必需）
|
||||
- `info_nodes`: 可选的相关信息节点数组
|
||||
|
||||
**示例:**
|
||||
```
|
||||
```yaml
|
||||
action: task_create
|
||||
task_id: "Task_学习TypeScript"
|
||||
description: "学习 TypeScript 并完成项目"
|
||||
info_nodes: ["TypeScript文档", "教程链接"]
|
||||
params:
|
||||
task_id: "Task_学习TypeScript"
|
||||
description: "学习 TypeScript 并完成项目"
|
||||
info_nodes: ["TypeScript文档", "教程链接"]
|
||||
```
|
||||
|
||||
### 2. task_set_state - 设置状态
|
||||
@ -33,20 +42,35 @@ info_nodes: ["TypeScript文档", "教程链接"]
|
||||
更新任务状态。
|
||||
|
||||
**参数:**
|
||||
- `task_id`: 任务ID
|
||||
- `state`: 新状态 (进行中/已完成/已暂停/已取消)
|
||||
- `task_id`: 任务ID（必需）
|
||||
- `state`: 新状态，`进行中`/`已完成`/`已暂停`/`已取消`（必需）
|
||||
|
||||
**示例:**
|
||||
```yaml
|
||||
action: task_set_state
|
||||
params:
|
||||
task_id: "Task_学习TypeScript"
|
||||
state: "已完成"
|
||||
```
|
||||
|
||||
### 3. task_delete - 删除任务
|
||||
|
||||
删除任务节点。
|
||||
|
||||
**参数:**
|
||||
- `task_id`: 任务ID
|
||||
- `task_id`: 任务ID（必需）
|
||||
|
||||
### 4. task_link_info - 关联信息
|
||||
|
||||
将信息节点关联到任务。
|
||||
|
||||
**参数:**
|
||||
- `task_id`: 任务ID
|
||||
- `info_node`: 信息节点
|
||||
- `task_id`: 任务ID（必需）
|
||||
- `info_node`: 信息节点名称（必需）
|
||||
|
||||
## 使用建议
|
||||
|
||||
1. 任务ID应具有描述性（如 `Task_学习TypeScript`）
|
||||
2. 任务描述应清晰说明目标和上下文
|
||||
3. 定期使用 `recall` 查询任务状态，了解进行中的任务
|
||||
4. 与 memory-core 配合：任务列表由 GraphMemory 管理，具体执行细节由对话上下文管理
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
---
|
||||
name: graph-memory
|
||||
description: "图记忆工具 - 检索、写入、删除记忆，管理人设和任务。使用 recall 检索、commit 写入、purge 删除"
|
||||
description: "图记忆工具 - 检索、写入、删除记忆。作为 OpenClaw memory-core 的增强补充，不替代其核心功能"
|
||||
metadata: {"openclaw": {"requires": {"bins": ["node"]}}}
|
||||
user-invocable: true
|
||||
---
|
||||
@ -9,6 +9,18 @@ user-invocable: true
|
||||
|
||||
让 AI 拥有真正的长期记忆能力。
|
||||
|
||||
> **定位声明**：本工具是 **OpenClaw memory-core 的增强补充**，而非替代。memory-core 负责 session transcripts 和历史消息管理，GraphMemory 提供图数据库形式的结构化长期记忆。两者可并存运行。
|
||||
|
||||
## 与 memory-core 的关系
|
||||
|
||||
| 功能 | memory-core | GraphMemory (本工具) |
|
||||
|------|-------------|---------------------|
|
||||
| 对话历史 | ✅ 自动保存 messages | ❌ 不管理对话历史 |
|
||||
| 结构化记忆 | ❌ 无 | ✅ 三元组图存储 |
|
||||
| 人设管理 | ❌ 无 | ✅ persona_update/clear |
|
||||
| 任务追踪 | ❌ 无 | ✅ task_create/set_state |
|
||||
| 自动触发 | ✅ 自动索引检索 | ❌ LLM 可选调用 |
|
||||
|
||||
## 核心概念
|
||||
|
||||
### 实体 (Entity)
|
||||
@ -24,7 +36,7 @@ user-invocable: true
|
||||
将信息写入记忆图。
|
||||
|
||||
**参数：**
|
||||
- `triplets`: 三元组数组 `[{subject, relation, object}, ...]`
|
||||
- `triplets`: 三元组数组 `[{subject, relation, object}, ...]` （必需）
|
||||
- `sessionId`: 会话 ID（可选）
|
||||
- `turnId`: 轮次 ID（可选）
|
||||
|
||||
@ -51,9 +63,9 @@ AI 会执行：
|
||||
从记忆图中检索相关信息。
|
||||
|
||||
**参数：**
|
||||
- `queryIntent`: 搜索关键词
|
||||
- `seedEntities`: 种子实体（可选）
|
||||
- `depth`: 检索深度（默认 2）
|
||||
- `queryIntent`: 搜索关键词（必需，若无则需提供 seedEntities）
|
||||
- `seedEntities`: 种子实体数组（可选）
|
||||
- `depth`: 检索深度 1-5（默认 2）
|
||||
- `sessionFilter`: 会话过滤（可选）
|
||||
|
||||
### 3. purge - 删除记忆
|
||||
@ -63,11 +75,11 @@ AI 会执行：
|
||||
**参数：**
|
||||
- `criteria`: 删除条件 `{subject, target, relation, sessionId}`
|
||||
- `mode`: 删除模式 `soft`（标记删除）、`hard`（彻底删除）或 `supersede`（纠错替代）
|
||||
- `newRelation`: 替代关系（supersede 模式）
|
||||
- `newRelation`: 替代关系（supersede 模式必需）
|
||||
|
||||
### 4. introspect - 查看状态
|
||||
|
||||
查看当前记忆状态统计。
|
||||
查看当前记忆状态统计（实体数、关系数）。
|
||||
|
||||
### 5. archive - 归档旧记忆
|
||||
|
||||
@ -81,54 +93,7 @@ AI 会执行：
|
||||
物理删除已删除超过 90 天的关系和孤立节点。
|
||||
|
||||
**参数：**
|
||||
- `dry_run`: 仅预览不删除（默认 true）
|
||||
|
||||
### 7. persona_update - 更新人设
|
||||
|
||||
更新 AI 的角色/性格特征。
|
||||
|
||||
**参数：**
|
||||
- `attributes`: 属性数组 `[{attribute, value}, ...]`
|
||||
- `mode`: `merge`（合并）或 `replace`（替换）
|
||||
|
||||
### 8. persona_clear - 清除人设
|
||||
|
||||
清除 AI 的所有角色设定。
|
||||
|
||||
**参数：**
|
||||
- `confirm`: 必须为 `true` 才能执行
|
||||
|
||||
### 9. task_create - 创建任务
|
||||
|
||||
创建长期任务节点。
|
||||
|
||||
**参数：**
|
||||
- `task_id`: 唯一任务 ID
|
||||
- `description`: 任务描述
|
||||
- `info_nodes`: 相关信息节点（可选）
|
||||
|
||||
### 10. task_set_state - 设置任务状态
|
||||
|
||||
更新任务状态。
|
||||
|
||||
**参数：**
|
||||
- `task_id`: 任务 ID
|
||||
- `state`: 新状态（进行中/已完成/已暂停/已取消）
|
||||
|
||||
### 11. task_delete - 删除任务
|
||||
|
||||
删除任务。
|
||||
|
||||
**参数：**
|
||||
- `task_id`: 任务 ID
|
||||
|
||||
### 12. task_link_info - 关联信息
|
||||
|
||||
将信息节点关联到任务。
|
||||
|
||||
**参数：**
|
||||
- `task_id`: 任务 ID
|
||||
- `info_node`: 信息节点
|
||||
- `dry_run`: 仅预览不删除（默认 true，建议先预览再执行）
|
||||
|
||||
## 使用原则
|
||||
|
||||
@ -136,3 +101,4 @@ AI 会执行：
|
||||
2. **结构化**：使用三元组格式存储关系
|
||||
3. **定期清理**：删除过时或错误的信息
|
||||
4. **关联思考**：利用关系进行联想记忆
|
||||
5. **与 memory-core 配合**：对话历史由 memory-core 管理，结构化事实由 GraphMemory 管理
|
||||
|
||||
Reference in New Issue
Block a user