mcpField
S
session-reflection

session-reflection

github.com/jwilgerAgent 工作流5170 次安装17 周前更新
代码仓库

关于 session-reflection

session-reflection 帮助 Agent 将用户反馈和会话记录转化为项目指令与持久工作状态。它会对用户介入分类，并将指令调整写入指定文件。

主要功能

  1. 01识别反复出现的用户纠正
  2. 02按五种类型归类用户介入
  3. 03完善项目指令文件
  4. 04在 WORKING_STATE.md 中持久保存状态
  5. 05在会话后回顾并更新经验

适用场景

  1. 01将重复反馈转化为项目规则
  2. 02在崩溃或上下文压缩后恢复任务状态
  3. 03在里程碑或会话结束时回顾模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jwilger/agent-skills --skill session-reflection

安装后在 Claude Code 中输入/session-reflection确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
analysis-framework.md
launcher-templates.md
system-prompt-patterns.md
working-state-schema.md

详细介绍

会话反思

价值： 反馈——用户每次介入都表明系统提示词不完整。将纠正转化为持久指令，能让各会话持续累积改进。

目的

教会 Agent 分析会话历史，找出反复出现的纠正，生成针对项目的指令以避免已知失误，并维护能在上下文压缩和崩溃后留存的工作状态。将被动纠正转化为主动预防。

实践

反思触发条件

在以下情况后进行反思：重要里程碑（PR 已合并、功能已完成）、用户重复纠正 3 次或以上、会话重启或崩溃恢复、每完成 5 项任务，以及用户明确提出要求时。不要等待“合适的时机”——触发条件满足时就进行反思。

分析会话历史

检查对话历史、git log、记忆文件、WORKING_STATE.md 和会话日志。将用户的每次介入归入以下五种类型之一：

  • 纠正：Agent 做错了事（指令缺失）
  • 重复提醒：Agent 再次被告知同一件事（强调不足）
  • 角色纠偏：Agent 超出了自身职责范围（边界缺失）
  • 挫败感升级：用户的语气变得更强硬（问题持续恶化）
  • 变通处理：用户亲自完成了工作（技能不足）

详细分类与优先级排序请参阅 references/analysis-framework.md。

生成或完善项目指令

根据内容类型，将项目专属指令放入相应的指令文件。没有单独的系统提示词文件——所有内容均通过 CLAUDE.md → AGENTS.md → .team/coordinator-instructions.md 传递：

  • CLAUDE.md — 会话管理（启动流程、压缩后恢复、状态跟踪）、特定于运行框架的配置
  • AGENTS.md — 通用项目规则、应做与不应做的事项、编码规范、工作流配置
  • .team/coordinator-instructions.md — Coordinator／pipeline-controller 角色区分、构建前置检查关卡、任务派发规范、领域审查清单

完善规则：针对新的缺口添加新条目；缺口反复出现时，将建议提升为结构性要求；重写含糊条目以提高清晰度。只有在确认缺口连续 3 次以上会话均已解决后，才能删除条目。编写模式请参阅 references/system-prompt-patterns.md，特定于运行框架的文件路由请参阅 references/launcher-templates.md。

自我提醒协议

有关整合后的自我提醒协议（频率、合并后的重读清单和压缩后规则），请参阅模板目录中的 CONSTRAINT-RESOLUTION.md。

工作状态持久化

维护 WORKING_STATE.md，以防上下文压缩和崩溃。每次状态发生重大变化后都要更新。任何中断后，行动前务必先阅读。位置：.factory/WORKING_STATE.md（pipeline）或项目根目录（独立模式）。格式请参阅 references/working-state-schema.md。

应做事项：

  • 在任务开始、阶段变化、作出决策、遇到阻碍时更新
  • 覆盖为当前状态（不要追加）
  • 任何中断后，第一时间阅读

不应做事项：

  • 上下文压缩或重启后凭记忆猜测状态
  • 将其用作日志——保持简洁且反映当前情况
  • 因为“没有重要变化”而跳过更新
会话结束后的学习循环

会话结束时：识别本次会话中的模式，更新记忆文件；如果触发条件满足，则完善项目指令；归档工作状态。

当同一类介入不再反复出现时，学习循环才算闭环。如果完善指令后，某类介入仍在连续 3 次以上会话中持续出现，则应升级处理：该缺口可能需要新增技能，或对工作流进行结构性调整。

执行说明

所有模式下均为建议项。反思触发条件和指令生成由自身负责执行。

硬性约束：

  • 上下文压缩后必须执行：[H]——上下文压缩会破坏隐含状态，因此重读并非可选项。

约束

  • “3+ 次重复纠正”：所谓“重复纠正”，是指用户多次纠正同一种根本行为。同一纠正的不同表述算作重复纠正一次。同一类别中的不同纠正（例如，两种不同的格式偏好）分别计算。
  • “未经确认已连续 3+ 个会话解决，绝不删除指令”：这是为了避免过早清理。某条指令如果在 3 个会话中都未触发，可能正是因为它在防止问题发生——这说明它有效，而不是过时。只有在有确凿证据表明根本行为已修复时才删除（例如，导致问题的代码模式已不复存在）。

验证

完成由此技能指导的工作后，请验证：

  • 在每个触发点（里程碑、重复纠正、重启）都进行了反思
  • 使用五类分类法对用户干预进行分类
  • 使用结构性（而非仅建议性）语言优化了项目指令
  • 将指令路由到正确的文件（CLAUDE.md / AGENTS.md / coordinator-instructions.md）
  • 遵循了自我提醒协议（每 5–10 条消息重新读取状态）
  • WORKING_STATE.md 内容最新且准确
  • 每次上下文压缩后都重新读取状态（而非猜测）

如果有任何一项未满足，请重新检查相关做法后再继续。

依赖项

此技能可独立使用。若要增强工作流，可与以下内容集成：

  • **memory-protocol：**用于保存会话经验和工作状态的持久化存储
  • **agent-coordination：**指令生成中引用的协调模式
  • **pipeline：**流水线控制器可从自我提醒和崩溃恢复中受益
  • **ensemble-team：**团队回顾为会话反思分析提供素材

缺少依赖项？请使用以下命令安装：

npx skills add jwilger/agent-skills --skill memory-protocol

评论

支持 Markdown