wrap-up

/wrap-up

内容

会话连续性流程。会话转瞬即逝，知识却长久留存。 Wrap-up 双向衔接会话：

• 会话结束 — 准确记录三件事：已完成的工作、待处理的工作，以及学到的经验。将它们写入 .claude/handoff.md，并将值得长期保留的经验汇总到 MEMORY.md。
• 会话开始 — 加载交接记录、记忆和本能，然后提供恢复摘要，让每个会话都能有备而来。

适用时机

• 工作会话结束时 — “今天就到这里”“就这些了”“我先下线了”
• 切换项目之前，或完成重要里程碑之后
• 隐含的结束信号 — 完成任务后说“谢谢”，或“暂时这样就够了”：提供交接记录，而不只是道别
• 会话开始时 — “开始会话”“加载交接记录”“我们之前在做什么”
• 如果要在会话中途保存但不结束，请改用 /checkpoint

用法

会话结束

1. 回顾会话 — 根据 git 状态/差异和对话，整理修改过的文件、已完成和未完成的任务、决策及其原因，以及观察到的用户纠正。
2. 检查未提交的更改 — 如果存在，请在结束会话前询问是否提交。
3. 编写交接记录 — 使用下方格式写入 .claude/handoff.md。始终只维护一个文件，并覆盖原有内容——只有当前状态重要。如果现有交接记录中有其他人留下的待办任务，请先询问是合并、覆盖还是跳过。
4. 提取经验 — 值得保留的纠正和发现写入 MEMORY.md（通过 instinct-system）；新出现的模式更新到 .claude/instincts.md（通过 instinct-system）。交接记录中的“学到的经验”部分是触发提取的依据，而不是存放经验的最终位置——交接记录只是临时的。
5. 确认 — 向用户总结已记录的交接内容和提取的经验。

交接文件格式（.claude/handoff.md）

写给完全不了解项目的读者，包含文件路径、原因和具体的后续步骤。“继续重构”毫无用处；“按照 Catalog 中已确立的模式，将 src/Orders/CreateOrder.cs 重构为 Result 模式”则可以直接执行。

# Session Handoff

> Generated: 2026-06-12 | Branch: feature/order-validation

## Completed
- [x] Added FluentValidation to CreateOrder (src/Orders/Features/CreateOrder.cs:15-35)
- [x] Fixed N+1 in GetOrderDetails (src/Orders/Features/GetOrderDetails.cs:28)

## Pending
- [ ] Add validation to UpdateOrder (src/Orders/Features/UpdateOrder.cs)
  - Reference: CreateOrder validator for the established pattern
- [ ] Full test run — 2 pre-existing Catalog failures, not from today

## Learned
- FluentValidation validators must be registered in the module's DI setup
- Test fixture seeds 1 item per order, which hides N+1 queries

## Context
- Branch: feature/order-validation | Last commit: "Add CreateOrder validation"
- Uncommitted changes: no | Solution: src/MyApp.slnx

多人共同参与项目时，请添加 ## Decisions Made 表格（决策 | 选择 | 原因）和 ## Open Questions。

经验提取检查清单

1. 用户是否纠正了什么？→ 通过 instinct-system 写入 MEMORY.md
2. 我们是否发现了不明显的信息？→ 写入“学到的经验”部分
3. 我们是否做出了有理由的决策？→ 记录“为什么”
4. 工具或方法是否失败？→ 记录下来，避免下一次会话重试

好的经验：“EF 编译查询无法与 Include() 配合使用。”不好的经验：“处理了 Orders 模块”（太含糊）或“使用了 TimeProvider”（这本来就是规则）。

会话开始

1. 加载上下文 — 读取 .claude/handoff.md（待处理工作）、MEMORY.md（永久规则）和 .claude/instincts.md（置信度达到 0.7 及以上的模式）。文件缺失也没关系：说明情况后从头开始，不要因此受阻。
2. 检测解决方案 — 查找 .slnx/.sln（当前目录、父目录，再到子目录），以便从第一个提示词开始就能使用 Roslyn MCP 工具。
3. 提供恢复摘要 — 总结上次会话的工作、待办任务、当前规则/本能的数量，以及检测到的解决方案。然后询问要处理什么——绝不自动开始处理待办工作。

示例

User: /wrap-up

Claude: Wrapping up session...

## Session Summary
- Implemented OrderService with validation pipeline
- Fixed N+1 query in GetOrdersByCustomer

## Pending
- [ ] Add retry logic to payment gateway calls (OrderService.cs:42)

## Learnings Captured
- User prefers explicit mapping over AutoMapper → MEMORY.md

Written to .claude/handoff.md. See you next session.

相关内容

• /checkpoint — 会话中途保存（提交 + 简短说明），但不结束会话
• instinct-system — 整理会话中的经验：模式成为本能，用户纠正成为 MEMORY.md 中的永久规则