SuperAPI AI 工具集

session-summary

编程与开发

查看项目

更新于 10-16 09:15

技能介绍

用途

session-summary 用于在针对某个 DAE 功能的工作会话结束时,在功能的 session-log.md 中写入一条按会话划分的记录,让人类可以合上电脑并在下次会话时干净地接续。它是机器交接记录(handoffs)的人类可读对应物。

何时使用

在某个功能的一次工作会话结束时使用。当当前 Codex hook schema 支持时,生命周期钩子可能会提示此工作流;该钩子是可选的工程配置,不属于本技能的一部分。

不适用于:会话中途(没有内容需要收尾);同步跟踪器(应使用 progress-log);按技能记录(每个技能自己的 handoff)。

工作流程

  1. 解析与界定范围 — 通过 ${PLUGIN_ROOT}/scripts/dae_resolve.py 解析方法论根目录与清单(参见 references/resolving.md)。范围 = 本次会话触及的功能(默认:当前分支;多个则各写一条;没有则无需记录,停止)。
  2. 收集 — 从本次会话的 handoffs/*.md、分支上的 git 活动以及对话上下文(决策、问题、延期事项)中综合信息。
  3. 追加条目 — 追加(绝不覆盖)到 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> 标题。

  1. 交接 — 输出一份摘要。

交接

按 ${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 节)。