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. 何をどこに保存したか確認する
知識の検索

関連する話題が出たときは、次のことを行います。

  • 既存の知識を検索する
  • 関連する概念を提示する
  • 新しく学んだことを既存の理解と結び付ける
品質の維持

保存する前に、次の点を確認してください。

  • 背景を忘れた未来の自分に向けて書かれている
  • WHAT だけでなく WHY も含まれている
  • 具体例がある
  • 認証情報、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 対応