name: chronicle-workflow description: 完整的工作流程，用于使用Chronicle跟踪开发工作 - 会话记录、git跟踪、AI摘要和Obsidian文档。支持CLI命令（便携式）或MCP工具（更快）。当开始新的开发会话、首次设置项目跟踪或用户希望全面管理会话时使用。

Chronicle Workflow

这个技能指导你完成使用Chronicle跟踪和记录开发工作的完整工作流程。主要使用CLI命令以实现便携性，可选MCP工具以实现更快的程序访问。

自动激活

这个技能自动激活！ （里程碑#13）

类似于“开始新会话”或“这被跟踪了吗？”的提示会自动触发这个技能。无需手动加载！

触发模式： 开始会话，这被跟踪了吗，Chronicle工作流程，设置 查看： docs/HOOKS.md 了解全部细节

何时使用这个技能

当：

用户开始新的开发会话
首次为Chronicle设置项目
想要确保所有工作都被跟踪
需要关于Chronicle最佳实践的指导
构建全面开发知识库

完整工作流程

1. 会话开始（如果尚未跟踪）

检查是否在Chronicle会话中：

除非使用 chronicle start claude 开始，否则当前会话可能未被跟踪
要跟踪当前工作，用户必须退出并使用Chronicle重新启动

指导用户：

# 退出当前会话
exit

# 开始新的Chronicle跟踪会话
chronicle start claude

# 或者对于其他工具：
chronicle start gemini

重要： Chronicle会话必须明确开始 - 它们不会自动跟踪。

2. 开发期间

最佳实践：

自然工作 - Chronicle自动捕获一切
频繁进行git提交，并附上描述性消息
Chronicle自动将提交与会话链接（±30分钟窗口）

可用命令（不要中断工作来运行这些）：

chronicle sessions              # 列出最近的会话
chronicle show today           # 查看今天的提交
chronicle timeline today       # 组合视图

3. 会话结束

自动退出时：

完整的记录保存到 ~/.ai-session/sessions/session_N.log
保存元数据（持续时间、时间戳、仓库）
在数据库中创建会话记录

会发生什么：

📊 会话 #{id} 完成！持续时间：{minutes} 分钟
💾 完整的记录保存
✨ 使用 'chronicle session {id}' 查看

4. 会话后文档化

生成摘要（首次查看时自动生成）：

# 查看会话并自动生成摘要
chronicle session {id}

# 对于非常大的会话（>50K行）
chronicle summarize-chunked {id}

记录到Obsidian： 使用 chronicle-session-documenter 技能或手动：

"将会话 {id} 记录到我的Obsidian库"

5. 检索与上下文

查找过去的工作： 使用 chronicle-context-retriever 技能：

"上次我是如何实现认证的？"
"数据库迁移的阻碍是什么？"
"显示所有关于API重构的工作"

浏览会话（CLI）：

# 按仓库过滤
chronicle sessions --repo /path/to/project

# 查看时间线
chronicle timeline week

# 搜索会话
chronicle search "authentication" --limit 5

浏览会话（MCP - 如果可用）：

# 更快的程序访问
sessions = mcp__chronicle__get_sessions(repo_path="/path/to/project", limit=20)
results = mcp__chronicle__search_sessions(query="authentication", limit=5)

工作流程模式

模式1：快速功能工作

1. chronicle start claude
2. [更改，提交]
3. exit
4. [下次查看时自动生成摘要]

模式2：多会话项目

1. chronicle start claude （第一天）
2. [工作，提交]
3. exit
4. 记录到Obsidian
5. chronicle start claude （第二天）
6. "我昨天做了什么？"（检索上下文）
7. [继续工作]

模式3：研究与上下文

1. "显示所有关于X的会话"（上下文检索器）
2. 回顾过去的方法和决策
3. chronicle start claude
4. [有信息的方法实现]

多项目管理

自动检测：

会话检测工作目录和git仓库
存储在数据库中以供过滤

按项目过滤：

chronicle sessions --repo /path/to/project
chronicle timeline today --repo /path/to/project
chronicle summarize today --repo /path/to/project

需要突出的关键特性

分块摘要

处理无限大小的会话
测试了83,000+行的会话
使用滚动摘要（10,000行/块）
没有速率限制问题

Obsidian集成

完整的MCP服务器集成
创建结构化的会话笔记
搜索过去的工作
构建知识图谱
会话/提交/仓库之间的Wikilinks

本地优先

所有数据都存储在本地（~/.ai-session/）
SQLite数据库
没有数据离开你的机器（除了AI摘要）

常见问题

Q: “这个会话被跟踪了吗？” A: 只有在使用 chronicle start claude 开始时才会。必须明确。

Q: “我可以追溯性地跟踪会话吗？” A: 不行 - 必须从一开始就使用Chronicle。

Q: “我怎么看我昨天做了什么？” A: 使用 chronicle timeline yesterday 或搜索Obsidian库

Q: “我如何将提交链接到会话？” A: 自动的！在会话的±30分钟内的提交被链接。

数据库位置

所有数据存储在：

~/.ai-session/
├── sessions.db              # 主数据库
├── sessions/
│   ├── session_N.log       # 记录
│   └── session_N.meta      # 元数据
└── config.yaml             # 配置

专业提示

早点开始Chronicle - 不能追溯性跟踪
频繁提交 - 更好的会话-提交链接
记录重要会话 - 在Obsidian中构建知识库
构建前搜索 - 使用上下文检索器避免重复工作
在Obsidian中使用标签 - 使找到过去的工作更容易
审查摘要 - 帮助记住关键决策

与其他技能的集成

在完成会话后使用 chronicle-session-documenter
在开始相关工作时使用 chronicle-context-retriever
与git工作流程结合，进行全面跟踪