Back to Details

debrief

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
End-of-session debrief to capture learnings and keep documentation current.
会话结束复盘，用于记录学习内容并保持文档时效性。

When to Run

运行时机

  • Before ending a productive session
  • When context window is getting full
  • After significant conversations about preferences, workflows, or decisions
  • Periodically as maintenance
  • 在富有成效的会话结束前
  • 当上下文窗口即将存满时
  • 在完成关于偏好、工作流或决策的重要对话后
  • 定期作为维护任务执行

Workflow

工作流

Phase 1: Gather Context

阶段1：收集上下文

  1. Read current state:
    • .claude/memories/about-taylor.md
      - Current profile
    • .claude/memories/index.json
      - Existing memories
    • CLAUDE.md
      - Current instructions (skim for relevant sections)
  2. Get today's date:
    bash
    date +%Y-%m-%d
  1. 读取当前状态：
    • .claude/memories/about-taylor.md
      - 当前配置文件
    • .claude/memories/index.json
      - 已有记忆内容
    • CLAUDE.md
      - 当前指令（浏览相关章节）
  2. 获取今日日期：
    bash
    date +%Y-%m-%d

Phase 2: Analyze Conversation

阶段2：分析对话

Review the conversation for memory-worthy moments:
Preferences (category: 
preference
)
  • "I like X better than Y"
  • "I prefer...", "I don't want..."
  • Choices made when given options
Corrections (category: 
workflow
or 
context
)
  • "Actually...", "No, that's not right"
  • Clarifications about how something works
  • Misunderstandings corrected
Personal Context (category: 
personal
or 
context
)
  • Life events (moves, job changes, milestones)
  • Schedule or routine changes
  • Health, relationships, living situation
Workflow Insights (category: 
workflow
)
  • How Taylor actually uses tools vs. assumptions
  • Shortcuts or patterns observed
  • Friction points identified
Decisions (category: 
project
or 
workflow
)
  • Architecture or design choices
  • Tool/technology selections
  • Process changes
回顾对话内容，筛选值得记录为记忆的时刻：
偏好（分类：
preference
）
  • “我更喜欢X而非Y”
  • “我倾向于...”、“我不想要...”
  • 给出选项时做出的选择
修正内容（分类：
workflow
或
context
）
  • “实际上...”、“不对，不是这样的”
  • 对事物运作方式的澄清
  • 被纠正的误解
个人上下文（分类：
personal
或
context
）
  • 生活事件（搬家、换工作、里程碑节点）
  • 日程或日常安排变更
  • 健康、人际关系、居住情况
工作流洞察（分类：
workflow
）
  • Taylor实际使用工具的方式与预设假设的差异
  • 观察到的快捷方式或模式
  • 识别出的痛点
决策内容（分类：
project
或
workflow
）
  • 架构或设计选择
  • 工具/技术选型
  • 流程变更

Phase 3: Present Findings

阶段3：呈现结果

Present findings one category at a time:
markdown
undefined
按分类逐一呈现结果：
markdown
undefined

Proposed Memories

建议记录的记忆

Memory 1: [Brief title]

记忆1：[简短标题]

Category: preference Content: Taylor prefers X over Y because Z. Source: [Quote or paraphrase from conversation]
Action? [Save / Skip / Edit]
undefined
分类： preference 内容： Taylor因Z原因更喜欢X而非Y。 来源： [对话引用或转述]
操作？[保存 / 跳过 / 编辑]
undefined

Phase 4: Updates to about-taylor.md

阶段4：更新about-taylor.md

Check if any new information should be added to the profile:
  • Job status changes
  • New skills or interests
  • Updated preferences that are significant enough for the profile
  • Life changes (location, situation)
markdown
undefined
检查是否有新信息需要添加到配置文件中：
  • 工作状态变更
  • 新技能或兴趣爱好
  • 足够重要的偏好更新
  • 生活变化（地点、处境）
markdown
undefined

Suggested Profile Updates

建议的配置文件更新

Update 1: [Section]

更新1：[章节]

Current: [What it says now, if anything] Proposed: [New or updated text] Reason: [Why this matters]
Action? [Apply / Skip / Edit]

**Remember:** about-taylor.md has a 300-line limit. Only add significant, lasting information.
当前内容： [现有内容（如有）] 建议内容： [新增或修改后的文本] 原因： [该更新的重要性]
操作？[应用 / 跳过 / 编辑]

**注意：** about-taylor.md有300行的限制。仅添加重要且长期有效的信息。

Phase 5: Updates to CLAUDE.md

阶段5：更新CLAUDE.md

Check if any workflow or instruction changes should be documented:
  • New conventions established
  • Process improvements agreed upon
  • Corrections to existing instructions
  • New skills or capabilities added
markdown
undefined
检查是否有工作流或指令变更需要记录：
  • 新确立的规范
  • 已达成一致的流程改进
  • 对现有指令的修正
  • 新增的技能或功能
markdown
undefined

Suggested CLAUDE.md Updates

建议的CLAUDE.md更新

Update 1: [Section]

更新1：[章节]

Location: [Which section] Change: [What to add/modify] Reason: [Why this should be documented]
Action? [Apply / Skip / Edit]
undefined
位置： [对应章节] 变更内容： [需添加/修改的内容] 原因： [记录该变更的必要性]
操作？[应用 / 跳过 / 编辑]
undefined

Phase 6: Execute Approved Changes

阶段6：执行已批准的变更

For approved memories:
  1. Create JSON file: 
    .claude/memories/YYYY-MM-DD-NNN.json
    json
    {
  "date": "YYYY-MM-DD",
  "category": "preference|workflow|context|project|personal",
  "content": "Concise description (1-2 sentences)",
  "source": "conversation|observation|correction"
}
  2. Update 
    .claude/memories/index.json
For approved profile/CLAUDE.md updates:
  1. Apply edits to the relevant files
  2. Confirm changes
对于已批准的记忆内容：
  1. 创建JSON文件：
    .claude/memories/YYYY-MM-DD-NNN.json
    json
    {
  "date": "YYYY-MM-DD",
  "category": "preference|workflow|context|project|personal",
  "content": "简洁描述（1-2句话）",
  "source": "conversation|observation|correction"
}
  2. 更新 
    .claude/memories/index.json
对于已批准的配置文件/CLAUDE.md更新：
  1. 对相关文件应用编辑
  2. 确认变更

Phase 7: Summary

阶段7：总结

markdown
undefined
markdown
undefined

Debrief Complete

复盘完成

Memories saved: N Profile updates: N CLAUDE.md updates: N Skipped: N
Next debrief recommended: [if context is still full, suggest continuing]
undefined
已保存记忆数： N 配置文件更新数： N CLAUDE.md更新数： N 已跳过数： N
建议下次复盘时间：[如果上下文仍存满，建议继续]
undefined

Memory JSON Format

记忆JSON格式

json
{
  "date": "2026-01-20",
  "category": "preference",
  "content": "Taylor prefers not to over-engineer tooling for rare edge cases.",
  "source": "conversation"
}
json
{
  "date": "2026-01-20",
  "category": "preference",
  "content": "Taylor更倾向于不为罕见的边缘情况过度设计工具。",
  "source": "conversation"
}

Tips

提示

  • Be selective - not every detail needs a memory
  • Memories should be durable (still relevant in weeks/months)
  • Profile updates should be significant life/work changes
  • CLAUDE.md updates should be reusable conventions, not one-off fixes
  • When in doubt, ask rather than skip
  • 有所取舍——并非每个细节都需要记录为记忆
  • 记忆内容应具备持久性（在数周/数月后仍有参考价值）
  • 配置文件更新应聚焦于重要的生活/工作变更
  • CLAUDE.md更新应针对可复用的规范，而非一次性修复
  • 如有疑问，优先询问而非直接跳过