agent space 中文件与任务记录通过 metadata.json 强绑定，任务目录迁移和双向校验确保上下文可追溯、产出可信；缺失 metadata.json 或校验失败则文件无效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space 文件和任务记录的关系，是决定 AI Agent 能否在真实工作流中持续产出可靠结果的关键纽带。它不是简单地把文件扔进一个文件夹，而是让每个任务从启动、执行到归档，全程都有可追溯的上下文锚点——文件存放在哪、为什么存、谁触发、依据什么规则、是否已完成，全部由任务记录显式绑定。
任务记录是 Agent Space 的目录索引与身份凭证
每个活跃任务在 tasks/active/ 下创建唯一命名目录（如 TASK-20260902-001-customer-report-fix），该目录内必须包含 metadata.json 文件。
metadata.json 不是日志备份，而是任务的结构化身份证：记录原始 prompt、调用工具链、输入文件哈希、预期输出格式、截止时间、负责人标记（如 "owner": "agent-cursor"）。
Agent Space 中所有写入该目录 output/ 子目录的文件，自动获得任务归属——【没有 metadata.json 的 output/ 目录，不被视为有效任务空间】。
这一步不可跳过。缺失 metadata.json 会导致后续归档失败、RAG 检索丢失上下文、可观测性 trace 断链。
文件生命周期由任务状态驱动
方法一：任务完成时自动迁移
当 Agent 判定任务达成（例如所有测试通过 + 输出文件校验成功），Harness 执行：mv tasks/active/TASK-20260902-001-customer-report-fix tasks/completed/。
迁移后，output/ 下所有文件即成为该任务的永久快照，路径锁定，不可修改。
方法二：人工干预强制归档
若 Agent 卡死或产出不全，运维人员可手动将目录移入 tasks/completed/，但必须补全 metadata.json 中的 "status": "aborted" 和 "reason": "timeout" 字段。
【直接在 active/ 下删除目录，等同于永久擦除任务上下文】。
文件内容与任务记录双向验证
第一步：读取 metadata.json 中声明的 input_files 字段，获取预期输入文件路径列表。
第二步：检查这些路径是否真实存在、最后修改时间早于任务创建时间、SHA256 哈希与记录值一致。
第三步：扫描 output/ 下所有文件，比对 metadata.json 中 output_schema 定义的字段名、格式（如 CSV 头、JSON Schema）、非空约束。
第四步：任一校验失败，该任务记录即被标记为 invalid，其 output/ 文件不参与任何 RAG 检索或报表生成。
这四步构成硬性守门机制。没有它，Agent Space 就会退化为无序文件堆——看起来很忙，但每份产出都缺乏可信锚点。
