Chronicle Context Retriever

这个技能帮助你使用Chronicle数据库搜索和检索过去开发会议的上下文。支持MCP服务器（快速，结构化的JSON）或CLI命令（便携，通用）。

自动激活

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

提示像“我上次怎么实现认证的？”或“我昨天做了什么？”会自动触发这个技能。不需要手动加载！

触发模式： how did I, what did I do, find sessions about, search past work 查看： docs/HOOKS.md 了解全部详情

何时使用这个技能

使用这个技能时：

用户问“我昨天/上周做了什么？”
需要回忆一个功能是如何实现的
想要理解为什么做出一个决定
查找类似的过去工作或模式
避免重复过去的错误或方法
在开始相关工作前需要上下文

它如何工作

选项 1：使用MCP（首选）

解析用户查询 - 理解需要什么上下文
搜索Chronicle - mcp__chronicle__search_sessions()返回结构化的JSON（快速！）
获取详细信息 - mcp__chronicle__get_session_summary()获取完整摘要
提取信息 - 解析JSON获取决策、阻碍、解决方案
呈现上下文 - 用会议ID总结发现

选项 2：使用CLI（便携）

解析用户查询 - 理解需要什么上下文
搜索Chronicle - chronicle search "keywords"返回格式化输出
获取详细信息 - chronicle session <id>获取完整摘要
提取信息 - 解析CLI输出获取关键细节
呈现上下文 - 用会议ID总结发现

决策树：

搜索过去的工作
├─ MCP可用？→ 使用mcp__chronicle__search_sessions()快速获取JSON
└─ 仅CLI？→ 使用`chronicle search`并解析输出

搜索策略

⭐ 两阶段搜索工作流程（推荐）

最有效的搜索Chronicle的方式是使用两阶段方法：

第一阶段：广泛发现

使用OR搜索（隐式或显式）来撒大网
找到相关区域/时间范围
获取5-10个潜在会议

第二阶段：深入挖掘

查看会议摘要以确定最相关的
使用精确的AND搜索来缩小范围
提取需要的具体信息

示例工作流程：

# 第一阶段：广泛的OR搜索（多个单词=隐式OR）
results = mcp__chronicle__search_sessions(query="hooks json output", limit=10)
# → 返回会议108, 109, 110, 111, 112（任一单词匹配）

# 查看结果 - 哪些会议看起来最相关？
# 获取有希望的会议的完整摘要
summaries = mcp__chronicle__get_sessions_summaries(session_ids=[110, 111, 112])

# 第二阶段：阅读摘要后，深入挖掘AND
# 现在你知道了确切的搜索词
precise_results = mcp__chronicle__search_sessions(
    query="hookSpecificOutput AND decision/reason/systemMessage",
    limit=5
)
# → 只返回同时包含两个术语的会议（精确匹配）

为什么这样有效：

✅ 第一阶段找到大致区域（防止遗漏相关会议）
✅ 第二阶段找到确切解决方案（防止信息过载）
✅ 总共2-3次搜索对比10+次狭窄搜索可能会错过上下文
✅ 投资回报率：1-2分钟找到确切解决方案对比10-20分钟重新发明

按主题/关键词

使用MCP：

# 搜索会议摘要和提示中的关键词
mcp__chronicle__search_sessions(query="authentication", limit=10)
mcp__chronicle__search_sessions(query="database migration", limit=5)

使用CLI：

# 搜索会议
chronicle search "authentication" --limit 10
chronicle search "database migration" --limit 5

按时间段

使用MCP：

# 从特定时间段获取会议
mcp__chronicle__get_sessions(days=7, limit=20)  # 上周
mcp__chronicle__get_timeline(days=1)  # 昨天带提交

使用CLI：

# 查看最近的会议
chronicle sessions --days 7 --limit 20
chronicle timeline yesterday  # 昨天带提交

按仓库

使用MCP：

# 按仓库路径过滤会议
mcp__chronicle__get_sessions(repo_path="/Users/.../my-app", limit=20)

使用CLI：

# 会议命令支持通过配置仓库过滤
chronicle sessions --limit 20  # 默认当前仓库

按工具

使用MCP：

# 按使用的AI工具过滤
mcp__chronicle__get_sessions(tool="claude-code", limit=10)
mcp__chronicle__get_sessions(tool="gemini-cli", limit=10)

使用CLI：

# 按工具过滤
chronicle sessions --tool claude-code --limit 10
chronicle sessions --tool gemini-cli --limit 10

示例查询

“我上次怎么实现认证的？”

使用MCP：

# 搜索认证相关的会议
sessions = mcp__chronicle__search_sessions(query="authentication", limit=5)
# 获取相关会议的详细信息
for session in sessions:
    details = mcp__chronicle__get_session_summary(session_id=session["id"])
# 提取实现方法和决策

使用CLI：

# 搜索认证工作
chronicle search "authentication" --limit 5

# 查看特定会议详情
chronicle session <id>
# 解析输出获取方法和决策

“数据库迁移时我们遇到什么阻碍？”

使用MCP：

# 搜索数据库迁移问题
sessions = mcp__chronicle__search_sessions(query="database migration blocker", limit=5)
# 找到相关会议并提取问题+解决方案

使用CLI：

# 搜索迁移阻碍
chronicle search "database migration blocker" --limit 5

# 查看会议有阻碍
chronicle session <id>

“展示所有关于用户仪表板功能的工作”

使用MCP：

# 搜索用户仪表板工作
sessions = mcp__chronicle__search_sessions(query="user-dashboard", limit=10)
# 按时间顺序列出会议并总结进展

使用CLI：

# 搜索仪表板工作
chronicle search "user-dashboard" --limit 10

# 按时间顺序查看会议
chronicle sessions --limit 10

响应格式

检索上下文时，按如下结构组织响应：

## 过去会议的上下文

### 会议 {id} - {date}
**完成的工作：** {摘要}
**关键决策：** {决策及其理由}
**结果：** {结果}
**相关：** [[会议-{id}]]

### 会议 {id} - {date}
...

## 与当前工作相关
- {这个上下文如何应用}
- {需要记住什么}
- {根据过去经验需要避免什么}

使用的工具（MCP或CLI）

Chronicle数据库操作

MCP方法（首选）：

mcp__chronicle__search_sessions - 搜索会议摘要和提示（快速JSON）
mcp__chronicle__get_session_summary - 获取特定会议的完整摘要
mcp__chronicle__get_sessions - 列出带过滤器的会议（工具，仓库，天数）
mcp__chronicle__get_timeline - 获取会议+提交的时间线
mcp__chronicle__search_commits - 搜索git提交消息
mcp__chronicle__get_commits - 列出带过滤器的提交

CLI替代方法（便携）：

chronicle search "query" - 通过关键词搜索会议
chronicle session <id> - 获取特定会议摘要
chronicle sessions --limit 10 - 列出最近的会议
chronicle timeline today - 查看会议+提交
chronicle search "commit message" - 搜索提交
chronicle show today - 列出最近的提交

Obsidian Vault操作（可选）

仅当用户想要Vault笔记时：

mcp__obsidian__search_notes - 在Vault中查找记录的会议
mcp__obsidian__read_note - 阅读Obsidian会议笔记

提示

首先Chronicle数据库！ - 比Obsidian Vault搜索快
可用时使用MCP - 结构化JSON比CLI输出更容易解析
CLI在任何地方都有效 - 当MCP未配置时作为可靠的后备
总是先广泛搜索，然后使用具体的会议ID缩小范围
查看多个相关会议以寻找模式
查看成功和受阻的方法
注意日期和仓库以理解上下文演变
结合时间线视图一起查看提交+会议
使用CLI时，仔细解析输出以获取会议ID和摘要