必须严格按project_id创建根目录并配置标准结构，否则agent space无法加载agents.md、规则失效、长期记忆失配；tasks/需分active/completed两级，任务目录须含output/和metadata.json；上下文通过agents.md、session.inject_context或~/.codex/agents.md注入；长期记忆依赖openlongmemory启用、mark_for_persistence标记及metadata.json写入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中整理项目目录，是为了让AI Agent能稳定识别项目结构、加载正确上下文、复用已有工具与记忆，避免每次启动都变成“失忆新人”。目录混乱会导致AGENTS.md加载失败、Codex-style全局规则不生效、长期记忆无法匹配Repo Memory，甚至触发静默截断而毫无提示。
建立标准项目根目录结构
在本地文件系统中新建一个空目录，名称必须与project_id完全一致（例如你的project_id是fscloud-v2，则目录名必须为fscloud-v2）。
进入该目录，按以下结构创建子目录：
fscloud-v2/
├── AGENTS.md ← 必须存在，且位于根目录
├── prompts/
├── tools/
├── data/
└── tasks/ ← 后续任务归档专用
【project_id必须与代码仓库根目录名或CI/CD流水线ID严格一致】，否则Agent Space启动时将无法定位AGENTS.md，所有项目级上下文注入均失效。
帮助用户满足已验证的需求：代理用户在Clawhub上对类似浏览器的工作流程需求强烈，需要实际的帮助来修复Bug、强化系统。
配置任务归档目录（tasks/）
在项目根目录下创建tasks/子目录，并按生命周期分两级：
tasks/
├── active/ ← 当前正在推进的任务目录
└── completed/ ← 已交付、不可修改的归档目录
每个active/下的子目录必须遵循命名规范：TASK-YYYYMMDD-XXX-简短描述。例如：TASK-20260903-001-api-doc-gen。
每个任务目录内必须包含output/和metadata.json两个元素。output/用于存放所有AI生成物，metadata.json记录本次任务的prompt摘要、调用工具列表、失败步骤标记等——这是后续回溯与长期记忆沉淀的唯一依据。
注入结构化上下文的三种路径
方法一：自动加载项目级AGENTS.md
确保AGENTS.md位于项目根目录，内容控制在1200 tokens内。超长将触发静默截断，且不报错。文件首行建议写明项目标识，例如：# fscloud-v2 —— 云服务配置中心（TypeScript + NestJS）。
方法二：运行时动态注入关键约束
调用session.inject_context("constraint", {"db_compatibility": "v3.2+", "lang_preference": "TypeScript"})。该操作仅存活于当前Session生命周期，适合临时覆盖规则。
方法三：挂载跨项目通用规则
在~/.codex/AGENTS.md中声明企业级底线规则，例如“✅ 所有生成代码必须含JSDoc注释”“⚠️ 禁止修改package-lock.json”。注意：若与项目级AGENTS.md冲突，以项目级为准。
绑定长期记忆与目录结构
第一步：确认longMemoryProvider已启用
检查Agent配置中openLongMemory为true，且longMemoryProvider明确设为MEMOS或Mem0。若为null，Session结束后所有状态直接丢弃。
第二步：定义沉淀触发条件
① 在Session结束前调用session.mark_for_persistence(["user_preference", "arch_decision", "failed_fix"])；
② 确保这些字段已在metadata.json中被写入；
③ Agent Space会自动将标记字段连同project_id一起写入长期记忆库，并按目录路径索引。
第三步：验证路径映射是否生效
执行一次完整Session后，查看MEMOS后台或Mem0 CLI，搜索fscloud-v2，确认返回的记忆条目中包含tasks/active/TASK-20260903-001-api-doc-gen/metadata.json中的关键键值对。
