mcpField
S
Session Management

Session Management

github.com/hedera-devAgent 工作流28553 次安装8 周前更新
代码仓库

关于 Session Management

Session Management 是一项技能，通过工作报告、技术债务跟踪器和记忆笔记，在 AI Agent 会话之间保留项目上下文。它规定了会话记录的开始、更新和归档流程。

主要功能

  1. 01通过报告索引记录工作
  2. 02跟踪分级技术债务
  3. 03归档已解决的报告与债务
  4. 04在 MEMORY.md 中维护项目经验
  5. 05规定会话开始与结束流程

适用场景

  1. 01依据近期变更记录恢复工作
  2. 02记录待处理修复和架构问题
  3. 03在不同会话间保留项目经验

安装

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

$npx skills add https://github.com/hedera-dev/hedera-skills --skill session-management

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

包含的文件

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

references/
registry-template.md
archive-strategy.md
tech-debt-template.md

详细介绍

会话管理

目的

通过提供结构化的工作跟踪、技术债务管理和报告归档，保持 AI Agent 会话之间的连续性。此技能可确保会话之间不会丢失上下文——Agent 始终知道已完成的工作、待办事项以及需要关注的问题。

报告登记表

报告登记表（.claude/reports/_registry.md）是跨会话完成的所有工作的中央索引。

何时添加条目
  • 完成一个有意义的工作单元后（修复 Bug、开发功能、重构、调查）
  • 调查得出了值得保留的发现后
  • 发现需要后续关注的问题时
使用方法
  1. 在会话开始时阅读登记表，了解近期工作
  2. 在会话期间，随着工作完成添加条目
  3. 重新处理之前的工作时，更新条目状态（Active → Resolved）
  4. 按照 15 个类别的结构进行整理
条目格式
### [Category] Short descriptive title
- **Date:** YYYY-MM-DD
- **Status:** Active | Resolved | Archived
- **File:** `.claude/reports/<category>/<filename>.md`
- **Summary:** One-line description of findings or changes

完整模板（包含全部 15 个类别）请参阅 references/registry-template.md。

技术债务跟踪器

技术债务跟踪器（.claude/reports/_tech-debt.md）用于记录开发过程中发现的技术债务。

何时添加债务
  • 发现应该改进但不属于当前工作重点的代码时
  • 使用临时变通方案而非适当解决方案时
  • 跳过测试或发现测试覆盖率缺口时
  • 推迟依赖项更新时
  • 发现架构方面的问题时
优先级
优先级含义操作
P0阻碍开发或生产环境运行在本次会话中修复
P1降低开发体验（DX）或性能本周修复
P2代码质量问题本月修复
P3可有可无的改进方便时修复
条目格式
### [P{0-3}] Short title
- **Added:** YYYY-MM-DD
- **Category:** code-quality | performance | security | architecture | testing | dependency | documentation
- **Location:** `path/to/file.ts:123`
- **Impact:** What happens if this isn't addressed
- **Suggested Fix:** Brief approach description
- **Status:** Open | In Progress | Resolved

包含示例的完整模板请参阅 references/tech-debt-template.md。

归档策略

保持登记表和技术债务跟踪器精简：

  • 报告： 将超过 7 天且已解决的条目归档至 .claude/reports/archive/
  • 技术债务： 已解决的条目保留 90 天以供参考，然后归档
  • 登记表大小： 活跃条目不要超过 50 个——积极归档
  • 每月清理： 删除不再有参考价值的归档条目

详细的归档指南请参阅 references/archive-strategy.md。

通过 MEMORY.md 自我改进

MEMORY.md 是 Claude Code 的自动记忆文件，会自动加载到每个系统提示词中。将其用作自我改进循环，逐步积累跨会话的项目专属经验。

位置
~/.claude/projects/<project-path-with-dashes>/memory/MEMORY.md
何时更新 MEMORY.md
  • 用户每次纠正后——这是最重要的触发条件。如果用户纠正了你的做法，请立即保存这条经验。
  • 发现代码库中不明显的模式或陷阱后
  • 了解用户偏好后（例如，“始终使用 X 库”、“绝不自动提交”）
  • 解决根本原因不明显的棘手 Bug 后
MEMORY.md 结构

按主题整理，而非按时间顺序：

# Project — Lessons Learned

## Build & Tooling
- [lesson]

## Architecture Patterns
- [lesson]

## Testing
- [lesson]

## Common Pitfalls
- [lesson]

## Owner Preferences
- [lesson]
大小限制

保持在 200 行以内——该文件会加载到每个系统提示词中。如果内容过多：

  1. 合并相关条目
  2. 删除根据上下文已显而易见的经验
  3. 创建单独的主题文件（例如 debugging.md），并在 MEMORY.md 中添加链接
不要保存的内容
  • 特定会话的上下文（当前任务、进行中的工作）
  • CLAUDE.md 或项目文档中已有的信息
  • 推测性或未经验证的结论
  • 已妥善修复的临时变通方案

会话开始工作流

恢复在已设置会话管理的项目中的工作时：

  1. 读取注册表： cat .claude/reports/_registry.md
  2. 读取技术债务： cat .claude/reports/_tech-debt.md
  3. 检查 Git 状态： git log --oneline -10 和 git status
  4. 查看与当前工作领域相关的 MEMORY.md 经验（MEMORY.md 会自动加载到系统提示词中）
  5. 总结： 告知用户当前正在进行的事项、待办事项，并建议接下来可以做什么
  6. 检查 P0 级债务： 如果存在任何 P0 级事项，立即提醒用户关注

会话结束工作流

结束会话前：

  1. **更新注册表，**记录本次会话完成的工作
  2. **添加技术债务，**记录发现但尚未处理的问题
  3. **更新 MEMORY.md，**记录本次会话中的更正或经验
  4. 归档任何超过保留期限且已解决的事项
  5. 总结已完成的工作和接下来的计划

交叉引用

  • references/registry-template.md — 包含 15 个类别的完整注册表模板
  • references/tech-debt-template.md — 带示例的技术债务跟踪模板
  • references/archive-strategy.md — 归档规则和生命周期管理

评论

支持 Markdown