Files
playbook/skills/cook-it-through/rules/session-boundary.md
T

1.7 KiB
Raw Blame History

阶段边界与稳定知识

到达阶段边界或感到上下文压力时,只按下列顺序选择首个满足项:

  1. 继续当前 session:下一阶段需要当前 session 作为 primary source,或剩余 smart zone 足够 (约 150k tokens)。
  2. 使用 clear:上下文与下一阶段无关,且没有必须随身携带的未交接事实。
  3. 使用 handoff:跨 harness、目录、仓库或同事,或需要 mid-phase 旁支; handoff 解决的是可移植性,不是上下文过长。
  4. 交给 subagent:工作可独立、边界清楚并可 AFK,且主 session 不需要实时决策。
  5. 使用 compact:其余情况;说明要保留的事实、当前路由和下一动作。

clearcompacthandoff、压缩或恢复后,重新加载 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-modelingcodebase-design 只作词汇来源,不单独起会话。