mcpField
S
second-brain

second-brain

github.com/sundial-org生产力67259 次安装34 周前更新
代码仓库

关于 second-brain

second-brain 是用于整理个人知识的技能，让内容便于搜索和长期复用。它按主题组织概念、工具、模式和参考资料，并要求保存前先确认条目草稿。

主要功能

  1. 01按命名空间和主题整理知识
  2. 02保存概念、工具、模式和参考资料
  3. 03搜索并检索已保存条目
  4. 04创建、更新和删除知识条目
  5. 05保存前确认条目草稿

适用场景

  1. 01记录说明以供日后查阅
  2. 02查找某主题的已有笔记
  3. 03向个人工具箱添加工具条目
  4. 04更新或删除过时条目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill second-brain

安装后在 Claude Code 中输入/second-brain确认已加载。

附带文件scripts/ensue-api.sh

详细介绍

第二大脑

一个个人知识库，用于构建能够随时间不断积累的理解。不是随手记录的笔记堆，而是一个结构化系统，用来捕获真正可以检索和使用的知识。

理念

你的第二大脑应该：

  • 捕获理解，而不只是事实——为将来忘了上下文的自己而写
  • 便于检索——结构清晰，让你在需要时能找到内容
  • 保持常青——不包含私人详情、凭据或时效性数据
  • 反映真实经验——只保存你实际学到或用过的内容

保存之前，先问问自己：未来的我会感谢我吗？

命名空间结构

public/                           --> Shareable knowledge
  concepts/                       --> How things work
    [domain]/                     --> Organize by topic
      [concept-name]              --> Individual concepts
  toolbox/                        --> Tools and technologies
    _index                        --> Master index of tools
    [category]/                   --> Group by type
      [tool-name]                 --> Individual tools
  patterns/                       --> Reusable solutions
    [domain]/                     --> Design patterns, workflows
  references/                     --> Quick-reference material
    [topic]/                      --> Cheatsheets, syntax, APIs

private/                          --> Personal only
  notes/                          --> Scratchpad, drafts
  journal/                        --> Dated reflections

示例领域： programming、devops、design、business、data、security、productivity

内容格式

概念

用于理解某事物的运作方式：

CONCEPT NAME
============

What it is:
[One-line definition]

Why it matters:
[What problem it solves, when you'd need it]

How it works:
[Explanation with examples]
[ASCII diagrams for architecture/flows where helpful]

+----------+      +----------+
| Client   | ---> | Server   |
+----------+      +----------+

Key insight:
[The "aha" moment - what makes this click]

Related: [links to related concepts]
工具箱条目

用于记录你实际用过的工具和技术：

TOOL NAME

Category: [category]
Website: [url]
Cost: [free/paid/freemium]

What it does:
[Brief description]

Why I use it:
[Personal experience - what problem it solved for you]

When to reach for it:
[Scenarios where this is the right choice]

Quick start:
[Minimal setup/usage to get going]

Gotchas:
[Things that tripped you up]
模式

用于记录可复用的解决方案：

PATTERN NAME

Problem:
[What situation triggers this pattern]

Solution:
[The approach, with code/pseudocode if relevant]

Trade-offs:
[Pros and cons, when NOT to use it]

Example:
[Concrete implementation]
参考资料

用于记录便于快速查阅的材料：

REFERENCE: [TOPIC]

[Organized, scannable content]
[Tables, lists, code snippets]
[Minimal prose, maximum signal]

交互规则

保存知识

保存之前，务必先确认：

  1. “要我把这个保存到你的第二大脑吗？”
  2. 展示准备保存的草稿
  3. 确认后再保存
  4. 确认保存了什么，以及保存位置
检索知识

提到相关主题时：

  • 搜索现有知识
  • 提供相关概念
  • 将新学到的内容与已有理解联系起来
保持质量

保存之前，请确认：

  • 内容是为忘了上下文的未来自己而写
  • 说明了原因（WHY），而不只是内容（WHAT）
  • 包含具体示例
  • 不含凭据、API 密钥或私人路径
  • 结构便于检索

反模式

  1. 不要自动保存——务必先询问
  2. 不要保存未使用过的工具——只保存实际用过的工具
  3. 不要保存尚未充分理解的概念——先学习，再保存
  4. 不要包含机密信息——不包含 API 密钥、密码或令牌
  5. 不要创建浅显的条目——如果无法解释清楚，就不要保存
  6. 不要重复创建——先检查是否已存在，必要时更新

API 用法

使用封装脚本：

{baseDir}/scripts/ensue-api.sh <method> '<json_args>'
操作

搜索知识：

{baseDir}/scripts/ensue-api.sh discover_memories '{"query": "how does X work", "limit": 5}'

按命名空间列出：

{baseDir}/scripts/ensue-api.sh list_keys '{"prefix": "public/concepts/", "limit": 20}'

获取指定条目：

{baseDir}/scripts/ensue-api.sh get_memory '{"key_names": ["public/concepts/programming/recursion"]}'

创建条目：

{baseDir}/scripts/ensue-api.sh create_memory '{"items":[
  {"key_name":"public/concepts/domain/name","description":"Short description","value":"Full content","embed":true}
]}'

更新条目：

{baseDir}/scripts/ensue-api.sh update_memory '{"key_name": "public/toolbox/_index", "value": "Updated content"}'

删除条目：

{baseDir}/scripts/ensue-api.sh delete_memory '{"key_name": "public/notes/old-draft"}'

工具箱索引

将 public/toolbox/_index 维护为主参考索引：

TOOLBOX INDEX
=============

Categories:
  languages/      Programming languages
  frameworks/     Libraries and frameworks
  devtools/       Development utilities
  infrastructure/ Deployment, hosting, CI/CD
  productivity/   Workflow and productivity tools
  data/           Databases, analytics, data tools

Recent additions:
  [tool] - [one-line description]

Browse: "show my toolbox" or "what tools do I have for [category]"

意图映射

用户说操作
"save this", "remember this"起草条目，确认后保存
"what do I know about X"搜索并检索相关条目
"add [tool] to toolbox"创建工具箱条目
"list my [domain] concepts"对该命名空间调用 list_keys
"show my toolbox"显示工具箱索引
"update [entry]"获取条目、显示差异并更新
"delete [entry]"确认后删除
"search for [topic]"对所有知识进行语义搜索

设置

需要设置 ENSUE_API_KEY 环境变量。

请访问以下网址获取密钥：https://www.ensue-network.ai?utm_source=clawdbot&utm_medium=workflow

在 clawdbot.json 中配置：

"skills": {
  "entries": {
    "second-brain": {
      "apiKey": "your-ensue-api-key"
    }
  }
}

安全

  • 绝不要记录或显示 API 密钥
  • 绝不要在条目中存储凭据、令牌或机密信息
  • 绝不要包含个人文件路径或系统详情

评论

支持 Markdown