✓ 已加载环境配置文件：/path/to/.env
✓ 成功连接到 Milvus 实例：http://your-instance.milvus.ivolces.com:19530
✓ 成功创建集合：task_memory

python scripts/milvus_manager.py --action get --memory-id <记忆ID>

✓ 已加载环境配置文件：/path/to/.env
✓ 成功连接到 Milvus 实例：http://your-instance.milvus.ivolces.com:19530
✓ 找到任务：550e8400-e29b-41d4-a716-446655440000
✓ 任务已保存，ID：550e8400-e29b-41d4-a716-446655440000
✓ 任务状态已更新：550e8400-e29b-41d4-a716-446655440000 -> completed

✓ 已加载环境配置文件：/path/to/.env
✓ 成功连接到 Milvus 实例：http://your-instance.milvus.ivolces.com:19530
✓ 任务已删除：550e8400-e29b-41d4-a716-446655440000

长期任务记忆管理

功能说明

本 Skill 提供火山引擎 Milvus 向量数据库的操作能力，用于长期记忆的存储与检索。

核心能力：

• - 建立连接：连接到 Milvus 数据库实例
• 存储记忆：保存任务、事件、项目等信息到向量数据库
• 查询搜索：按条件检索历史记忆
• 更新记录：修改已存储的记忆信息
• 删除记录：清理不需要的记忆

使用方式：当用户明确要求保存到长期记忆、查询历史任务、更新记忆状态、删除记录等操作时调用。

前置准备

环境配置

编辑 .env 文件，填写 Milvus 连接信息：
bash

Milvus 实例访问地址

MILVUS_URI=http://your-instance.milvus.ivolces.com:19530

Milvus 认证令牌（格式：Username:Password）

MILVUS_TOKEN=root:yourpassword

.env 文件加载优先级：

1. 1. 脚本所在目录（scripts/.env）
2. 当前工作目录（./.env）
3. Skill 根目录（long-term-task-memory/.env）

获取配置信息：

1. 1. 登录火山引擎控制台
2. 进入向量数据库 Milvus 服务
3. 创建或选择实例
4. 在实例详情页获取访问地址（URI）
5. 使用实例的用户名和密码组成 Token

数据格式

灵活的数据结构

支持多维度区分的灵活数据格式：

json
{
memory_id: 唯一标识（可选，自动生成）,
content: 记忆内容描述,
category: 分类（task/event/project/note等）,
role: 角色标识（如：pm/dev/manager等）,
project: 项目名称,
event: 事件名称,
status: 状态（pending/in_progress/completed等）,
priority: 优先级（high/medium/low）,
tags: [标签1, 标签2],
context: {
自定义上下文信息: 支持任意JSON结构
},
metadata: {
自定义元数据: 支持任意JSON结构
}
}

维度说明

维度	字段	说明	示例值
分类	category	记忆类型	task、event、project、note、decision
角色

role | 相关角色 | pm、dev、manager、designer | | 项目 | project | 所属项目 | website-redesign、app-v2 | | 事件 | event | 相关事件 | sprint-2024-q1、release-2.0 | | 状态 | status | 当前状态 | pending、in_progress、completed、archived | | 优先级 | priority | 重要程度 | high、medium、low | | 标签 | tags | 自定义标签 | [urgent, backend, api] | | 上下文 | context | 背景信息 | 任意 JSON 结构 | | 元数据 | metadata | 额外信息 | 任意 JSON 结构 |

操作手册

1. 建立连接

功能：初始化数据库连接并创建集合（如不存在）

命令：
bash
python scripts/milvus_manager.py --action init

参数：

• - --action init：执行初始化操作
• --collection：集合名称（可选，默认：task_memory）
• --recreate：是否重建集合（可选，会删除现有数据）

示例：
bash

初始化默认集合

python scripts/milvus_manager.py --action init

初始化指定集合

python scripts/milvusmanager.py --action init --collection projectmemory

重建集合（清空数据）

python scripts/milvus_manager.py --action init --recreate

输出：

✓ 已加载环境配置文件：/path/to/.env
✓ 成功连接到 Milvus 实例：http://your-instance.milvus.ivolces.com:19530
✓ 成功创建集合：task_memory

---

2. 存储记忆

功能：将记忆信息保存到数据库

命令：
bash
python scripts/milvus_manager.py --action save --memory-file <文件路径>

参数：

• - --action save：执行保存操作
• --memory-file：记忆信息文件路径（JSON 格式）
• --collection：集合名称（可选）

准备记忆文件：

创建 memory.json 文件：
json
{
content: 完成用户认证模块的重构，采用 JWT 令牌方案,
category: task,
role: dev,
project: website-redesign,
event: sprint-2024-q1,
status: completed,
priority: high,
tags: [backend, auth, jwt],
context: {
tech_stack: [Python, FastAPI],
estimated_hours: 16,
completed_date: 2024-03-15
},
metadata: {
assignee: 张三,
reviewer: 李四,
related_docs: [api-docs.md, auth-guide.md]
}
}

示例：
bash

保存记忆

python scripts/milvus_manager.py --action save --memory-file ./memory.json

保存到指定集合

python scripts/milvusmanager.py --action save --memory-file ./memory.json --collection projectmemory

输出：

✓ 已加载环境配置文件：/path/to/.env
✓ 成功连接到 Milvus 实例：http://your-instance.milvus.ivolces.com:19530
✓ 任务已保存，ID：550e8400-e29b-41d4-a716-446655440000

更多示例：

json
// 项目记忆
{
content: Website 重构项目，目标是在 Q2 完成前端升级,
category: project,
project: website-redesign,
status: in_progress,
priority: high,
tags: [frontend, react, typescript],
context: {
start_date: 2024-01-01,
target_date: 2024-06-30,
budget: 500k
}
}

// 事件记忆
{
content: 2024 Q1 冲刺计划会议，确定优先级排序,
category: event,
event: sprint-2024-q1,
project: website-redesign,
tags: [meeting, planning],
context: {
date: 2024-01-05,
participants: [PM, Tech Lead, Devs],
decisions: [优先完成用户认证, 推迟支付模块]
}
}

// 决策记忆
{
content: 决定采用微服务架构重构后端系统,
category: decision,
role: manager,
project: backend-refactor,
tags: [architecture, critical],
context: {
date: 2024-02-20,
reason: 现有单体架构无法支撑业务增长,
alternatives: [继续单体架构, SOA架构]
}
}

---

3. 查询搜索

功能：按条件检索历史记忆

命令：
bash
python scripts/milvus_manager.py --action query [过滤参数]

参数：

• - --action query：执行查询操作
• --category：按分类过滤
• --role：按角色过滤
• --project：按项目过滤
• --event：按事件过滤
• --status：按状态过滤
• --priority：按优先级过滤
• --limit：返回数量限制（默认：10）
• --collection：集合名称（可选）

示例：

bash

查询所有待处理的任务

python scripts/milvus_manager.py --action query --status pending

查询特定项目的所有记忆

python scripts/milvus_manager.py --action query --project website-redesign

查询开发角色的任务

python scripts/milvus_manager.py --action query --role dev --category task

查询特定事件的相关记忆

python scripts/milvus_manager.py --action query --event sprint-2024-q1

组合查询：高优先级的进行中任务

python scripts/milvusmanager.py --action query --status inprogress --priority high

查询最近 20 条记录

python scripts/milvus_manager.py --action query --limit 20

输出：

✓