用途:为 Compozy 运行维护工作流范围内的任务记忆,记忆文件位于 .compozy/tasks/<name>/memory/。当任务提示提供工作流记忆路径时使用。
必要输入:工作流记忆目录路径、共享工作流记忆文件路径、当前任务记忆文件路径,以及可选的调用方信号,指示任一文件是否需在继续前压缩。
主要能力与用法:编辑代码前先读取共享工作流记忆文件和当前任务记忆文件,将其视为本次运行的强制上下文。若调用方标记某文件需压缩,先读 references/memory-guidelines.md 并压缩该文件再实施。任务运行中,当目标变化、做出非显而易见决策、出现重要学习或错误改变计划时更新当前任务记忆;仅将持久的跨任务上下文提升到共享工作流记忆,任务本地执行细节留在当前任务记忆。完成声明、交接或提交前先更新记忆,只记录能帮助下次运行更快、更少出错的事实。
提升判断:仅当另一任务需要该信息以避免错误或重复发现、该事实跨多次运行持久、且该信息并非 PRD、技术规格、任务文件或仓库本身已显而易见时,才从任务记忆提升到共享记忆,三者须同时为“是”。
压缩规则:若两个文件都需压缩,先压缩共享工作流记忆再压缩任务记忆。保留当前状态、持久决策、可复用学习、未决风险和交接说明;移除重复、过时笔记、长命令记录及可从仓库、PRD 或任务文件推导的事实;保留项改写为简短事实要点,保留模板默认章节标题。
限制与错误处理:不得编造历史、决策或状态;不得复制大段代码、堆栈跟踪或任务规格;不得重复仓库、git diff、任务文件或 PRD 已明显的事实;不得读取无关任务记忆文件,除非共享记忆或调用方明确指向。若调用方提供的记忆路径缺失,应停止并报告不匹配而非猜测路径;若记忆内容与仓库或任务规格冲突,以仓库和任务文档为准并修正记忆文件;若压缩会移除活跃风险、决策或交接上下文,应保留这些项,优先移除低价值重复内容。