P1: 完善 skill 文档 - 强调增强而非替换

- 更新 graph-memory/SKILL.md：添加与 memory-core 关系对比表
- 更新 graph-memory-persona/SKILL.md：添加定位声明和使用建议
- 更新 graph-memory-task/SKILL.md：添加定位声明和使用建议
- 更新 bundled-skills/ 下对应文件

ts/bundled-skills/graph-memory-persona/SKILL.md

@@ -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,19 +9,52 @@ user-invocable: true
 
 管理 AI 的人设/角色特征。
 
+> **定位声明**：本 skill 通过 `graph_memory` 工具的 `persona_update`/`persona_clear` 操作实现。是 **OpenClaw 的增强功能**，不替代任何核心机制。LLM 可自主选择是否查询/更新人设。
+
+## 与主系统的关系
+
+- **不强制**：不会每轮自动查询人设，由 LLM 根据上下文决定
+- **可选调用**：当用户提到"记住我是..."、"你的角色是..."等场景时触发
+- **数据存储**：人设数据以三元组形式存储在图数据库中（subject=AI）
+
 ## 操作
 
 ### 1. persona_update - 更新人设
 
 更新 AI 的角色特征。
 
-**参数**:
-- `attributes`: 属性数组，每个包含 attribute 和 value
-- `mode`: 更新模式（merge 合并或 replace 替换）
+**参数:**
+- `attributes`: 属性数组，每个包含 `attribute`（属性名）和 `value`（属性值）
+- `mode`: 更新模式，`merge`（合并，默认）或 `replace`（替换）
+
+**示例:**
+```yaml
+action: persona_update
+params:
+  attributes:
+    - attribute: "角色"
+      value: "猫娘"
+    - attribute: "性格"
+      value: "活泼"
+  mode: "merge"
+```
 
 ### 2. persona_clear - 清除人设
 
 清除 AI 的所有角色特征。
 
-**参数**:
-- `confirm`: 确认为 true 才能执行清除
+**参数:**
+- `confirm`: 必须为 `true` 才能执行清除（安全措施）
+
+**示例:**
+```yaml
+action: persona_clear
+params:
+  confirm: true
+```
+
+## 使用建议
+
+1. 人设信息应简洁、持久（如"用户喜欢Python"、"我是技术助手"）
+2. 避免存储临时性、易变的信息到人设图
+3. 与 memory-core 配合：人设由 GraphMemory 管理，对话风格由系统提示管理

ts/bundled-skills/graph-memory-task/SKILL.md

@@ -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,36 +9,68 @@ user-invocable: true
 
 管理长期/连续性任务。
 
+> **定位声明**：本 skill 通过 `graph_memory` 工具的 `task_create`/`task_set_state`/`task_delete`/`task_link_info` 操作实现。是 **OpenClaw 的增强功能**，提供任务追踪能力，不替代任何核心机制。
+
+## 与主系统的关系
+
+- **不强制**：不会每轮自动查询任务状态，由 LLM 根据用户请求决定
+- **可选调用**：当用户提到"帮我记住这个任务"、"完成这个任务"等场景时触发
+- **数据存储**：任务数据以三元组形式存储在图数据库中（subject=task_id）
+
 ## 操作
 
 ### 1. task_create - 创建任务
 
 创建新的任务节点。
 
-**参数**:
-- `task_id`: 唯一任务标识
-- `description`: 任务描述
-- `info_nodes`: 可选的相关信息节点
+**参数:**
+- `task_id`: 唯一任务标识（必需）
+- `description`: 任务描述（必需）
+- `info_nodes`: 可选的相关信息节点数组
+
+**示例:**
+```yaml
+action: task_create
+params:
+  task_id: "Task_学习TypeScript"
+  description: "学习 TypeScript 并完成项目"
+  info_nodes: ["TypeScript文档", "教程链接"]
+```
 
 ### 2. task_set_state - 设置状态
 
 更新任务状态。
 
-**参数**:
-- `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 管理，具体执行细节由对话上下文管理

ts/bundled-skills/graph-memory/SKILL.md

@@ -1,24 +1,44 @@
 ---
 name: graph-memory
-description: "图记忆工具 - 检索、写入、删除记忆，管理人设和任务。使用 recall 检索、commit 写入、purge 删除"
+description: "图记忆工具 - 检索、写入、删除记忆，管理人设和任务。作为 OpenClaw memory-core 的增强补充，不替代其核心功能"
 metadata: {"openclaw": {"requires": {"bins": ["node"]}}}
 user-invocable: true
 ---
 
-# GraphMemory 图记忆操作
+# GraphMemory 图记忆系统
 
-你可以通过以下操作与图记忆系统交互。
+让 AI 拥有真正的长期记忆能力。
 
-## 核心操作
+> **定位声明**：本工具是 **OpenClaw memory-core 的增强补充**，而非替代。memory-core 负责 session transcripts 和历史消息管理，GraphMemory 提供图数据库形式的结构化长期记忆。两者可并存运行。
+
+## 与 memory-core 的关系
+
+| 功能 | memory-core | GraphMemory (本工具) |
+|------|-------------|---------------------|
+| 对话历史 | ✅ 自动保存 messages | ❌ 不管理对话历史 |
+| 结构化记忆 | ❌ 无 | ✅ 三元组图存储 |
+| 人设管理 | ❌ 无 | ✅ persona_update/clear |
+| 任务追踪 | ❌ 无 | ✅ task_create/set_state |
+| 自动触发 | ✅ 自动索引检索 | ❌ LLM 可选调用 |
+
+## 核心概念
+
+### 实体 (Entity)
+现实世界中的对象，如"用户"、"Python"、"WaterFlow"。
+
+### 关系 (Relation)
+连接两个实体的关系，格式为三元组：主体 - 关系 - 客体。
+
+## 可用命令
 
 ### 1. recall - 检索记忆
 
 从记忆图中检索相关信息。
 
 **参数**:
-- `queryIntent`: 搜索意图/关键词
+- `queryIntent`: 搜索意图/关键词（必需，若无则需提供 seedEntities）
 - `seedEntities`: 可选的种子实体名
-- `depth`: 检索深度
+- `depth`: 检索深度 1-5（默认 2）
 - `sessionFilter`: 可选的会话ID过滤
 
 ### 2. commit - 写入记忆
@@ -26,7 +46,7 @@ user-invocable: true
 将信息写入记忆图。
 
 **参数**:
-- `triplets`: 三元组数组，每个包含 subject, relation, object
+- `triplets`: 三元组数组，每个包含 subject, relation, object（必需）
 - `sessionId`: 会话ID
 - `turnId`: 轮次ID
 
@@ -37,7 +57,7 @@ user-invocable: true
 **参数**:
 - `criteria`: 删除条件 (subject, target, relation, sessionId)
 - `mode`: 删除模式 (soft/hard/supersede)
-- `newRelation`: 可选的替代关系
+- `newRelation`: 替代关系（supersede 模式必需）
 
 ### 4. introspect - 查看状态
 
@@ -63,3 +83,4 @@ user-invocable: true
 2. **结构化**: 使用三元组 (主体-关系-客体) 格式
 3. **关联**: 通过关系连接相关实体
 4. **定期清理**: 删除过时或错误的信息
+5. **与 memory-core 配合**: 对话历史由 memory-core 管理，结构化事实由 GraphMemory 管理