| name | done |
| description | 会话结束时整理知识,生成中文 Markdown 摘要文档并保存到本地。仅在用户显式触发 /done 时执行,不自动运行。 |
| disable-model-invocation | true |
| argument-hint | ["可选备注说明"] |
| allowed-tools | Bash, Write |
/done — 会话知识整理与持久化
按以下步骤依次执行,将本次会话的知识结构化保存,不要跳过任何步骤。
第一步:采集环境元数据
执行 Bash 命令收集当前环境信息:
date +%Y-%m-%d
date +%H:%M:%S
pwd
git remote get-url origin 2>/dev/null || echo "非Git仓库"
git branch --show-current 2>/dev/null || echo "无"
git log -1 --format="%h %s" 2>/dev/null || echo "无提交记录"
git status --short 2>/dev/null | head -10 || echo "无变更"
第二步:分析会话,生成结构化内容
回顾整个会话历史,提取以下内容:
- 文件标题:5 到 15 个汉字,简洁描述核心主题,不含特殊字符和标点
- 示例:
MCP配置整合、认证模块重构讨论、性能瓶颈排查
- 标签:3 到 8 个关键技术词汇组成的列表
- 会话概要:2 到 3 句话,说明本次会话的目标和结论
- 关键讨论:3 到 8 条核心讨论要点
- 决策记录:本次做出的每一个技术或架构决策,及其原因
- 问题与解决:遇到的问题、根因分析、解决方案(或标注悬而未决)
- 后续行动:具体可执行的 TODO 项
- 关键代码 / 配置:本次会话中出现的重要代码或配置片段(如有)
第三步:创建目录并写入文档
先执行 Bash 创建目录:
mkdir -p ~/docs/$(date +%Y-%m-%d)
然后使用 Write 工具,将文件写入 ~/docs/[DATE]/[标题].md,内容格式如下:
---
会话ID: claude-code-[DATE]-[TIME]
日期: [DATE]
时间: [TIME]
工具: Claude Code
工作目录: [PWD]
Git仓库: [GIT_REMOTE]
Git分支: [GIT_BRANCH]
Git最近提交: [GIT_COMMIT]
Git变更文件: [GIT_STATUS]
标签: [[tag1], [tag2], [tag3]]
备注: $ARGUMENTS
文件路径: ~/docs/[DATE]/[标题].md
---
# [标题]
## 会话概要
[2 到 3 句话总结本次会话目标与结论]
## 关键讨论
- [讨论要点 1]
- [讨论要点 2]
- [讨论要点 3]
## 决策记录
| 决策问题 | 选择方案 | 决策原因 |
|---------|---------|---------|
| [问题描述] | [所选方案] | [原因说明] |
## 问题与解决
### [问题名称]
- **现象**:[描述]
- **根因**:[分析]
- **解决**:[方案]
- **状态**:已解决 / 待跟进
## 后续行动
- [ ] [任务 1]
- [ ] [任务 2]
## 关键代码 / 配置
[重要代码或配置片段,无则删除此节]
第四步:输出确认信息
完成后在会话中输出:
文档已生成:~/docs/[DATE]/[标题].md
标签:[标签列表]