session-summary

name	session-summary
description	Use when user wants to save the current conversation/session summary into their Zettelkasten. Triggers on "保存会话", "总结到知识库", "记录这次对话", "写入知识库", "save session", "summarize to knowledge base", "log this conversation".

JFox Session Summary

将当前 Claude Code 会话的总结写入 jfox 知识库（session 类型，生成后直接写入）。

前置条件

• 知识库已初始化（jfox init）
• 确认目标知识库（通过 --kb 或当前默认）

本技能复用 /jfox:manage §4.1 的共享约定（--kb / --json / --content-file）。jfox add 通用参数语法详见 /jfox:manage §4.2；下文记录的是 session 类型专属约束。

工作流程

Step 1: 生成会话总结

回顾当前会话内容，生成结构化总结：

## 会话总结

### 主题
[一句话描述会话主要话题]

### 完成的工作
- [具体完成的任务 1]
- [具体完成的任务 2]
- ...

### 关键决策
- [决策 1 及其理由]
- [决策 2 及其理由]

### 待办 / 后续
- [未完成的事项]
- [后续步骤]

Step 2: 展示总结并写入知识库

将生成的总结用普通文本输出供用户阅读，随即直接写入（不弹 AskUserQuestion）：

jfox add "<markdown-escaped-summary>" \
  --title "Session: <topic>" \
  --type session \
  --topic <short-topic> \
  --tag session \
  --kb <kb-name> \
  --format json

注意：

• 笔记类型固定为 session（AI Agent 会话记录，专为此场景设计）
• --topic 参数必填，值应该是简短的英文标识（如 atomic-write、daemon-stop-fix），由总结内容自动归纳
• 标题格式统一为 Session: <简短主题>
• 标签统一使用 session
• 总结内容已在上方以普通文本展示，供用户阅读；如需修改，事后用 jfox edit
• 内容中的双引号需要转义，或使用 --content-file 从临时文件读取

Step 3: 处理长内容

如果总结超过 500 字或包含特殊字符，优先使用 --content-file：

# 写入临时文件
cat > /tmp/session-summary.md << 'EOF'
<总结内容>
EOF

# 从文件导入
jfox add --content-file /tmp/session-summary.md \
  --title "Session: <topic>" \
  --type session \
  --topic <short-topic> \
  --tag session \
  --kb <kb-name> \
  --format json

命令参考

# 直接添加（短内容）
jfox add "<summary>" --title "Session: <topic>" --type session --topic <short-topic> --tag session --kb <name>

# 从文件添加（长内容或含特殊字符）
jfox add --content-file <path> --title "Session: <topic>" --type session --topic <short-topic> --tag session --kb <name>

写入后的验证（jfox show / jfox refs 等）详见 /jfox:manage §4.5。

错误处理

• "Knowledge base not found": 提示用户先调用 manage 技能（/jfox:manage）创建知识库
• 内容过长导致 shell 解析失败: 切换到 --content-file 方式
• 特殊字符转义问题: 使用单引号包裹内容，或写入临时文件