oneworks-memlisted
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` 默认指向当前这条消息的发送者。
## 快速命令
- `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>`:记忆维度,支持 `channel`、`user`、`session`、`global`。
## Scope 选择
- `channel`:默认 scope。用于当前群聊、私聊、帖子或平台会话的长期上下文;适合频道主题、项目背景、群约定、常用配置、长期排障线索。
- `user`:用于当前发送者个人相关信息;适合姓名、称呼、职责、稳定偏好、常用工作方式。只在信息来自本人、被明确确认,或对任务持续有用时写入。群聊中不要手填 sender id,让 CLI 从当前消息上下文解析。
- `session`:用于当前 OneWorks session 的临时工作记忆;适合本次任务状态、排查步骤、未完成 TODO、刚形成但未必长期有效的结论。
- `global`:用于跨频道也成立的通用事实或用户明确要求全局记住的规则;谨慎使用。
## 什么时候读取
优先在这些场景读取相关记忆:
- 用户提到“之前”“上次”“按老配置”“记得我说过”“继续那个问题”等跨轮上下文。
- 任务需要知道频道长期背景、平台 id、项目约定、常见故障、用户偏好或之前的决策。
- 当前请求含糊,但已有记忆可能决定正确做法。
- 在群聊或私聊中遇到不熟的人、昵称、群内梗、项目名、表情含义、图片语境或关系距离,且这些信息会影响回复语气或任务判断时,