book-brain

BOOK BRAIN 是 LYGO 生态系统中专为 Agent 设计的文件系统与记忆管理实用工具，采用独特的"三脑模型"（工作脑、图书馆脑、外部脑）帮助用户构建持久化的知识库架构。该技能并非自动化脚本，而是一份详尽的架构指南，教导 Agent 如何通过科学的文件夹结构、索引系统和引用存根来管理信息，而非简单地将所有内容堆砌到单一文件中。

核心用法围绕"非破坏性组织"展开。当应用于新的 OpenClaw 或 Clawhub 工作空间时，它会建议创建标准化的顶级文件夹结构：memory/ 存放每日日志和原始记录，reference/ 存放稳定的事实和协议，brainwave/ 存放平台特定配置，state/ 存放机器可读的 JSON/YAML 状态文件，logs/ 记录技术日志，tools/ 存放脚本，tmp/ 作为临时工作区。关键策略是使用"参考存根"（.ref.txt 文件）代替完整内容复制，通过在特定文件中存储详细内容并在索引中创建简短引用，实现高效的信息检索。

显著优点在于其保守而智能的设计理念。首先，它明确承诺不删除或覆盖现有文件，所有操作都是追加性的，这大大降低了数据丢失风险。其次，通过结构化的日志记录（如每日健康检查、推理日志）和索引系统（memory_index.json），Agent 可以在数月后快速定位信息，避免全树扫描的性能损耗。此外，它与 LYGO Champion 技术栈深度集成，同时保持对任何具备文件读写能力 Agent 的兼容性。

潜在缺点主要体现在执行层面。作为纯文档型技能，BOOK BRAIN 本身不执行实际的文件操作，所有重组工作仍需 Agent 或用户手动完成，这要求使用者具备一定的技术理解能力和纪律性。此外，其推荐的文件夹结构针对 LYGO/OpenClaw 生态系统优化，对于不熟悉 Haven 式工作流的用户可能存在学习曲线。在已有大量文件的混乱工作空间中应用时，需要人工决策是否合并或创建新分支，这可能中断自动化流程。

适合目标群体包括：使用 OpenClaw、Clawhub 或类似 Haven 系统的开发者；需要长期维护复杂项目记忆的产品经理和研究员；以及希望建立可检索知识库的 AI Agent 开发者。对于那些面临"文件系统混乱"、需要从零建立结构化工作空间或希望改进现有 Agent 记忆检索能力的团队尤为适用。

使用风险相对较低，主要涉及性能与依赖项。随着文件数量增长，如果没有维护好索引，检索速度可能下降。该技能假设 Agent 具备完整的文件系统读写权限，在受限环境中可能无法实施。此外，由于强调人工确认（特别是在处理现有文件时），不适合需要完全自动化无人值守运行的场景。建议用户定期维护索引文件，避免日志文件无限增长，并在生产环境应用前在小规模测试环境中验证文件夹结构。