← ClaudeAtlas

oneworks-memlisted

说明 agent 如何用 oneworks mem CLI 在 entity、channel、conversation、user、session、global 维度读写记忆,并判断什么时候应该读取、追加或更新记忆。
oneworks-ai/app · ★ 18 · AI & Automation · score 72
Install: claude install-skill oneworks-ai/app
当任务发生在 channel 会话里,或用户要求保存、读取、整理长期上下文时使用这个 skill。`oneworks mem` 是给 agent 在 shell 中调用的 CLI,不是发送到聊天频道里的文本命令。 在 channel 会话中,默认认为 `oneworks mem` 已经由环境注入可用。不要为了确认是否存在而先执行 `which oneworks`、`oneworks --help` 或 `oneworks mem --help`;直接按下面示例调用,只有命令失败、参数不确定且示例不足,或用户明确要求时才查询 help。 在 channel 会话中,不要让模型自己抄写平台 id。`oneworks mem` 会从环境变量和 server 写入的当前消息上下文文件读取 session id、channel id、群聊当前发送者 sender id 等元数据。群聊里多人轮流说话时,`-s user` 默认指向当前这条消息的发送者。 当前实体的 `MEMORY_POLICY.md` 定义“什么值得记、什么不应记、如何表述和何时淘汰”;`entity.yaml` 的 `memory` 段定义可写 scope、证据、有效期、敏感数据和每轮预算等硬边界。语义策略和硬边界都高于本 skill 的通用建议。命令拒绝写入时,不要改用别的文件路径绕过策略。 ## 快速命令 - `oneworks mem get`:读取当前默认记忆文件,等价于当前 channel id 下的 `README.md`。 - `oneworks mem patch "内容"`:向当前默认记忆文件追加内容。 - `oneworks mem set "内容"`:覆盖当前默认记忆文件,只有明确要重写时使用。 - `oneworks mem list`:列出当前 scope 下已有记忆文件;不传 `-p` 时列出全部路径。 所有 subcommand 都支持: - `-p, --path <path>`:指定或过滤 id 下的相对文件路径。`get` / `set` / `patch` 默认 `README.md`,`list` 不传时不过滤路径。 - `-c, --channel <channel>`:指定或过滤 channel,例如 `wechat`。 - `-f, --filter <id>`:指定或过滤平台相关 id。对 `get` / `set` / `patch` 是目标 id,对 `list` 是过滤条件。 - `-s, --scope <scope>`:记忆维度,支持 `entity`、`channel`、`conversation`、`user`、`session`、`global`。 ## Scope 选择 - `entity`:用于当前实体跨 ChannelLink 复用的长期经验、操作约定和稳定判断。 - `channel`:默认 scope。用于当前群聊、私聊、帖子或平台会话的长期上下文;适合频道主题、项目背景、群约定、常用配置、长期排障线索。 - `conversation`:用于稳定对话线程的背景、决策和后续动作;新的物理 ChildSession 会继续加载。 - `user`:用于当前发送者个人相关信息;适合姓名、称呼、职责、稳定偏好、常用��作方式。只在信息来自本人、被明确确认,或对任务持续有用时写入。群聊中不要手填 sender id,让 CLI 从当前消息上下文解析。 - `session`:用于当前物理 ChildSess