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