ClaudeMods
☰
ZH-TW
● — 人在線上 · 瀏覽 — 次
贊助提交作品
GitHub 儲存庫 · 發布者 noopz

commonplace

把任何資料夾變成由 LLM 維護的知識庫。靈感來自 commonplace book 傳統,以及 [Karpathy](https://x.com/karpathy/status/1899559051789553968) 使用 LLM 管理個人 wiki 的方法。

已翻譯

關於這個 mod

任何目錄都能使用——Obsidian vault、普通資料夾,皆可。不必使用 Obsidian;如果你使用 [[wikilink]] Markdown,它只是很適合用來瀏覽的工具。

功能

  • wiki-init:第一次把 commonplace 指向資料夾 → 建立 .wiki/,找出初始領域
  • wiki-ingest:分享論文、文章或 URL → 結構化 vault 筆記 + concepts + MOC 連結
  • wiki-query:提出研究問題 → 以 wikilink 回答,並把新的關聯歸檔回去
  • wiki-lint:詢問「vault 狀況如何?」→ 唯讀健康報告
  • autoimprove:「改善 vault」→ 由分數控制的迴圈:挑選修正項目、執行、重新評分、重複
  • wiki-compile:用來源論文中的實際定義填入概念存根
  • wiki-supersede:讓被後繼者取代的實體退役,傳播 live→historical 的重新框定
  • wiki-domain:建立或管理帶有範圍規則的研究領域
  • wiki-deep-link:透過本機嵌入(Ollama)找出隱藏的概念關聯
  • paper-analyzer:使用智慧 PDF 擷取與多代理檢閱進行深入論文分析

運作方式

技能會從自然對話自動觸發。你不必輸入斜線指令,只要聊天,正確的技能就會啟動。

安裝

git clone https://github.com/noopz/commonplace
cd commonplace
npm install

# 將它指向你的 vault
npx tsx scripts/init.ts --vault /path/to/your/vault

相依套件

  • gray-matter — YAML frontmatter 剖析
  • glob — 檔案模式比對
  • pdfjs-dist — PDF 文字擷取
  • tsx — TypeScript 執行

安裝

請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。

claude plugin marketplace add noopz/commonplace
claude plugin install commonplace
原文 / README

commonplace

A Claude Code plugin that turns any folder into an LLM-maintained knowledge base. Inspired by the commonplace book tradition and Karpathy's approach to using LLMs for personal wiki management.

Works on any directory — Obsidian vault, plain folder, whatever. Obsidian is not required; it's just a good browser for [[wikilink]] markdown if you use it.

What it does

  • wiki-init: Point commonplace at a folder for the first time → scaffold .wiki/, discover initial domains
  • wiki-ingest: Share a paper, article, or URL → structured vault note + concepts + MOC links
  • wiki-query: Ask research questions → answers with wikilinks + novel connections filed back
  • wiki-lint: Ask "how's the vault?" → read-only health report
  • autoimprove: "improve the vault" → score-gated loop that picks fixes, executes, re-scores, repeats
  • wiki-compile: Fill concept stubs with real definitions from source papers
  • wiki-supersede: Retire an entity replaced by a successor, propagate the live→historical reframing
  • wiki-domain: Create or manage research domains with scope rules
  • wiki-deep-link: Find hidden concept connections via local embeddings (Ollama)
  • paper-analyzer: Deep paper analysis with smart PDF extraction and multi-agent review

How it works

Skills auto-trigger from natural conversation. You never type slash commands — just chat and the right skill activates.

Skill interactions

                        ┌─────────────┐
                        │  wiki-init  │  (one-time setup)
                        └──────┬──────┘
                               │ writes .vault-path
                               ▼
            ┌──────────────────────────────────────┐
            │            (vault is active)         │
            └──────────────────────────────────────┘
                               │
            ┌──────────────────┼──────────────────────────┐
            │                  │                          │
            ▼                  ▼                          ▼
     ┌────────────┐    ┌─────────────┐            ┌──────────────┐
     │ wiki-domain│    │ wiki-ingest │ ◀───┐      │  wiki-query  │
     └────────────┘    └──────┬──────┘     │      └──────┬───────┘
       (new domain             │ paper?    │             │ pivot Q
        when ingest             │ ─yes──▶ paper-analyzer  │ "how does
        finds none)             │           (returns      │  this relate
                                │            analysis)    │  to X?")
                                ▼                        │
                        ┌──────────────┐                 │ ◀────┘
                        │ supersession │   (post-ingest pivot
                        │  declared in │    auto-fires wiki-query)
                        │   body? ──yes┼─▶ wiki-supersede
                        └──────┬───────┘
                               │ no
                               ▼
                       ┌────────────────┐
                       │ post-write hook│
                       │  (deterministic)│
                       └──────┬─────────┘
                              │ dispatches
              ┌───────────────┼─────────────────┐
              ▼               ▼                 ▼
      wiki-moc-updater  wiki-impact-checker  wiki-cross-domain-linker
                                  │
                                  └─ supersession candidate ──▶ wiki-supersede

  Read-only path:                    Autonomous-write path:
  ┌──────────────┐                   ┌──────────────┐
  │  wiki-lint   │ ◀── if fixes ──▶ │ autoimprove  │
  │  (diagnose)  │     wanted        │ (score loop) │
  └──────────────┘                   └──────┬───────┘
                                            │ dispatches per round
                          ┌─────────────────┼────────────────┬──────────────────┐
                          ▼                 ▼                ▼                  ▼
                   wiki-linter      wiki-pruner      wiki-moc-updater   wiki-deep-linker
                                   (refuses retired                       (semantic
                                    → wiki-supersede)                      candidates)
                                            │
                                            ▼
                                    wiki-compile (inline at main-model cost)
                                            │
                                            ▼
                                    wiki-freshness-checker (post-loop)

  Bottom-up triggers (any skill → wiki-supersede):
    • wiki-query lands on retired note
    • wiki-pruner asked to delete retired
    • wiki-impact-checker flags candidate
    • commonplace lint reports retired-but-referenced

| Skill | Triggers on | Hands off to | Receives from | |---|---|---|---| | wiki-init | first-time setup; missing .vault-path | (none) | (entry point) | | wiki-domain | "set up a domain", "list domains" | (none) | wiki-ingest (no domain match) | | wiki-ingest | "save this", arXiv ID, paper URL | paper-analyzer; wiki-supersede; wiki-domain; post-write hook | (entry point) | | paper-analyzer | "analyze this paper"; arXiv without save intent | (returns analysis) | wiki-ingest | | wiki-query | "how does X relate to Y"; post-ingest pivot | wiki-supersede (retired note) | wiki-ingest | | wiki-supersede | "mark X retired"; body declares supersession; retired-but-live debt | (terminal) | wiki-ingest, wiki-query, wiki-pruner, wiki-impact-checker | | wiki-lint | "how's the vault" — read-only | autoimprove (if fixes wanted) | (entry point) | | autoimprove | "improve the vault", "what's the score" | wiki-linter, wiki-pruner, wiki-moc-updater, wiki-deep-linker, wiki-compile, wiki-freshness-checker | wiki-lint | | wiki-compile | "fill the stubs" | (none) | autoimprove; wiki-lint | | wiki-deep-link | "find hidden connections" (needs Ollama) | (none) | autoimprove (optional) |

Three-tier cost model:

  1. TypeScript scripts (zero LLM cost) — indexing, validation, linting
  2. Haiku agents (cheap) — mechanical fixes, wikilink insertion, MOC syncing
  3. Main model (synthesis) — paper analysis, concept definitions, query answers

Install

git clone https://github.com/noopz/commonplace
cd commonplace
npm install

# Point it at your vault
npx tsx scripts/init.ts --vault /path/to/your/vault

Dependencies

  • gray-matter — YAML frontmatter parsing
  • glob — File pattern matching
  • pdfjs-dist — PDF text extraction
  • tsx — TypeScript execution

取得徽章

這是你的專案嗎?把這個徽章放進 README 或網站,連回本頁。

Featured on ClaudeMods
尺寸
配色
Markdown
HTML

更多類似作品