⚡

上下文反思 ctx-reflect

这是一个用于软件开发协作的会话反思工具，帮助团队在编程、调试、任务切换等关键节点进行系统性回顾。主要功能包括：记录项目特定学习收获、追踪技术决策、管理开发任务、保存会话上下文。适用于敏捷开发、代码审查、知识管理、团队协作等场景。关键词：会话反思、知识管理、开发协作、上下文保存、敏捷开发、代码审查、任务追踪、决策记录。

DevOps 0 次安装 0 次浏览 更新于 2/27/2026

名称: 上下文反思 描述: “反思会话进展。在自然断点、意外行为后或切换到不同任务时使用。”

暂停并反思本次会话。回顾已完成的工作，并识别值得保留的上下文。

何时使用

  • 在自然断点处（功能完成、错误修复、任务完成）
  • 意外行为或调试绕行后
  • 从一个任务切换到另一个任务时
  • 当上下文即将填满且会话可能很快结束时
  • 当用户明确要求反思或总结时

何时不使用

  • 会话刚开始时（尚无内容可反思）
  • 微小更改后（拼写错误修复不需要反思）
  • 当用户处于流畅状态且未暂停时；不要用未经请求的反思打断

使用示例

/上下文反思
/上下文反思（修复认证错误后）

反思清单

在列出项目之前，退一步整体思考会话：整体脉络是什么？有什么让你惊讶的？你会采取什么不同的做法？这种框架能发现机械清单可能遗漏的见解。

逐项检查每个类别。跳过没有内容的类别；不要强制添加空章节。

1. 学习收获

  • 我们是否发现了任何陷阱、错误或意外行为？
  • 我们是否了解了代码库、工具或模式的某些方面？
  • 这能帮助未来的会话避免问题吗？
  • 这是否特定于本项目？（通用知识不属于LEARNINGS.md）

2. 决策记录

  • 我们是否做出了任何架构或设计选择？
  • 我们是否在备选方案之间进行了选择？权衡是什么？
  • 是否应该记录理由以供未来会话参考？

3. 任务管理

  • 我们完成了哪些任务？（在TASKS.md中标记为完成）
  • 我们开始了哪些尚未完成的任务？
  • 是否应该为本次会话中发现的需要后续跟进的工作添加新任务？

4. 会话笔记

  • 这是否是一个值得完整快照的重要会话？
  • 未来的会话是否会从讨论上下文中受益？
  • 是否有未来会话需要接续的开放线索？

输出格式

反思后，提供：

  1. 摘要：完成了什么（2-3句话）
  2. 建议保留项：列出应保存的内容，每项包含具体命令或文件路径
  3. 询问：询问用户要保留哪些项目

良好示例

本次会话实现了ctx agent的冷却机制，并更新了所有相关文档。我们发现，在钩子上下文中，$PPID解析为Claude Code进程PID，该PID在每个会话中是唯一的。

我建议保留：

  • 学习收获：在PreToolUse钩子中，$PPID解析为Claude Code PID（每个会话唯一） ctx add learning --context "..." --lesson "..." --application "..."
  • 任务：将“为ctx agent添加冷却机制”标记为完成
  • 决策：基于墓碑的冷却机制，默认10分钟 ctx add decision "..."

需要我保留其中任何一项吗？

不良示例

  • “我们做了一些事情。需要我保存吗？”（太模糊；没有具体项目或命令）
  • 列出10个通用知识的琐碎学习收获（只有项目特定的见解才属于此）
  • 未经询问即保留（始终获取用户确认）

保留命令

保留内容 命令
学习收获 ctx add learning --context "..." --lesson "..." --application "..."
决策记录 ctx add decision "..."
已完成任务 直接编辑.context/TASKS.md
新任务 ctx add task "..."

质量检查清单

在呈现反思之前，请验证：

  • [ ] 每个建议的保留项都有具体命令或文件路径（不仅仅是“保存学习收获”）
  • [ ] 学习收获是项目特定的，不是通用知识
  • [ ] 决策记录包括权衡理由，而不仅仅是选择
  • [ ] 没有空的清单类别（跳过没有内容的类别）
  • [ ] 在保留任何内容之前询问用户