1.7 KiB
1.7 KiB
阶段边界与稳定知识
到达阶段边界或感到上下文压力时,只按下列顺序选择首个满足项:
- 继续当前 session:下一阶段需要当前 session 作为 primary source,或剩余 smart zone 足够 (约 150k tokens)。
- 使用
clear:上下文与下一阶段无关,且没有必须随身携带的未交接事实。 - 使用
handoff:跨 harness、目录、仓库或同事,或需要 mid-phase 旁支;handoff解决的是可移植性,不是上下文过长。 - 交给 subagent:工作可独立、边界清楚并可 AFK,且主 session 不需要实时决策。
- 使用
compact:其余情况;说明要保留的事实、当前路由和下一动作。
clear、compact、handoff、压缩或恢复后,重新加载 SKILL.md 与当前路由文件,
并重新读取会改变下一步动作的项目规则;不得只依据 status 输出继续。
稳定知识不能替代阶段上下文。
稳定知识准入与归属
只把已经验证且可复现的事实写入稳定知识,并且至少满足一项:重新发现成本高、 不能从代码直接看出、下一 session 仍需要。
memory-bank/project-brief.md:稳定定位、边界和目标。memory-bank/tech-context.md:已验证的工具链和验证入口。memory-bank/system-patterns.md:当前模块边界与不变量。CONTEXT.md:稳定领域词汇;关键取舍及理由写入docs/adr/;项目执行规则写AGENT_RULES.local.md。handoff产物写入 OS 临时目录,不写稳定知识文件。
按需使用 domain-modeling;codebase-design 只作词汇来源,不单独起会话。