agents-chronicle Skill 技能

技能简介

agents-chronicle（品牌名 Chronicle）是一个本地优先的"AI 编程 Agent 全量会话档案库"——它把 Claude Code、Codex、GitHub Copilot、IBM Bob、Google Antigravity 以及 claude.ai / ChatGPT 历史对话全部归档，由 Claude Code 或 Codex 在后台自动抽取知识（修复、踩坑、决策、命令、项目事实、个人偏好），最终形成一个跨项目、跨引擎、可被 Agent 通过 MCP 检索的私有知识库。Claude Code 默认在 30 天后清理 transcript，Codex 不会自动把上次的修复带回到下次会话——Chronicle 正是为了解决这两个"AI 知识蒸发"痛点：原始 transcript 永久归档，分析后的知识按项目聚合 + 跨项目 playbook，所有 Agent 都能通过 chronicle MCP 服务器问"我们之前踩过这个坑吗？"。它通过 ⌘K 仪表盘 + Obsidian 兼容 Markdown Vault + VS Code 扩展 + iOS/Android 远程访问（Tailscale）四种入口把知识交还给开发者。

核心能力

• 全量会话归档：Claude Code / Codex / Codex Cloud / Copilot CLI+Chat / IBM Bob / Antigravity / claude.ai / ChatGPT 八种数据源全部支持，每个会话结束时自动入库
• 后台自动知识抽取：通过 Claude Code 或 Codex 对每条 transcript 分析，抽出"踩坑、决策、命令、项目事实、个人偏好"五类知识
• MCP 检索服务器：Agent 端可问"have we hit this error before?""why did we put idempotency in Postgres?"，Claude Desktop / Cursor / Windsurf / Gemini CLI 都可接入
• 多 Agent 共用一个知识图谱：所有引擎贡献到一个项目知识库 + 跨项目 playbook，词汇表自动绘制成 mindmap
• ⌘K 仪表盘：跨会话 / 知识 / 项目 / 术语 / 命令的统一搜索
• 附件溯源：Agent 生成的文档、页面、图表、PPT、PR、commit 都归到对应会话，文件变更或删除自动标记
• VS Code 扩展：在编辑器内列出当前文件背后的所有 Agent 会话
• 多机同步 + 远程访问：通过 Tailscale 在手机/其他电脑上访问仪表盘，多台机器的会话合并分析一次
• Obsidian 兼容：导出为标准 Markdown Vault，无锁定

安装配置

1. 安装 CLI：uv tool install --python 3.13 agents-chronicle（或 pipx install agents-chronicle），仅支持 macOS 13+
2. 登录一台支持的 Agent：Claude Code 或 Codex 任选其一作为分析器
3. 初始化档案库：chronicle install 自动扫描机器上所有已安装的 Agent、导入历史会话、询问是否登录启动
4. 可选下载 GUI 应用：从 GitHub Releases 下载 Apple Silicon 版 .app，选择 Connect 接入同一档案库
5. 后续接入新 Agent：在 Settings › Sources 中添加，或 chronicle connect，或重新跑 chronicle install

使用步骤

1. 首次安装与导入：chronicle install，按提示选择要记录的 Agent、导入历史会话、决定是否随登录启动
2. 正常使用 Agent：Claude Code / Codex 跑完每个会话，Chronicle hook 在会话结束时自动入库（Codex 还要等 15 分钟空闲）
3. 打开仪表盘：浏览器访问 chronicle ui --open 自动打开，按 ⌘K 全局搜索任意关键词（会话、知识、项目、术语、命令）
4. 查看本周总览：首页显示每日活跃时长 / 会话数 / token / 估算花费，Map 页查看词汇 mindmap
5. 让 Agent 调取历史知识：在 Claude Code 里问"上周那个 Stripe webhook 签名验证是怎么解决的？"，Chronicle MCP 把命中片段直接喂回上下文
6. 导入历史对话：对 claude.ai / ChatGPT 跑 chronicle import，把网页端对话也并入同一档案库
7. 远程访问：在 iOS / Android 上通过 Tailscale 进入同一仪表盘，下班路上浏览白天 Agent 学到的所有知识

适用场景

• 多 Agent 跨会话记忆：Claude Code 白天写的代码 + Codex 晚上跑的 CI 修复，第二天任何一个 Agent 都能调取
• 团队"AI 经验沉淀"：把每位工程师的 Agent 会话统一归档，新人通过 MCP 检索"我们之前是怎么处理 XX 问题的"
• 客户支持 / 售前知识库：把与客户沟通的 ChatGPT 对话导入，按项目抽取 FAQ 给销售 Agent 用
• 个人 AI 学习日志：把每天用 Claude 学的概念、做的实验、踩的坑全部沉淀，半年后翻 ⌘K 就能回忆起
• VS Code 上下文增强：编辑器内直接看到当前文件背后的所有 Agent 会话，无需切窗口

适用人群

• 每天重度使用 Claude Code / Codex / Copilot CLI 的资深工程师
• 管理多个 AI 项目、希望建立"跨项目 playbook"的独立开发者或小团队
• 知识工作者（咨询 / 写作 / 研究）希望把 AI 交互沉淀为长期资产的人
• Obsidian 用户，希望 Agent 会话自动写入本地 Markdown Vault 的玩家

工作原理

Chronicle 在每台支持的 Agent 已知路径（~/.claude/projects、~/.codex/sessions、Copilot CLI / Chat、IBM Bob ~/.bob/db/bob.db、Antigravity ~/.gemini/antigravity 等）上挂一个 hook 或定时读取器。Claude Code 会话结束时立即触发，Codex 等会话空闲后由 15 分钟轮询接管，claude.ai / ChatGPT 通过用户主动 chronicle import 导入。原始 transcript 写入本地归档库后，后台调度 Claude Code 或 Codex 抽取五类知识（踩坑 / 决策 / 命令 / 项目事实 / 个人偏好），结果按项目分桶、跨项目汇总成 playbook；同时构建词汇表 mindmap。Chronicle MCP 服务器把这个档案库暴露为标准 MCP 工具，任何 MCP 兼容 Agent 都能直接检索。仪表盘是一个本地 Web 应用，提供 ⌘K 搜索、首页统计、Map mindmap、附件溯源；导出为标准 Obsidian Markdown Vault 保证无锁定。多台机器通过 Tailscale 接入同一档案库，分析只跑一次避免重复。

官方链接

• PyPI：https://pypi.org/project/agents-chronicle/
• GitHub：https://github.com/Chatixia-AI/agents-chronicle
• 文档：https://github.com/Chatixia-AI/agents-chronicle/blob/main/docs/install.md
• 下载：https://github.com/Chatixia-AI/agents-chronicle/releases/latest