给AI Agent装上长期记忆：OneCLI记忆编辑与自定义技能（Skills）编写完全指南

给AI Agent装上长期记忆OneCLI记忆编辑与自定义技能Skills编写完全指南【免费下载链接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.项目地址: https://gitcode.com/gh_mirrors/on/onecli如果你正在使用 AI Agent 却为它聊完就忘而烦恼OneCLI 是一个值得关注的开源项目——它是一套面向团队的沙箱化 Agent 平台sandboxed agent harness让每位员工都拥有一位安全的私人 Agent。本文围绕两个核心能力展开Agent 记忆编辑与自定义技能Skills编写帮助新手快速让 Agent 拥有跨会话的长期记忆并用一份份 SKILL.md 教会它专属工作流。 什么是 OneCLIOneCLI 的核心思路是Agent 跑在一次性沙箱里但知识留在平台侧。沙箱容器随时可以销毁重建而记忆与技能都存在平台每次启动自动恢复。这意味着记忆是持久的——跨对话、跨会话、跨定时任务都生效记忆是可见可编辑的——团队成员可以在仪表盘中直接修改带完整历史技能是可分发的——组织级、工作区级、个人 Agent 级三层技能体系。 记忆系统让 Agent记住你记忆的工作原理在 OneCLI 中Agent 的记忆就是它主目录下memory/文件夹里的一组 Markdown 文件——一条记忆对应一个文件另有一个自动生成的memory/index.md目录索引。关键设计平台才是唯一数据源。Agent 在沙箱里编辑文件后几秒内就会同步harvest回平台反过来你在仪表盘上的修改也会实时反映到 Agent 正在运行的环境里。这一投影 回采机制的完整实现见 memory-file.ts 和 memory-harvest.ts。Agent 自带的 4 个记忆工具Agent 通过 MCP 工具自主管理记忆定义在 memory.ts工具作用memory_save按 key 保存或更新一条记忆同名即更新保留历史memory_list列出所有记忆的 key、标题与摘要memory_search按内容搜索记忆返回带高亮片段的匹配项memory_get按 key 读取某条记忆的完整内容平台内置的记忆守则同样值得了解该记就记持久事实、用户偏好、你做出的纠正、决策与工作发现尤其是定时任务它没有聊天历史可依绝不存秘密密码、令牌、API 密钥一律不存只存指针如密钥在仪表盘里更新优于堆积优先更新一条好记忆而不是堆满近似重复。在仪表盘中编辑记忆记忆不需要你只会看。仪表盘的记忆页面memory/page.tsx/w/[workspaceId]/agents/[agentId]/memory/page.tsx)提供完整编辑能力对应 API 路由实现见 agent-memories.ts创建 / 编辑 / 删除直接增删改任意一条记忆版本历史每次修改都留痕可查看任意历史版本一键恢复把某条记忆回滚到旧版本restore内容打码某条记忆意外包含敏感信息时可用redact对历史版本脱敏。前端交互逻辑可参考 use-memories.ts其中useRestoreRevision、useRedactRevision等 Hook 与上述能力一一对应。小贴士在仪表盘中删除文件不等于删除记忆——平台会恢复它。正确的退休方式是覆盖内容标注为废弃或在仪表盘中删除。 Skills 技能系统教 Agent 新的工作方式三层技能体系OneCLI 的技能分三个层级详见 skills.ts 路由 与 org-skills.ts组织级Org由管理员在组织设置中维护对整个组织生效工作区中只读工作区级Workspace对某个工作区内所有 Agent 生效Agent 个人级某个 Agent 自己的技能可由 Agent 自己在对话中创建。同名规则下个人技能会为你覆盖上层同名技能——方便针对某个 Agent 做个性化定制。让 Agent 自己编写技能这是 OneCLI 最有趣的设计之一Agent 可以在对话中通过工具创建技能实现对话中创建、仪表盘里修正的闭环。技能创作工具定义在 skills.tsskill_create创建一个新技能几秒内就出现在仪表盘和沙箱的技能目录中skill_update更新描述、内容或启用/暂停状态enabled: false相当于临时停用文件会移出目录skill_delete彻底删除自己创建的技能skill_list列出所有可达技能及其层级归属。SKILL.md 编写最佳实践每个技能就是一个目录核心是一份SKILL.md。写好它只需记住三点名字用短横线小写词如release-checklist创建后不可修改它是目录名也是引用句柄描述行前置触发词description是技能的第一行决定 Agent什么时候加载它请写清楚适用场景而非泛泛而谈正文是具体指令Markdown 格式的逐步操作指引Agent 会自己读取文件并照做。技能内容上限为 24,000 字符需要附带参考文件时可到仪表盘中添加。前端技能管理逻辑见 use-skills.ts页面入口为 skills/page.tsx/w/[workspaceId]/agents/[agentId]/skills/page.tsx) 与组织侧 skills/page.tsx/org/[orgId]/(admin)/skills/page.tsx)。❓ 常见问题Q沙箱重建后记忆还在吗在。记忆与技能都存于平台机器可随时替换memory/目录每次启动都会从平台恢复。Q人和 Agent 同时编辑会冲突吗你的编辑是实时的Agent 运行中文件会被更新且规则明确文件比记忆更新——以文件为准。Q技能文件能被 Agent 随意改坏吗不能。技能文件对沙箱内是只读的创作与修改必须走平台的skill_*工具或仪表盘。 小结记忆memory/下的一组 Markdown 文件 平台侧唯一数据源支持版本历史、恢复与脱敏技能 三层可分发的SKILL.md工作流Agent 可在对话中自主创建、仪表盘统一管理相关源码入口memory 能力、skills 能力、API 路由、协议层记忆文件格式。按本指南操作几分钟内你就能让 OneCLI 的 Agent 记住团队约定、沉淀专属 SOP——长期记忆与可编写技能正是个人 Agent 从玩具走向生产力工具的关键一步。【免费下载链接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.项目地址: https://gitcode.com/gh_mirrors/on/onecli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考