給AI Agent裝上長期記憶OneCLI記憶編輯與自定義技能Skills編寫完全指南【免費(fèi)下載鏈接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onecli如果你正在使用 AI Agent 卻為它聊完就忘而煩惱OneCLI 是一個值得關(guān)注的開源項(xiàng)目——它是一套面向團(tuán)隊(duì)的沙箱化 Agent 平臺sandboxed agent harness讓每位員工都擁有一位安全的私人 Agent。本文圍繞兩個核心能力展開Agent 記憶編輯與自定義技能Skills編寫幫助新手快速讓 Agent 擁有跨會話的長期記憶并用一份份 SKILL.md 教會它專屬工作流。 什么是 OneCLIOneCLI 的核心思路是Agent 跑在一次性沙箱里但知識留在平臺側(cè)。沙箱容器隨時可以銷毀重建而記憶與技能都存在平臺每次啟動自動恢復(fù)。這意味著記憶是持久的——跨對話、跨會話、跨定時任務(wù)都生效記憶是可見可編輯的——團(tuán)隊(duì)成員可以在儀表盤中直接修改帶完整歷史技能是可分發(fā)的——組織級、工作區(qū)級、個人 Agent 級三層技能體系。 記憶系統(tǒng)讓 Agent記住你記憶的工作原理在 OneCLI 中Agent 的記憶就是它主目錄下memory/文件夾里的一組 Markdown 文件——一條記憶對應(yīng)一個文件另有一個自動生成的memory/index.md目錄索引。關(guān)鍵設(shè)計平臺才是唯一數(shù)據(jù)源。Agent 在沙箱里編輯文件后幾秒內(nèi)就會同步harvest回平臺反過來你在儀表盤上的修改也會實(shí)時反映到 Agent 正在運(yùn)行的環(huán)境里。這一投影 回采機(jī)制的完整實(shí)現(xiàn)見 memory-file.ts 和 memory-harvest.ts。Agent 自帶的 4 個記憶工具Agent 通過 MCP 工具自主管理記憶定義在 memory.ts工具作用memory_save按 key 保存或更新一條記憶同名即更新保留歷史memory_list列出所有記憶的 key、標(biāo)題與摘要memory_search按內(nèi)容搜索記憶返回帶高亮片段的匹配項(xiàng)memory_get按 key 讀取某條記憶的完整內(nèi)容平臺內(nèi)置的記憶守則同樣值得了解該記就記持久事實(shí)、用戶偏好、你做出的糾正、決策與工作發(fā)現(xiàn)尤其是定時任務(wù)它沒有聊天歷史可依絕不存秘密密碼、令牌、API 密鑰一律不存只存指針如密鑰在儀表盤里更新優(yōu)于堆積優(yōu)先更新一條好記憶而不是堆滿近似重復(fù)。在儀表盤中編輯記憶記憶不需要你只會看。儀表盤的記憶頁面memory/page.tsx/w/[workspaceId]/agents/[agentId]/memory/page.tsx)提供完整編輯能力對應(yīng) API 路由實(shí)現(xiàn)見 agent-memories.ts創(chuàng)建 / 編輯 / 刪除直接增刪改任意一條記憶版本歷史每次修改都留痕可查看任意歷史版本一鍵恢復(fù)把某條記憶回滾到舊版本restore內(nèi)容打碼某條記憶意外包含敏感信息時可用redact對歷史版本脫敏。前端交互邏輯可參考 use-memories.ts其中useRestoreRevision、useRedactRevision等 Hook 與上述能力一一對應(yīng)。小貼士在儀表盤中刪除文件不等于刪除記憶——平臺會恢復(fù)它。正確的退休方式是覆蓋內(nèi)容標(biāo)注為廢棄或在儀表盤中刪除。 Skills 技能系統(tǒng)教 Agent 新的工作方式三層技能體系OneCLI 的技能分三個層級詳見 skills.ts 路由 與 org-skills.ts組織級Org由管理員在組織設(shè)置中維護(hù)對整個組織生效工作區(qū)中只讀工作區(qū)級Workspace對某個工作區(qū)內(nèi)所有 Agent 生效Agent 個人級某個 Agent 自己的技能可由 Agent 自己在對話中創(chuàng)建。同名規(guī)則下個人技能會為你覆蓋上層同名技能——方便針對某個 Agent 做個性化定制。讓 Agent 自己編寫技能這是 OneCLI 最有趣的設(shè)計之一Agent 可以在對話中通過工具創(chuàng)建技能實(shí)現(xiàn)對話中創(chuàng)建、儀表盤里修正的閉環(huán)。技能創(chuàng)作工具定義在 skills.tsskill_create創(chuàng)建一個新技能幾秒內(nèi)就出現(xiàn)在儀表盤和沙箱的技能目錄中skill_update更新描述、內(nèi)容或啟用/暫停狀態(tài)enabled: false相當(dāng)于臨時停用文件會移出目錄skill_delete徹底刪除自己創(chuàng)建的技能skill_list列出所有可達(dá)技能及其層級歸屬。SKILL.md 編寫最佳實(shí)踐每個技能就是一個目錄核心是一份SKILL.md。寫好它只需記住三點(diǎn)名字用短橫線小寫詞如release-checklist創(chuàng)建后不可修改它是目錄名也是引用句柄描述行前置觸發(fā)詞description是技能的第一行決定 Agent什么時候加載它請寫清楚適用場景而非泛泛而談?wù)氖蔷唧w指令Markdown 格式的逐步操作指引Agent 會自己讀取文件并照做。技能內(nèi)容上限為 24,000 字符需要附帶參考文件時可到儀表盤中添加。前端技能管理邏輯見 use-skills.ts頁面入口為 skills/page.tsx/w/[workspaceId]/agents/[agentId]/skills/page.tsx) 與組織側(cè) skills/page.tsx/org/[orgId]/(admin)/skills/page.tsx)。? 常見問題Q沙箱重建后記憶還在嗎在。記憶與技能都存于平臺機(jī)器可隨時替換memory/目錄每次啟動都會從平臺恢復(fù)。Q人和 Agent 同時編輯會沖突嗎你的編輯是實(shí)時的Agent 運(yùn)行中文件會被更新且規(guī)則明確文件比記憶更新——以文件為準(zhǔn)。Q技能文件能被 Agent 隨意改壞嗎不能。技能文件對沙箱內(nèi)是只讀的創(chuàng)作與修改必須走平臺的skill_*工具或儀表盤。 小結(jié)記憶memory/下的一組 Markdown 文件 平臺側(cè)唯一數(shù)據(jù)源支持版本歷史、恢復(fù)與脫敏技能 三層可分發(fā)的SKILL.md工作流Agent 可在對話中自主創(chuàng)建、儀表盤統(tǒng)一管理相關(guān)源碼入口memory 能力、skills 能力、API 路由、協(xié)議層記憶文件格式。按本指南操作幾分鐘內(nèi)你就能讓 OneCLI 的 Agent 記住團(tuán)隊(duì)約定、沉淀專屬 SOP——長期記憶與可編寫技能正是個人 Agent 從玩具走向生產(chǎn)力工具的關(guān)鍵一步。【免費(fèi)下載鏈接】onecliOpen-source sandboxed agent harness for teams. Giving every employee a secured personal agent.項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onecli創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考