名称: 备份 描述: “将项目上下文和全局Claude数据备份到SMB共享。在风险操作前、会话结束时或按需使用。” 允许工具: Bash(执行备份*), Bash(列出/tmp/ctx-backup*)
备份 .context/、.claude/、ideas/ 和 ~/.claude/ 到配置的SMB共享。
何时使用
- 风险操作前(重大重构、依赖升级)
- 生产性会话结束时
- 用户明确要求备份时
- 切换分支前(存在未提交的上下文更改)
何时不使用
- 当
CTX_BACKUP_SMB_URL未配置时(脚本会报错——告知用户进行设置) - 短时间内多次执行且中间无更改
使用示例
/backup
/backup project
/backup global
/backup all
参数
| 参数 | 备份内容 |
|---|---|
| (无) | 同 all |
project |
仅项目上下文(.context/、.claude/、ideas/) |
global |
仅全局Claude数据(~/.claude/) |
all |
项目和全局数据 |
执行
根据参数运行相应的make目标:
# 对应 "project"
make backup
# 对应 "global"
make backup-global
# 对应 "all" 或无参数
make backup-all
流程
- 解析参数(未提供时默认为
all) - 运行相应的
make目标 - 从输出中报告归档路径和大小
- 向用户确认成功
质量检查清单
- [ ] make目标完成且无错误
- [ ] 向用户报告归档大小
- [ ] 若SMB共享未挂载,清晰传达错误信息