specstory-sync

Installation
SKILL.md

Specstory Sync — Claude Code 对话历史自动记录

为任意项目一键配置对话历史自动记录。每次 Claude Code 完成回复时,自动将当前会话导出为格式化的 Markdown 文件,存放在项目的 .specstory/history/ 目录下。

工作原理

  1. 脚本 sync_to_spec.py 读取 ~/.claude/projects/ 下的 JSONL 会话数据
  2. 转换为 Specstory 兼容的 Markdown(含时间戳、角色标签、工具调用摘要)
  3. 去重:通过 fingerprint 机制避免重复写入
  4. Hook:利用 Claude Code 的 Stop 事件钩子自动触发

执行步骤

当用户要求配置对话历史记录时,按以下步骤操作:

Step 1: 部署脚本

scripts/sync_to_spec.py 复制到目标项目的 .specstory/ 目录:

Related skills
Installs
1
First Seen
Apr 23, 2026