Memory load

memory-load — v2 选择性记忆加载

memory-load 的目标是把高信号历史约束带回当前任务，而不是把整个记忆库塞进上下文。

定位

在 v2 中，memory-load 是可选增强：

• 对 Assist：按需加载
• 对 Delivery-L1：通常跳过
• 对 Delivery-L2：推荐选择性加载
• 对 Delivery-L3 / Incident：应加载关键约束和历史风险

它不再依赖“先创建 Item，才能读取记忆”。

触发时机

推荐在以下时机调用：

1. 已经完成模式和风险判断之后
2. 已经初步知道涉及模块之后
3. 在真正实施前，且确认记忆对决策有帮助时

不建议：

• 在所有任务开始时无差别加载
• 在还没读代码前先堆记忆

输入

推荐输入：

• mode：assist / delivery / incident
• task_type
• modules
• risk_level
• title
• description
• tracked_item（可选）

加载策略

第一层：全局约束

读取：

• .feflow/memory/project/invariants.md
• .feflow/memory/project/coding-doctrine.md

仅在文件存在时加载。

第二层：模块记忆

基于 modules 精确匹配：

• 文件名
• frontmatter scope
• 内容中的明确模块关键词

第三层：事件与模式

当 risk_level 较高，或任务命中历史高风险区域时，加载：

• incidents/
• patterns/

第四层：相似历史工作

只有在以下场景才读取历史 Item：

• 当前任务预计跨会话
• 当前任务疑似高复发
• 当前任务需要估算风险或回滚复杂度

降级策略

.feflow/ 不存在

直接返回“无持久化记忆可用”，不作为阻塞项。

记忆为空

返回最小化结果，不强行生成长摘要。

文件解析失败

跳过损坏条目，保留警告，不中止主任务。

输出形式

有工作区且任务被追踪

可生成 00-memory-brief.md。

无工作区或未追踪任务

以内联短摘要形式供执行使用，不必写文件。

输出要求

只保留高价值信息，例如：

• 项目级不变量
• 已知高风险边界
• 历史回归点
• 避坑约束
• 与当前任务直接相关的旧决策

不要输出：

• 大量无关历史
• 低价值重复信息
• 仅因存在而加载的长记忆清单

性能与预算

1. 默认加载条目不超过 15 条
2. 优先级顺序：不变量 > 编码戒律 > 高风险事件 > 模块记忆 > 历史 Item
3. 超时或条目过多时，优先保留精确匹配项

与其他 skill 的关系

• 上游通常是 orchestrator
• 下游通常是 Delivery 或 Incident 的实际执行
• memory-update 与其对称，但不要为了对称而强行在每次任务前后都调用