Workspace是独立磁盘目录,含skills/、plans/、logs/、agents/四子目录,需顶层创建;用export AGENT_WORKSPACE或aw use切换;跨区复用技能可用符号链接,但计划引用的子智能体ID必须在目标Workspace agents/中存在。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在同一个Agent开发环境中并行推进多个项目,每个项目需要独立的上下文、知识库、子智能体配置和会话日志,但又不能让它们互相污染或混淆状态。
理解Workspace的物理结构
每个Workspace是一个独立的磁盘目录,包含workspace/前缀的文件夹,内部固定有skills/、plans/、logs/、agents/四个子目录。你创建的每一个Workspace都必须是顶层目录,不能嵌套在另一个Workspace内——否则技能加载会失败,子智能体声明路径解析错误。
这一步操作起来很简单,直接在终端执行mkdir -p ~/workspaces/research-llm ~/workspaces/client-poc即可生成两个平行工作区。
用aw命令快速切换Workspace
方法一:通过环境变量临时绑定
在终端中执行export AGENT_WORKSPACE=~/workspaces/research-llm,后续所有agent-scope命令(如agent-scope run)将自动读取该路径下的agents/定义和skills/内容。注意:该变量只对当前shell会话生效,关闭终端即失效。
方法二:使用agent-workspace CLI一键激活
第一步:确保已安装agent-workspace v0.8.3+;
自我反思 + 自我批评 + 自我学习 + 自我组织记忆。代理评估自身工作,发现错误并持续改进。
第二步:在任意目录下运行aw use research-llm → 系统自动检测~/workspaces/research-llm是否存在 → 若存在则写入~/.agent-workspace/current软链接指向它;
第三步:所有后续Agent调用均默认从此Workspace加载上下文。切换到client-poc只需再执行一次aw use client-poc。
【重要前提】必须提前在~/workspaces/下建立对应名称的目录,且目录内至少包含一个空的agents/子目录,否则aw use会静默失败不报错。
跨Workspace复用技能与计划
技能文件(Markdown格式)默认只在本Workspace的skills/目录下可见。若你想让research-llm中的“模型对比分析”技能也能被client-poc调用,不要复制文件——而是用符号链接:
ln -sf ~/workspaces/research-llm/skills/model-benchmark.md ~/workspaces/client-poc/skills/
计划文件(JSON)同理,但要注意:计划中引用的子智能体ID必须在目标Workspace的agents/目录下真实存在,否则执行时会触发AgentNotFoundError异常。
这一步不能跳过校验——你必须手动确认client-poc/agents/里有对应ID的Agent定义文件,哪怕只是占位符。

















