1.7.0
对应仓库当前发布的版本。完整变更请查看 GitHub Releases。
开源项目已核验
跨会话上下文管理
用一个 .story 目录保存工单、问题、路线图和会话交接记录，让每次新开的编程会话不必从零开始。
669收藏Storybloq作者1.7.0版本PolyForm-Shield-1.0.0许可证
Skill 概览
编程助手是无状态的：每开一个新会话，它都不知道昨天做了什么、哪里还坏着、当初为什么那么决定、接下来该做什么。大家通常靠 CLAUDE.md 和散落的笔记来弥补，但没有统一结构，也没有会话之间的延续和配套工具。真正的代价不是重新交代背景花的那点时间，而是重复踩同一个坑、把已经定过的设计再吵一遍、以及凭空编出来的上下文——工作因此变成线性的，而不是累积的。Storybloq 给每个项目一个 .story 目录，用 JSON 和 Markdown 记录工单、问题、路线图阶段、会话交接和经验教训，纳入 Git 管理，任何 AI 都能读。它同时提供命令行工具、MCP 服务和技能三种接入方式。
核心功能
- 用 .story 目录统一保存项目上下文
- 记录工单、问题、路线图阶段与经验教训
- 会话交接有固定结构，新会话可直接接手
- 文件纳入 Git 管理，变更可追溯
- 同时提供命令行、MCP 服务与技能三种接入方式
适用场景
- 项目跨越多天多次会话，每次都要重新交代背景
- 同一个设计决定被反复讨论，想留下依据
- 多人或多环境协作，需要共享同一份上下文
- 希望助手知道下一步该做什么，而不是每次问你
安装方式
bash
npm install -g @storybloq/storybloq使用说明
在项目里初始化 .story 目录后，把工单、已知问题和路线图写进去。会话结束时留下交接记录，下次开新会话时助手读取这个目录即可接上进度。可以按需选择命令行、MCP 服务或技能的方式接入，文件本身是 JSON 和 Markdown，必要时直接编辑也可以。
示例工作流
- 全局安装并在项目中初始化 .story 目录
- 录入当前的工单、问题与路线图阶段
- 正常进行编程会话
- 会话结束时写下交接记录与经验教训
- 下次开新会话，让助手先读 .story 再动手
更新记录
常见问题
它和在 CLAUDE.md 里写项目说明有什么不同？
CLAUDE.md 是一份自由格式的说明，没有固定结构，也不区分工单、问题和交接。Storybloq 给这些内容各自的位置和格式，并配了命令行与 MCP 服务来读写，所以新会话能按结构接手而不是通读一篇散文。
许可证是什么？可以商用吗？
仓库采用 PolyForm Shield 1.0，这不是标准的开源许可证，它限制用于与本项目竞争的用途。商用前请阅读仓库中的 LICENSE 原文确认。