文件設(shè)計完全解讀)
示例工程【免費下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點擊查看免費下載在開源教程build-your-own-openclaw中AGENTS.md、SOUL.md、BOOTSTRAP.md三個 Markdown 文件構(gòu)成了 AI Agent 工作區(qū)的核心設(shè)計它們分別定義智能體名冊、角色性格和工作區(qū)地圖并會在運行時自動拼裝成系統(tǒng)提示。本文將帶你從零看懂這套工作區(qū)文件設(shè)計理解為什么純文本文件就能讓 AI 智能體認(rèn)識自己、認(rèn)識隊友、認(rèn)識環(huán)境。 什么是工作區(qū)先認(rèn)識 default_workspace 目錄這套教程用 default_workspace/ 目錄模擬一個真實的智能體工作區(qū)所有配置文件都是人類可直接編輯的 Markdown 和 YAMLdefault_workspace/ ├── AGENTS.md # 智能體名冊 任務(wù)調(diào)度規(guī)則 ├── BOOTSTRAP.md # 工作區(qū)地圖目錄結(jié)構(gòu)、路徑模板 ├── config.example.yaml # 用戶配置模板模型、API 密鑰等 ├── agents/ │ ├── pickle/ │ │ ├── AGENT.md # 智能體配置與操作指令 │ │ └── SOUL.md # 智能體性格 │ └── cookie/ │ ├── AGENT.md │ └── SOUL.md └── skills/ └── cron-ops/SKILL.md # 可復(fù)用技能定義這個結(jié)構(gòu)在 default_workspace/BOOTSTRAP.md 中有完整說明配合 default_workspace/config.example.yaml 使用復(fù)制為config.user.yaml填入 API 密鑰即可運行。?? 注意區(qū)分根目錄的AGENTS.md是團隊名冊而每個智能體文件夾里的AGENT.md單數(shù)才是該智能體自己的身份證 操作手冊。 AGENT.md SOUL.md身份與性格的雙層設(shè)計以默認(rèn)智能體 Pickle 為例看兩個文件如何分工1?? AGENT.md —— 配置文件 操作手冊default_workspace/agents/pickle/AGENT.md 由兩部分組成部分內(nèi)容作用YAML Frontmattername、description、llmtemperature 等、allow_skills機器可讀程序據(jù)此加載配置Markdown 正文角色設(shè)定、Capabilities、行為準(zhǔn)則注入系統(tǒng)提示的身份層程序入口是 13-multi-layer-prompts/src/mybot/core/agent_loader.py 中的AgentLoader掃描agents/目錄、解析 Frontmatter、把llm配置與全局默認(rèn)值合并得到可運行的AgentDef。2?? SOUL.md —— 只寫性格的一層default_workspace/agents/pickle/SOUL.md 只有一句話You are Pickle, a friendly cat assistant... 溫暖、真誠帶一點貓的小動作但不過度賣萌。為什么單獨拆出來因為性格是可選層且需要保持穩(wěn)定。AgentDef中soul_md字段默認(rèn)空值運行時才拼接為## Personality段落。這樣你可以隨時改性格而不動配置也讓同一個工作區(qū)能容納風(fēng)格迥異的智能體PickleSOUL.md友好的貓咪助手temperature 0.7負(fù)責(zé)日常對話CookieAGENT.md、SOUL.md精確高效的記憶管理員temperature 0.3從不直接面對用戶只接收 Pickle 派發(fā)的任務(wù)? BOOTSTRAP.md智能體的工作區(qū)地圖default_workspace/BOOTSTRAP.md 回答三個問題東西放在哪目錄長什么樣每個文件干什么路徑模板{{workspace}}、{{skills_path}}、{{memories_path}}、{{agents_path}}等占位符在加載時由PromptBuilder._substitute_paths()替換為真實路徑見 13-multi-layer-prompts/src/mybot/core/prompt_builder.py目錄結(jié)構(gòu)agents / skills / crons / memories 四大子目錄memories 又分topics/永恒事實、projects/項目上下文、daily-notes/每日事件文件用途速查表明確寫出AGENT.md管配置、SOUL.md管性格、SKILL.md管技能、config.user.yaml管用戶偏好它就像新員工入職手冊——智能體啟動時看一眼地圖就知道去哪里找技能、去哪里讀寫記憶。 AGENTS.md智能體名冊與調(diào)度規(guī)則default_workspace/AGENTS.md 是工作區(qū)根目錄的團隊公告欄內(nèi)容極簡但關(guān)鍵章節(jié)內(nèi)容Agents 表格pickle默認(rèn)對話和 cookie記憶管理的職責(zé)一覽When to Dispatch什么時候該把任務(wù)派給專用智能體存記憶、查記憶、拿不準(zhǔn)時先問用戶Syntax Examplessubagent_dispatch(agent_id, task)的調(diào)用方式與典型示例它解決的正是多智能體協(xié)作的核心問題主智能體如何知道誰存在、誰擅長什么、什么場景該找誰。配合 15-agent-dispatch/README.zh.md 中的調(diào)度實現(xiàn)Pickle 遇到記住這件事就會自動派單給 Cookie而 Cookie 的完整記憶結(jié)構(gòu)定義則寫在 17-memory/README.zh.md 的記憶體系中。 運行時三層文件如何變成系統(tǒng)提示在步驟 1313-multi-layer-prompts/README.zh.md中PromptBuilder.build()把系統(tǒng)提示組裝成 5 層本文的主角全部登場層來源說明Layer 1 身份AGENT.md正文你是誰、能做什么、行為準(zhǔn)則Layer 2 性格SOUL.md可選拼接為## PersonalityLayer 3 引導(dǎo)上下文BOOTSTRAP.mdAGENTS.md 定時任務(wù)列表工作區(qū)地圖 智能體名冊占位符替換為真實路徑Layer 4 運行時代碼生成當(dāng)前 agent id 與時間戳Layer 5 渠道提示代碼生成來自 Telegram / 后臺 cron / 被調(diào)度子智能體五層用空行拼接后就是發(fā)給 LLM 的完整 system prompt——這就是多層提示設(shè)計的精髓每層文件各司其職改一處不影響其他層。 設(shè)計要點小結(jié)純 Markdown 即可驅(qū)動 AgentFrontmatter 給機器讀正文給 LLM 讀用戶改文件無需改代碼關(guān)注點分離配置AGENT.md、性格SOUL.md、環(huán)境BOOTSTRAP.md、協(xié)作AGENTS.md互不耦合漸進式加載SOUL.md缺失則跳過性格層BOOTSTRAP.md/AGENTS.md不存在則引導(dǎo)上下文為空程序依然能跑占位符解耦{{memories_path}}讓同一份 cookie/AGENT.md 在不同部署路徑下無需修改 相關(guān)文件速查文件說明default_workspace/AGENTS.md智能體名冊與調(diào)度規(guī)則default_workspace/BOOTSTRAP.md工作區(qū)目錄地圖與路徑模板default_workspace/agents/pickle/AGENT.md默認(rèn)智能體配置示例default_workspace/agents/pickle/SOUL.md默認(rèn)智能體性格示例default_workspace/agents/cookie/AGENT.md記憶管理智能體配置default_workspace/skills/cron-ops/SKILL.md同類設(shè)計的技能文件參考13-multi-layer-prompts/src/mybot/core/prompt_builder.py多層提示拼裝源碼13-multi-layer-prompts/src/mybot/core/agent_loader.pyAGENT.md / SOUL.md 加載源碼想動手體驗clone 倉庫后將default_workspace/config.example.yaml復(fù)制為config.user.yaml填入 API 密鑰進入13-multi-layer-prompts目錄啟動uv run my-bot chat問一句我們在哪聊天、現(xiàn)在幾點即可親眼看到渠道提示層生效再到17-memory目錄說記住我的名字就能觀察到 AGENTS.md 名冊 Cookie 記憶體系的完整協(xié)作。贊分享示例工程【免費下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點擊查看免費下載相關(guān)推薦{{ i18n.categories.database.title }}{{ i18n.categories.database.title }} 3. 翻譯工作流實現(xiàn) 推薦使用Git工作流進行翻譯協(xié)作 mermaid graph文檔教程PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南 PyWxDump 是一款用于微信PC版聊天記錄解密與導(dǎo)出的 Python 工具曾幫從零到生產(chǎn)級AI智能體build-your-own-openclaw 18步完整教程全解析從零到生產(chǎn)級AI智能體build your own openclaw 18步完整教程全解析 build your own openclaw 是一個開源的 AI示例工程創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 AGENTS.md、SOUL.md、BOOTSTRAP.md是什么？build-your-own-openclaw工作區(qū)文件設(shè)計完全解讀
示例工程【免費下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點擊查看免費下載在開源教程build-your-own-openclaw中AGENTS.md、SOUL.md、BOOTSTRAP.md三個 Markdown 文件構(gòu)成了 AI Agent 工作區(qū)的核心設(shè)計它們分別定義智能體名冊、角色性格和工作區(qū)地圖并會在運行時自動拼裝成系統(tǒng)提示。本文將帶你從零看懂這套工作區(qū)文件設(shè)計理解為什么純文本文件就能讓 AI 智能體認(rèn)識自己、認(rèn)識隊友、認(rèn)識環(huán)境。 什么是工作區(qū)先認(rèn)識 default_workspace 目錄這套教程用 default_workspace/ 目錄模擬一個真實的智能體工作區(qū)所有配置文件都是人類可直接編輯的 Markdown 和 YAMLdefault_workspace/ ├── AGENTS.md # 智能體名冊 任務(wù)調(diào)度規(guī)則 ├── BOOTSTRAP.md # 工作區(qū)地圖目錄結(jié)構(gòu)、路徑模板 ├── config.example.yaml # 用戶配置模板模型、API 密鑰等 ├── agents/ │ ├── pickle/ │ │ ├── AGENT.md # 智能體配置與操作指令 │ │ └── SOUL.md # 智能體性格 │ └── cookie/ │ ├── AGENT.md │ └── SOUL.md └── skills/ └── cron-ops/SKILL.md # 可復(fù)用技能定義這個結(jié)構(gòu)在 default_workspace/BOOTSTRAP.md 中有完整說明配合 default_workspace/config.example.yaml 使用復(fù)制為config.user.yaml填入 API 密鑰即可運行。?? 注意區(qū)分根目錄的AGENTS.md是團隊名冊而每個智能體文件夾里的AGENT.md單數(shù)才是該智能體自己的身份證 操作手冊。 AGENT.md SOUL.md身份與性格的雙層設(shè)計以默認(rèn)智能體 Pickle 為例看兩個文件如何分工1?? AGENT.md —— 配置文件 操作手冊default_workspace/agents/pickle/AGENT.md 由兩部分組成部分內(nèi)容作用YAML Frontmattername、description、llmtemperature 等、allow_skills機器可讀程序據(jù)此加載配置Markdown 正文角色設(shè)定、Capabilities、行為準(zhǔn)則注入系統(tǒng)提示的身份層程序入口是 13-multi-layer-prompts/src/mybot/core/agent_loader.py 中的AgentLoader掃描agents/目錄、解析 Frontmatter、把llm配置與全局默認(rèn)值合并得到可運行的AgentDef。2?? SOUL.md —— 只寫性格的一層default_workspace/agents/pickle/SOUL.md 只有一句話You are Pickle, a friendly cat assistant... 溫暖、真誠帶一點貓的小動作但不過度賣萌。為什么單獨拆出來因為性格是可選層且需要保持穩(wěn)定。AgentDef中soul_md字段默認(rèn)空值運行時才拼接為## Personality段落。這樣你可以隨時改性格而不動配置也讓同一個工作區(qū)能容納風(fēng)格迥異的智能體PickleSOUL.md友好的貓咪助手temperature 0.7負(fù)責(zé)日常對話CookieAGENT.md、SOUL.md精確高效的記憶管理員temperature 0.3從不直接面對用戶只接收 Pickle 派發(fā)的任務(wù)? BOOTSTRAP.md智能體的工作區(qū)地圖default_workspace/BOOTSTRAP.md 回答三個問題東西放在哪目錄長什么樣每個文件干什么路徑模板{{workspace}}、{{skills_path}}、{{memories_path}}、{{agents_path}}等占位符在加載時由PromptBuilder._substitute_paths()替換為真實路徑見 13-multi-layer-prompts/src/mybot/core/prompt_builder.py目錄結(jié)構(gòu)agents / skills / crons / memories 四大子目錄memories 又分topics/永恒事實、projects/項目上下文、daily-notes/每日事件文件用途速查表明確寫出AGENT.md管配置、SOUL.md管性格、SKILL.md管技能、config.user.yaml管用戶偏好它就像新員工入職手冊——智能體啟動時看一眼地圖就知道去哪里找技能、去哪里讀寫記憶。 AGENTS.md智能體名冊與調(diào)度規(guī)則default_workspace/AGENTS.md 是工作區(qū)根目錄的團隊公告欄內(nèi)容極簡但關(guān)鍵章節(jié)內(nèi)容Agents 表格pickle默認(rèn)對話和 cookie記憶管理的職責(zé)一覽When to Dispatch什么時候該把任務(wù)派給專用智能體存記憶、查記憶、拿不準(zhǔn)時先問用戶Syntax Examplessubagent_dispatch(agent_id, task)的調(diào)用方式與典型示例它解決的正是多智能體協(xié)作的核心問題主智能體如何知道誰存在、誰擅長什么、什么場景該找誰。配合 15-agent-dispatch/README.zh.md 中的調(diào)度實現(xiàn)Pickle 遇到記住這件事就會自動派單給 Cookie而 Cookie 的完整記憶結(jié)構(gòu)定義則寫在 17-memory/README.zh.md 的記憶體系中。 運行時三層文件如何變成系統(tǒng)提示在步驟 1313-multi-layer-prompts/README.zh.md中PromptBuilder.build()把系統(tǒng)提示組裝成 5 層本文的主角全部登場層來源說明Layer 1 身份AGENT.md正文你是誰、能做什么、行為準(zhǔn)則Layer 2 性格SOUL.md可選拼接為## PersonalityLayer 3 引導(dǎo)上下文BOOTSTRAP.mdAGENTS.md 定時任務(wù)列表工作區(qū)地圖 智能體名冊占位符替換為真實路徑Layer 4 運行時代碼生成當(dāng)前 agent id 與時間戳Layer 5 渠道提示代碼生成來自 Telegram / 后臺 cron / 被調(diào)度子智能體五層用空行拼接后就是發(fā)給 LLM 的完整 system prompt——這就是多層提示設(shè)計的精髓每層文件各司其職改一處不影響其他層。 設(shè)計要點小結(jié)純 Markdown 即可驅(qū)動 AgentFrontmatter 給機器讀正文給 LLM 讀用戶改文件無需改代碼關(guān)注點分離配置AGENT.md、性格SOUL.md、環(huán)境BOOTSTRAP.md、協(xié)作AGENTS.md互不耦合漸進式加載SOUL.md缺失則跳過性格層BOOTSTRAP.md/AGENTS.md不存在則引導(dǎo)上下文為空程序依然能跑占位符解耦{{memories_path}}讓同一份 cookie/AGENT.md 在不同部署路徑下無需修改 相關(guān)文件速查文件說明default_workspace/AGENTS.md智能體名冊與調(diào)度規(guī)則default_workspace/BOOTSTRAP.md工作區(qū)目錄地圖與路徑模板default_workspace/agents/pickle/AGENT.md默認(rèn)智能體配置示例default_workspace/agents/pickle/SOUL.md默認(rèn)智能體性格示例default_workspace/agents/cookie/AGENT.md記憶管理智能體配置default_workspace/skills/cron-ops/SKILL.md同類設(shè)計的技能文件參考13-multi-layer-prompts/src/mybot/core/prompt_builder.py多層提示拼裝源碼13-multi-layer-prompts/src/mybot/core/agent_loader.pyAGENT.md / SOUL.md 加載源碼想動手體驗clone 倉庫后將default_workspace/config.example.yaml復(fù)制為config.user.yaml填入 API 密鑰進入13-multi-layer-prompts目錄啟動uv run my-bot chat問一句我們在哪聊天、現(xiàn)在幾點即可親眼看到渠道提示層生效再到17-memory目錄說記住我的名字就能觀察到 AGENTS.md 名冊 Cookie 記憶體系的完整協(xié)作。贊分享示例工程【免費下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點擊查看免費下載相關(guān)推薦{{ i18n.categories.database.title }}{{ i18n.categories.database.title }} 3. 翻譯工作流實現(xiàn) 推薦使用Git工作流進行翻譯協(xié)作 mermaid graph文檔教程PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南 PyWxDump 是一款用于微信PC版聊天記錄解密與導(dǎo)出的 Python 工具曾幫從零到生產(chǎn)級AI智能體build-your-own-openclaw 18步完整教程全解析從零到生產(chǎn)級AI智能體build your own openclaw 18步完整教程全解析 build your own openclaw 是一個開源的 AI示例工程創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考