jackwener /summary · session 结束的标准化总结
使用场景
- 任务做完 / 卡住 / 时间到——session 即将结束
- 准备 commit 但想要一份结构化的 commit body
- 准备更新
specs/2026-xx-xxx/progress.md - 准备交接给同事 / 下一次会话的自己
每个有实质产出的 session 结束前都应该跑一次——5 分钟成本，让团队记忆不丢失。
目标
把"刚刚 30 分钟里发生的事"凝结成可粘贴到 4 个地方的结构化总结：
- Commit message body（解释 why & how）
- Spec 的
progress.md（下次会话恢复入口） - PR / MR 描述
- 给同事的口头/文字交接
避免"我做完了 Task 1"这种对接手者无用的总结。
必须步骤
1. 读 git status / git diff / commit log
git status
git diff --stat
git log --oneline @{1.hour.ago}..HEAD # 或本 session 开始 commit 以来
确认本次的实际产出物，不要凭印象写。
2. 区分"完成"与"未完成"
完成 ≠ "我觉得差不多了"——必须满足任务的 Done 标准。如果不满足，写到"未完成"段。
3. 提炼关键决策
本次过程中做了哪些"以后可能被推翻 / 被反复讨论"的决策？例如：
- 选了方案 A 而不是 B
- 决定不引入某个依赖
- 用某种数据结构表达某个概念
这些应该同步进 specs/xxx/decisions.md——summary 里只列条目，详细决策放 decisions.md。
4. 列出"下次该做什么"
接手者最需要的信息：下一秒该敲什么命令 / 改什么文件。具体到操作粒度，不要"继续后续 task"。
5. 列出"待确认的开放问题"
本次没能定下来、等用户 / 同事拍板的问题。
6. 输出多版本（按目标用途裁剪）
为下面 3 个场景各裁出一份：
- commit body 版（< 10 行，列要点）
- progress.md 版（结构化，含 Last Session / Next Step / Blockers / Open Questions）
- 口头交接版（3 句话讲清楚）
禁止事项
- ❌ 不允许只说"完成了 Task X"——必须列具体 commits / 改了哪些文件 / 关键变更点
- ❌ 不允许凭印象写——必须先读 git diff / log
- ❌ 不允许把过程性日志（debug 折腾了一小时）当成 summary 内容
- ❌ 不允许遗漏"已发现但本次没处理"的问题——它们应该在"Open Questions"段
输出格式
## ✅ 做完了什么
- T1 答卷详情页：新增 `app/admin/exam/[id]/page.tsx`（38 行）
- 用 `getExam(id)` 拉数据
- 客观题/简答题分组展示，未作答题显示"未作答"
- commits: `abc1234`, `def5678`
## ⏳ 没做完
- T1 的 score breakdown 颜色：当前都是默认色，没接 ScoreBadge
## 💡 关键决策
- 用 server component 直接读 kv，不引入新 API endpoint
→ 详见 `specs/2026-05-task-1/decisions.md` D1
## ▶ 下次从哪继续
1. `cd app/admin/exam/[id]/`
2. 把第 42 行的 `<span>{score}</span>` 换成 `<ScoreBadge score={score} />`
3. import 一下 ScoreBadge（参考 dashboard/page.tsx:6）
## ❓ 待确认的开放问题
- 未作答的客观题：要显示"未作答"还是"-"？（用户没明确）
---
## Commit body 版
```text
T1: 实现答卷详情页
- server component 直读 kv，无新 API
- 客观/简答分组展示
- 未作答兜底为"未作答"
未完：ScoreBadge 接入（明天做）
交接 3 句话
"T1 完成了主结构和数据展示。剩下 ScoreBadge 接入还没做（位置：app/admin/exam/[id]/page.tsx:42）。 有个待确认问题：未作答客观题的占位文案。"
## 与其他 Skill 的关系
- 完成实施 → [`/check`](../check/SKILL.md) → [`/summary`](#) → 提交
- summary 里发现的"踩坑"用 [`/record-gotcha`](../record-gotcha/SKILL.md) 沉淀
- summary 输出的 progress.md 段直接覆盖 `specs/xxx/progress.md`