back
loading skill details...
简化主代理与子代理间记忆交换、归档和管理,支持操作记录和极简脚本工具,提升多代理协作效率。
# Memory Manager Skill
## 概述
简化记忆管理系统,支持主代理与子代理间的记忆交换、归档和管理。
## 功能特性
- ✅ **简化目录结构**:清晰的记忆组织方式
- ✅ **代理记忆交换**:主代理与子代理间的可控记忆共享
- ✅ **文件归档管理**:按需归档,避免混乱
- ✅ **操作记录系统**:所有操作自动记录
- ✅ **极简脚本工具**:避免复杂语法问题
## 适用场景
1. **多代理协作**:主代理与写作助手等子代理间的记忆共享
2. **项目记忆管理**:写作项目、分析项目等的记忆组织
3. **长期记忆维护**:重要记忆的归档和版本管理
4. **系统状态监控**:记忆系统健康状态检查
## 快速开始
### 1. 安装技能
```bash
# 通过ClawHub安装(如果发布)
clawhub install memory-manager
# 或手动复制到skills目录
```
### 2. 初始化系统
```powershell
# 检查系统状态
.\scripts\memory_check.ps1
# 检查代理状态
.\scripts\agent_check.ps1 list
```
### 3. 基本使用
```powershell
# 查看共享文件
.\scripts\memory_check.ps1 -Action list-files
# 归档文件
.\scripts\archive_tool.ps1 -File "character_profiles.md" -Reason "季度备份"
```
## 目录结构
```
memory/
├── main/ # 主代理记忆
├── shared_pool/ # 共享记忆池
├── agent_access/ # 子代理访问点
├── logs/ # 操作记录
├── archive/ # 归档文件
└── temp/ # 临时文件
```
## 配置说明
### 默认配置 (config/default.json)
```json
{
"base_dir": "D:\\openclaw\\.openclaw\\workspace\\memory",
"agents": {
"writing-assistant": {
"path": "D:\\writing-bot\\workspace\\memory",
"name": "Writing Assistant"
}
},
"archive_retention_days": 30,
"log_retention_days": 90
}
```
## 工具脚本
### memory_check.ps1
- **功能**:检查记忆系统状态
- **参数**:`status`, `list-files`, `list-dirs`
- **示例**:`.\memory_check.ps1 status`
### agent_check.ps1
- **功能**:检查代理状态
- **参数**:`list`, `check <agent-name>`
- **示例**:`.\agent_check.ps1 list`
### simple_logger.ps1
- **功能**:简单操作记录
- **参数**:自动调用,无需手动使用
- **用途**:内部工具,供其他脚本调用
### archive_tool.ps1
- **功能**:文件归档
- **参数**:`-File <path>`, `-Reason <description>`
- **示例**:`.\archive_tool.ps1 -File "project.md" -Reason "项目完成"`
## 使用示例
### 示例1:日常检查
```powershell
# 检查系统状态
.\scripts\memory_check.ps1
# 检查代理状态
.\scripts\agent_check.ps1 list
# 列出共享文件
.\scripts\memory_check.ps1 -Action list-files
```
### 示例2:文件归档
```powershell
# 归档单个文件
.\scripts\archive_tool.ps1 -File "project_progress.md" -Reason "月度归档"
# 批量归档(通过循环)
Get-ChildItem "memory\main\shared\*.md" | ForEach-Object {
.\scripts\archive_tool.ps1 -File $_.FullName -Reason "批量清理"
}
```
### 示例3:代理记忆访问
```powershell
# 检查写作助手记忆空间
.\scripts\agent_check.ps1 check writing-assistant
# 如果需要访问,可以通过配置文件路径直接访问
```
## 最佳实践
### 1. 定期检查
- 每周检查一次系统状态
- 每月检查一次归档文件
- 每季度清理一次临时文件
### 2. 文件命名规范
- 活跃文件:`filename.md`
- 归档文件:`filename_archived_YYYYMMDD.md`
- 待删除:`filename_delete_YYYYMMDD.md`
### 3. 操作记录
- 所有重要操作都应有记录
- 记录文件保存在`logs/`目录
- 定期备份记录文件
### 4. 安全注意事项
- 敏感文件不要放入共享目录
- 归档前检查文件内容
- 定期清理临时文件
## 故障排除
### 常见问题
#### Q1: 脚本执行报错
**问题**:PowerShell脚本执行报语法错误
**解决**:
1. 使用极简脚本版本
2. 检查文件编码(使用UTF-8无BOM)
3. 避免复杂语法结构
#### Q2: 代理路径不存在
**问题**:代理检查显示路径不存在
**解决**:
1. 检查代理配置文件
2. 确认代理工作空间是否存在
3. 更新配置文件中的路径
#### Q3: 归档文件名不正确
**问题**:归档后文件名没有按预期重命名
**解决**:
1. 手动重命名文件
2. 使用简化版归档工具
3. 检查文件扩展名处理
#### Q4: 记录文件为空
**问题**:操作记录文件创建但内容为空
**解决**:
1. 使用`simple_logger.ps1`
2. 检查JSON生成逻辑
3. 验证文件写入权限
## 扩展开发
### 添加新代理
1. 编辑`config/default.json`
2. 添加代理配置
3. 测试代理访问
### 自定义归档规则
1. 修改`archive_tool.ps1`
2. 添加自定义命名规则
3. 测试归档功能
### 集成到工作流
1. 在AGENTS.md中添加记忆检查步骤
2. 设置定期检查任务
3. 集成到项目工作流中
## 版本历史
### v1.0.0 (2026-04-17)
- 初始版本发布
- 基础记忆管理功能
- 代理记忆交换支持
- 简化脚本工具集
## 支持与反馈
### 问题报告
如遇问题,请提供:
1. 错误信息截图
2. 操作步骤
3. 系统环境信息
### 功能建议
如需新功能,请描述:
1. 使用场景
2. 预期行为
3. 优先级评估
### 联系方式
- 通过OpenClaw会话反馈
- 查看文档获取更多信息
---
*技能ID: memory-manager*
*版本: 1.0.0*
*创建日期: 2026-04-17*
*最后更新: 2026-04-17*don't have the plugin yet? install it then click "run inline in claude" again.