oneworks-ai 当任务发生在 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 分配，避免单一高频群聊挤占全部上下文。
常用读取：
oneworks mem get
oneworks mem list
oneworks mem get -s user
oneworks mem get -s entity
oneworks mem get -s conversation
oneworks mem get -s session
oneworks mem get -p ./reference/wechat.md
什么时候写入
写入应服务于未来任务，不要把普通流水账塞进记忆。适合写入：
- 有人主动介绍自己，例如姓名、称呼、职责、项目角色、联系方式偏好。
- 用户给出稳定偏好，例如回复语言、排查顺序、审批习惯、常用模型或工具选择。
- 频道形成稳定背景，例如群聊讨论的项目、接入方式、服务地址、常见命令、长期约定。
- 一次较长讨论产生明确结论，例如问题根因、修复方案、还未做的后续动作。
- 任务中发现可复用的事实，例如某平台 id 的含义、某 webhook 的配置注意事项。
- 你刚刚从聊天中理解了一个原本不熟的群友、群内梗、项目名、表情用法、互动边界或话题背景，并且它会帮助未来更自然地回应。
写入时尽量和当前聊天话题保持一致：同一主题聚合到同一个文件，摘要短而可执行，避免跨主题混写。
每次只写一个稳定事实、偏好、约定或可复用经验。保留当前 child run、来源消息和可见性上下文作为证据；这些绑定由 runtime 与 CLI 自动完成，不要在正文里伪造平台 id 或来源字段。
不要只在 Chat History 里写“我会记住”或“应该记录”；需要记忆时要真的调用 oneworks mem patch，让工具调用记录出现在过程里。
写入格式建议
默认 README.md 适合放简短总览。复杂主题用 reference/<topic>.md 或 topics/<topic>.md：
oneworks mem patch "用户偏好：希望排查链路时先验证公网入口，再看服务日志。"
oneworks mem patch -s user "用户自我介绍：二姐，主要维护 WeChat channel 接入。"
oneworks mem patch -s entity "Lark 长连接重启前先确认没有其它 workspace 占用同一应用。"
oneworks mem patch -s conversation "本次排查：已确认 webhook secret 正确，下一步检查回调日志。"
oneworks mem patch -s session "临时工作区：当前只读日志位于本子会话生成的路径。"
oneworks mem patch -p ./reference/wechat.md "WechatApi 重连后需要重新注册 callback。"
对已有内容做结构化整理时，可以读取后再 set 覆盖，但只在你确信重写会提升质量时使用：
oneworks mem get -p ./reference/wechat.md
oneworks mem set -p ./reference/wechat.md "整理后的内容..."
oneworks mem uses the narrow permission key bash-oneworks-mem. Channel runtime allows this built-in narrow permission by default, without requiring .oo.config.json edits. This should not be treated as allowing arbitrary Bash.
不应该写入
- 密码、token、密钥、cookie、验证码、私有证书或其他凭据。
- 未确认猜测、模型自己的推断、短期情绪、无复用价值的寒暄。
- 大段原始日志、长对话全文、代码 diff。只保存未来需要的摘要和索引。
- 与当前任务无关的敏感个人信息。即使来自用户本人，也要判断是否确实有助于未来任务。
如果命令失败，要让用户感知失败原因；不要假装记忆已经保存。