oneworks-mem

当任务发生在 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：用于当前物理 ChildSession 的临时工作记忆；不会作为跨轮连续记忆自动加载。
• global：用于跨频道也成立的通用事实或用户明确要求全局记住的规则；谨慎使用。

什么时候读取

优先在这些场景读取相关记忆：

• 用户提到“之前”“上次”“按老配置”“记得我说过”“继续那个问题”等跨轮上下文。
• 任务需要知道频道长期背景、平台 id、项目约定、常见故障、用户偏好或之前的决策。
• 当前请求含糊，但已有记忆可能决定正确做法。
• 在群聊或私聊中遇到不熟的人、昵称、群内梗、项目名、表情含义、图片语境或关系距离，且这些信息会影响回复语气或任务判断时，先读小本本，不要只靠猜。
• 用户问“你知道 X 吗”“你还记得 X 吗”，或你准备吐槽/接梗但不确定上下文时，先 oneworks mem get / oneworks mem get -s user / oneworks mem list。
• 准备写入前，先 get 或 list，避免重复、冲突或把同一主题写到多个地方。

运行时加载结构化记忆时会先匹配可见性 group。orgs 必须命中；conversationTypes、entities、rooms、channels 等维度在同一 group 内按 OR、不同 group 之间按 AND 组合。不要因为实体名相同，就假设另一个组织、群聊或会话中的记忆可见。候选选择和预算也会按 visibility group 分配，避免单一高频群聊挤占全部上下文。