specstoryai/getspecstory

SpecStory – 捕获并搜索你的 AI 编程对话

它是什么

• 一个本地优先的 CLI（以及 IDE 扩展），可自动记录你与 AI 编程助手（例如 Cursor、GitHub Copilot、Claude Code、Codex 等）的每一次交互，并将其存储在项目内隐藏的 .specstory/history/ 文件夹中。
• 录制的会话可以（可选）同步到 SpecStory Cloud，在那里它们变得可搜索、可共享，并可通过聊天式界面进行查询。
• 一个名为 Lore 的配套工具可以挖掘这些历史记录，生成可复用的“代理技能”，这些技能编码了你实际使用的模式。

主要功能

• 自动捕获 – 无需手动复制粘贴；CLI 包装支持的代理，并保存每个提示、响应和代码片段。
• 本地优先隐私 – 除非你登录并明确同步，否则数据永远不会离开你的机器。
• 跨工具支持 – 适用于数十种终端代理（Claude Code、Cursor CLI、Codex、Droid、DeepSeek 等）以及 Cursor 和 GitHub Copilot 的 IDE 扩展。
• 搜索与聊天 – 在本地或云端对所有保存的会话进行全文搜索；用自然语言提问以检索过去的决策。
• 团队共享 – 可选的云工作区让团队共享知识库。
• Lore 技能生成 – 将历史会话转化为有证据支持的代理技能，可安装在任何受支持的代理上。

如何开始

1. 安装 CLI（Homebrew）：

   brew tap specstoryai/tap
   brew install specstory
   

2. 通过 SpecStory 运行代理 – 例如，specstory run claude 或 specstory run cursor。该工具启动底层代理并自动保存会话。
3. 同步到云端（可选）：

   specstory login   # 创建账户
   specstory sync    # 推送本地历史记录
   

4. 搜索或聊天 通过 specstory search <term> 或打开 cloud.specstory.com 的 Web UI。
5. 生成 lore：

   npx skills add specstoryai/getspecstory --skill lore
   # 然后在受支持的代理中调用 /lore
   

支持的代理（部分列表） – 所有代理都使用相同的 CLI 包装器：

• Cursor IDE 和 CLI
• GitHub Copilot（VS Code）
• Claude Code
• OpenAI Codex CLI
• Droid CLI
• DeepSeek TUI
• Antigravity CLI
• Muse Code、Qwen Code、Pi、Grok Build、OpenCode 等。

典型用例

• 永不丢失解决方案 – 几个月后重新查看错误修复或设计决策。
• 新团队成员入职 – 分享解释项目约定的精选会话。
• 构建个人 AI 助手 – 使用 Lore 生成的技能，为代理提供你的代码库和工作流程的内置知识。
• 审计 AI 生成的代码 – 保留模型建议内容和时间的可搜索审计跟踪。

文档与支持

• 完整文档：https://docs.specstory.com/overview
• 云 API 参考：https://docs.specstory.com/api-reference/introduction
• 社区：Slack、Discord、X（Twitter）、LinkedIn、YouTube
• 问题跟踪器：https://github.com/specstoryai/getspecstory/issues

许可证

• 核心 SpecStory CLI 是开源的（MIT 风格），位于 specstory-cli/ 下。云服务是专有 SaaS 产品，但使用是可选的。

---

由 SpecStory 用 ❤️ 制作