用途
session-summary 用于在针对某个 DAE 功能的工作会话结束时,在功能的 session-log.md 中写入一条按会话划分的记录,让人类可以合上电脑并在下次会话时干净地接续。它是机器交接记录(handoffs)的人类可读对应物。
何时使用
在某个功能的一次工作会话结束时使用。当当前 Codex hook schema 支持时,生命周期钩子可能会提示此工作流;该钩子是可选的工程配置,不属于本技能的一部分。
不适用于:会话中途(没有内容需要收尾);同步跟踪器(应使用 progress-log);按技能记录(每个技能自己的 handoff)。
工作流程
- 解析与界定范围 — 通过 ${PLUGIN_ROOT}/scripts/dae_resolve.py 解析方法论根目录与清单(参见 references/resolving.md)。范围 = 本次会话触及的功能(默认:当前分支;多个则各写一条;没有则无需记录,停止)。
- 收集 — 从本次会话的 handoffs/*.md、分支上的 git 活动以及对话上下文(决策、问题、延期事项)中综合信息。
- 追加条目 — 追加(绝不覆盖)到 features/NNN-<slug>/session-log.md:
## Session — <ISO date> <start>–<end>
**Current state:** <which checkpoint, one line>
### Previous tasks (done this session)
- ...
### Current task
- <in progress at session end, if any>
### Next tasks
- <concrete, actionable, ordered>
### Open questions / blockers
- <or "None">
如果文件不存在,则创建并加上 # Session log — <title> 标题。
- 交接 — 输出一份摘要。
交接
按 ${PLUGIN_ROOT}/references/handoff-summary.md 输出。checkpoint: null;human_action_needed: no;recommended_next: 条目中的第一个“Next task”。(session-summary 不是交接处理器,因此遵循常规契约——没有豁免。)
session-log.md 与 handoffs、progress.md 的区别
三种记录,三种读者:handoffs/ = 机器、每次调用;progress.md = 机器派生、可速览;session-log.md = 人类、按会话、叙述性。它们不重复——粒度不同,读者不同。
参考
Foundation Design — 存储布局中的 session-log.md,session-log 与 handoffs 的区分(第 5 节)。