用途
Session Lifecycle Patterns 用于为 AI 智能体会话建立可预测的结构，实现上下文保留和清晰的会话交接。它通过阶段模型将会话组织为有序的流程，使智能体在每一步都有明确的目标和完成标准。
阶段模型
会话分为五个阶段：
- FRAME：理解上下文。活动包括探索代码、阅读文档、提问。完成门槛是能够清晰表述问题。
- SHAPE：设计方法。活动包括创建计划、识别涉及文件、考虑权衡。完成门槛是计划经过审查和批准。
- BUILD：实现。活动包括编写代码、创建文件、应用变更。完成门槛是实现完成。
- PROVE：验证。活动包括运行测试、验证输出、检查质量。完成门槛是所有检查通过。
- DONE：收尾。活动包括总结、提交、记录决策。完成门槛是会话产物得到保留。
阶段之间允许回退转换，例如从 SHAPE 回到 FRAME 重新框定，从 BUILD 回到 SHAPE 重新设计，从 PROVE 回到 BUILD 修复问题。DONE 是终止阶段。
阶段反模式
- 跳过 FRAME：不理解问题就直接写代码。
- SHAPE 到 BUILD 未经批准：在方法未对齐前就开始构建。
- 永远停留在 BUILD：不验证工作是否正确。
- PROVE 到 DONE 没有证据：没有验证就宣称完成。
会话元数据
会话记录包含 id、开始与结束时间、阶段历史（含各阶段进入时间和持续分钟数）、范围（organ、repo、task）、产物（创建的文件、修改的文件、提交）、决策列表。
上下文保留
会话内上下文通过 SessionContext 类维护，包括 FRAME 阶段的发现、SHAPE 阶段的计划、BUILD 阶段的变更、PROVE 阶段的证据。
跨会话上下文在会话结束时通过会话关闭摘要保留，内容包括：已完成事项、剩余事项、关键决策、阻塞项、下次会话应如何开始。
会话类型
- 探索会话：FRAME 80% → SHAPE 20% → DONE。以阅读为主，产出理解和未来 BUILD 会话的计划。
- 实现会话：FRAME 10% → SHAPE 15% → BUILD 55% → PROVE 20% → DONE。快速重新定位后专注构建和验证。
- 调试会话：FRAME 40% → BUILD 30% → PROVE 30% → DONE。大量调查、针对性修复、彻底验证。
- 审查会话：FRAME 30% → PROVE 70% → DONE。以阅读和验证现有工作为主。
多会话连续性
当工作跨越多个会话时，每个会话引用一个链，包含链 id、会话索引、预计总会话数、前一会话、已完成项、剩余项。
交接协议
会话结束时产出一份交接文档，包含：状态快照（当前存在的文件、分支、测试状态）、决策日志（为何做出选择，避免下次会话重新争论）、下一步行动（明确无歧义）、风险标记（下次会话应注意的事项）。
会话质量信号
- 阶段转换：健康为顺序进行且偶尔回退；不健康为跳过阶段或停留在一个阶段。
- FRAME 时长：健康为会话的 10-30%；不健康为低于 5% 或高于 50%。
- PROVE 证据：健康为具体的测试或验证输出；不健康为“我觉得这能行”。
- 上下文保留：健康为在 DONE 时写下摘要；不健康为会话突然结束。
- 范围蔓延：健康为保持在声明的范围内；不健康为在 BUILD 中途扩展。
反模式
- 无限 FRAME：分析瘫痪，应在某个时刻开始 SHAPE。
- 跳过 PROVE：每次 BUILD 必须在 DONE 前得到验证。
- 没有会话关闭：始终写下摘要，即使简短。
- 会话间上下文丢失：多会话工作必须使用交接文档。
- 阶段表演：走过场而没有实质内容。