Agent Workflow and Memory Policy zh CN

Agent 工作流与主动记忆策略

语言： English · 简体中文

LWC 最重要的能力并不是某一条命令，而是 Agent 能否在合适的时机判断应该召回、核验、写回，还是有意识地跳过记忆工作。

自动决策循环

任务分类 -> 一次召回 -> 检查当前证据 -> 解决问题
         -> 在验证里程碑保存 -> 验收 -> 完成

这套循环让 LWC 保持主动，同时避免把每一个小任务都变成知识维护工程。

触发矩阵

场景	Agent 行为
新的实质会话	只解析一次项目边界，读取有界 context，并运行一次任务搜索。
上下文压缩或恢复	恢复已启用的强标签，只补充当前任务相关记忆。
研究、排障或设计	先召回既有证据与决策，再决定是否需要重新调查。
代码结构问题	检查一次 CodeGraph；已经就绪时直接使用。
文档关系问题	检查一次文档图；已经就绪时直接使用。
非 Markdown 输入	只有确实需要转换时，才解释并配置一个可选转换器。
已验证里程碑	更新一篇已有页面，或新建一篇可被独立检索的明确页面。
矛盾或过时声明	检查被引用证据，再修订、限定或撤回声明。
修改 Wiki 后结束任务	对变更作用域运行 lint 和固定检索验收。

什么时候跳过 LWC

以下工作通常不需要记忆维护：

• 拼写或格式修改；
• 只有一行的字面量变更；
• 不依赖项目上下文的独立翻译；
• 没有合理复用可能的事实；
• 普通测试输出和进度更新。

如果任务很重要，但尚未形成经过验证的持久结果，可以使用 LWC 召回，等真正到达里程碑再写回。

会话开始

Agent 应当只为当前工作根执行一次 bootstrap，并确认项目边界唯一明确。之后进行有界召回：

lwc --scope all context --limit 25
lwc --scope all search "task terms" --limit 20

同一工作根中不要反复执行 bootstrap 或广泛召回。第一次检索没有结果时，每次只扩大一个维度：查询、页面类型、作用域或粒度。

Readiness 与授权

生命周期 Hook 可以报告：

• 项目 Wiki 是否存在；
• 文档图配置与投影 readiness；
• CodeGraph 运行时与项目索引 readiness；
• 可选 Markdown 转换配置；
• Agent 集成检查项；
• 已启用的强标签上下文。

检测不代表授权。自动激活可以读取有界且已经授权的记忆，但不能：

• 在没有显式调用或项目策略授权时初始化缺失的项目 Wiki；
• 启用文档图；
• 构建 CodeGraph 项目索引；
• 安装或选择转换器；
• 在缺少验证里程碑和作用域权限时写入持久记忆。

任务确实需要图能力但尚未就绪时，只询问一次：

1. 同时启用文档图与 CodeGraph（推荐）
2. 仅启用文档图
3. 仅启用 CodeGraph
4. 稍后

选择“稍后”不会改变任何状态，也不能阻塞主要任务。

召回策略

从预算开始，不从整个 Wiki 开始：

• context --limit 25；
• 一次 search --limit 20；
• 一到五篇完整页面；
• 只有准确证据或新鲜度重要时才读取引用来源。

强标签自动载入同样受到标签优先级、页面数、字符预算和页面边界限制。Hook 会报告被省略的内容，不会把已选中的页面从中间截断。

写回策略

只有验证完成后才写回。常见强触发点包括：

• 用户已经接受的决策；
• 经过代码或运行证据证明的根因；
• 已修正的过时声明；
• 可复用恢复流程；
• 有来源依据的综合结论；
• 稳定偏好或项目规则。

能更新已有页面时不要新建页面，更不要只为了复刻当前聊天而创建页面。

任务完成策略

记忆维护只有同时满足以下条件才算完成：

1. 每项持久声明都有当前证据或显式来源证明；
2. 相互依赖的写入在必要时原子发布；
3. lint 没有报告本次更新引入的问题；
4. 固定原问题与自然改写都能在前五名找到预期页面；
5. 相关可选 Work 达到 succeeded，图校验也已经通过；
6. 没有保存秘密、临时细节或无依据结论。

抗故障行为

• 项目作用域存在歧义时，应停止项目记忆工作，不能回退到全局写入。
• Wiki 知识与当前代码冲突时，把当前代码视为实现证据，并调查差异来源。
• Work 仍在排队或运行时，应等待并检查，不能把命令退出当成完成。
• changeset 出现冲突时，保留 live 工作并重新建立草稿，不能强制提交。
• 可选维护会拖慢用户交付物时，先完成交付物。

下一篇：来源与知识整合