name	session-manager
description	跨会话项目追踪工具。自动保存工作进度到SESSION.md，创建Git检查点，快速恢复上下文。支持会话开始/结束、进度查看、上下文恢复。适用于长期项目开发、多阶段任务。当用户提到"保存进度"、"结束会话"、"开始会话"、"恢复工作"时使用。
license	Apache-2.0
metadata	[object Object]

会话管理器 (Session Manager)

触发场景

当用户提到以下关键词时使用本技能：

保存进度、结束会话、wrap session
开始会话、恢复工作、continue session
查看进度、当前状态
上次做到哪了、继续上次的工作

核心功能

📝 会话开始 (Continue Session)

读取SESSION.md获取项目状态
显示当前阶段和进度
列出"下一步行动"清单
检查未提交的Git更改
加载相关文档和规划

💾 会话结束 (Wrap Session)

更新SESSION.md（当前阶段、已完成任务、下一步行动）
创建Git检查点提交
记录已知问题和待解决事项
可选更新CHANGELOG.md
可选生成项目规则文件

🎯 进度跟踪

SESSION.md格式化管理
实现→验证→调试循环追踪
任务完成度统计
里程碑记录

🔄 上下文管理

关键决策记录
技术债务追踪
已知问题列表
最近Git历史摘要

SESSION.md 格式规范

重要: 所有时间戳必须精确到分钟（格式：YYYY-MM-DD HH:MM）

# 项目名称 - 会话状态

**会话日期**: 2025-12-26 13:20
**最后更新**: 2025-12-26 15:30
**当前阶段**: Phase 2 - 核心功能开发

## 进度概览

- [x] Phase 1: 项目初始化 (100%)
- [ ] Phase 2: 核心功能开发 (60%)
  - [x] 用户认证模块
  - [x] 数据库设计
  - [ ] API接口开发 (进行中)
  - [ ] 前端集成
- [ ] Phase 3: 测试与优化 (0%)

## 下一步行动

1. 完成用户管理API的CRUD接口
2. 编写API单元测试
3. 集成前端用户列表页面

## 最近完成

- ✅ 实现用户认证JWT Token生成
- ✅ 完成数据库迁移脚本
- ✅ 配置CORS和中间件

## 已知问题

- [ ] 用户登录响应时间较慢，需要优化查询
- [ ] 前端Token刷新机制待实现

## 技术决策

- 选择SQLAlchemy作为ORM（原因：类型安全、迁移管理）
- 使用Redis缓存用户会话（原因：提升性能）

## 资源链接

- [实施计划](docs/IMPLEMENTATION_PHASES.md)
- [API文档](docs/API.md)
- [技术栈](README.md#技术栈)

使用示例

会话开始

# 用户输入
开始会话 / 继续上次的工作

# 技能输出
📋 项目状态摘要
- 会话日期: 2025-12-26 13:20
- 当前阶段: Phase 2 - 核心功能开发 (60%)
- 最后更新: 2天前 (2025-12-24 16:45)

✅ 最近完成
- 用户认证JWT Token生成
- 数据库迁移脚本

🎯 下一步行动
1. 完成用户管理API的CRUD接口
2. 编写API单元测试

⚠️ 已知问题
- 用户登录响应时间较慢

📦 Git状态
- 有2个未提交的文件：src/api/users.py, tests/test_auth.py

准备继续工作吗？

会话结束

# 用户输入
保存进度 / 结束会话

# 技能输出
💾 正在保存会话状态...

✅ 已完成任务：
- 实现用户CRUD接口
- 编写API单元测试

📝 更新SESSION.md：
- 保存时间: 2025-12-26 17:30
- 最后更新: 2025-12-26 17:30
- 当前阶段进度: 60% → 75%
- 新增完成任务2项
- 更新下一步行动

🔖 创建Git检查点：
commit: feat(api): 完成用户管理CRUD接口

下次继续的行动：
1. 集成前端用户列表页面
2. 实现用户权限控制

会话已保存！

查看进度

# 用户输入
查看当前进度 / 项目状态

# 技能输出
📊 项目进度概览

Phase 1: 项目初始化 ████████████ 100%
Phase 2: 核心功能开发 ████████░░░░ 75%
Phase 3: 测试与优化 ░░░░░░░░░░░░ 0%

总体进度: 58%

当前焦点: API接口开发
下一步: 集成前端用户列表页面

Git检查点规范

提交信息格式（Conventional Commits）：

<type>(<scope>): <subject>

<body>

Session checkpoint:
- Phase: Phase 2 - 核心功能开发
- Progress: 75%
- Next: 集成前端用户列表页面

工作流程

会话开始
- 读取SESSION.md
- 检查Git状态
- 显示上下文摘要
- 提供下一步指引
工作进行中
- 随时可查看进度
- 更新任务状态
- 记录决策和问题
会话结束
- 更新SESSION.md
- 创建Git检查点
- 记录下一步行动
- 清理上下文

最佳实践

✅ 推荐做法

时间精确性: 所有时间戳必须精确到分钟（格式：YYYY-MM-DD HH:MM）
每天结束时执行wrap session
保持SESSION.md简洁明了
使用具体的下一步行动
及时记录已知问题
Git检查点包含有意义的描述

❌ 避免事项

⚠️ 时间戳只到日期，缺少具体时间
SESSION.md过于详细（应引用外部文档）
忘记更新进度百分比
下一步行动过于宽泛
忽略已知问题的记录

时间戳格式要求

标准格式: YYYY-MM-DD HH:MM

示例:

✅ 正确: 2025-12-26 13:20
✅ 正确: 2025-12-26 15:45
❌ 错误: 2025-12-26 (缺少时间)
❌ 错误: 2025/12/26 13:20 (格式不正确)

应用位置:

会话日期 (Session Date)
最后更新 (Last Updated)
保存时间 (Save Time)
所有时间相关的记录

输出契约（必须包含）

任何一次会话开始/结束/进度查看输出，都必须包含：

时间戳校验结果：所有时间戳精确到分钟（YYYY-MM-DD HH:MM）；若检测到不合规，必须提示并给出修正建议。
下一步行动列表：1-5 条、可立即执行，且与当前阶段一致。
Git 状态摘要（含降级规则）：
- 若存在 Git：至少包含“是否有未提交变更/是否有未跟踪文件/当前分支（如可得）”。
- 若不存在 Git/不在仓库：必须明确说明并降级为“建议的 git 初始化/提交步骤（可选）”。
当前阶段与进度：阶段名 + 百分比（若无法估算，说明原因并给出改用里程碑/计数口径）。
已知问题/风险：至少 1 条；若无则写“暂无”。

边界条件与失败策略

SESSION.md 不存在：生成并输出标准模板；如允许写文件，再创建 SESSION.md。
无法写文件：在对话中输出完整的 SESSION.md 内容，并给出建议保存路径。
无 Git / git 不可用：
- 不创建“Git 检查点”并明确说明原因。
- 仍更新/输出 SESSION.md，并给出可选的 git init / git add / git commit 建议。
未提交变更很多：先给出变更摘要与风险提示；创建检查点前要求用户确认。

合规与安全（统一规则）

默认不执行 git push；即使已提交，也需用户明确指令才 push。
不进行破坏性 Git 操作（例如 reset --hard、push --force）除非二次确认。
不记录或输出敏感信息（Token/密钥/个人数据）；必要时用占位符并提醒打码。
统一规范详见：../../STANDARDS.md

最小失败输出（必须）

当无法完成会话管理动作（continue/wrap/查看进度）时，仍必须输出：

失败原因：缺少 SESSION.md/无法访问仓库/权限限制。
已可交付内容：标准 SESSION.md 模板或下一步建议清单。
需要用户补充的信息：最少清单。
下一步：给出 1-3 条可执行建议。

配置项对齐（config.yaml）

skills.session-manager.auto_git_checkpoint（默认 true）：wrap-session 是否自动创建 Git 检查点。
skills.session-manager.session_file（默认 SESSION.md）：会话文件名。

版本: 2.0
分类: 生产力工具
依赖: Git

session-manager

Install Skill

SKILL.md