jfox-session-summary

name	jfox-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

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

前置条件

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

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

工作流程

Step 1: 生成会话总结

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

## 会话总结

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

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

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

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

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

将生成的总结用普通文本输出供用户阅读，随即直接写入（无需确认）：

jfox add "<markdown-escaped-summary>" \
  --title "Session: <topic>" \
  --type session \
  --topic <short-topic> \
  --tag session \
  --kb <kb-name> \
  --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> \
  --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 等）详见 /skill:jfox-common §4.5。

错误处理

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