Communitygithub.com

heyitsnoah/claudesidian

互動式設定精靈，協助新使用者根據其 Obsidian 工作流程偏好，建立個人化的 CLAUDE.md 檔案。

claudesidian 是什麼？

claudesidian 是一個互動式引導程式，專為協助使用者初始化並個人化其 Obsidian 知識庫的 CLAUDE.md 設定檔而設計。它會透過一系列提問，了解使用者的筆記習慣、工作流程偏好與組織方法，進而自動產生高度客製化的配置。此工具支援多種作業系統，能智慧偵測既有的 Obsidian 知識庫位置或協助使用者從頭建立，並可選用整合 Gemini Vision 與 Firecrawl 等進階 MCP 工具，以強化 Claude 對媒體檔案的分析與網路研究能力。最終會產出完整的專案資料夾結構、個人化指令集，以及如每週回顧儀式等實用工作流程，讓使用者能立即上手，與 Claude 展開更有效率、更具脈絡的協作。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add https://github.com/heyitsnoah/claudesidian/tree/HEAD/.agents/skills/init-bootstrap
查看原文→瀏覽所有技能

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

說明文件

初始化引導式設定

這個指令會透過詢問您關於 Obsidian 工作流程和偏好的問題，協助您建立個人化的 CLAUDE.md 設定檔。

任務

閱讀 CLAUDE-BOOTSTRAP.md 範本，並以互動方式收集使用者以下資訊：

  • 現有的知識庫結構（如果有的話）
  • 工作流程偏好
  • 筆記風格
  • 組織方法
  • 特定需求

然後根據他們的需求產生自訂的 CLAUDE.md 檔案。

流程

  1. 初始環境設定

    • 使用 date 指令取得目前日期作為時間戳記
    • 檢查目前資料夾名稱，並詢問是否要重新命名
    • 如果是，引導他們完成重新命名（處理上層目錄移動）
    • 檢查 package.json 並安裝相依套件：
      • 優先嘗試 pnpm install（較快、較好）
      • 如果沒有 pnpm，則改用 npm install
    • 確認核心相依套件已安裝
    • 檢查 git 狀態：
      • 如果沒有 .git 資料夾：初始化 git 儲存庫
      • 如果有遠端來源：詢問開發工作
        • 個人知識庫：移除 origin 和 .github 資料夾
        • 貢獻專案：保留 origin 和工作流程不變
      • 如果是乾淨的本地儲存庫：準備就緒
    • 先不要建立資料夾——等到詢問組織方法後再處理

  2. 檢查現有設定

    • 尋找現有的 CLAUDE.md
    • 如果存在，詢問是要更新還是重新開始
    • 檢查 CLAUDE-BOOTSTRAP.md 範本

  3. 收集知識庫資訊

    • 搜尋常見位置以尋找現有的 Obsidian 知識庫（.obsidian 資料夾）
    • 使用適當的深度限制檢查以下路徑：
      • ~/Documents（最大深度 3）——所有平台
      • ~/Desktop（最大深度 3）——所有平台
      • ~/Library/Mobile Documents/iCloud~md~obsidian/Documents（最大深度 5——僅限 macOS，iCloud 知識庫）
      • 家目錄 ~/（最大深度 2）——所有平台
      • 目前目錄的上層（最大深度 2）——所有平台
    • 如果找到，詢問：「在 [路徑] 找到 Obsidian 知識庫。這是你想要匯入的知識庫嗎？」
    • 正確計算檔案數量：find [路徑] -type f -name "*.md" | wc -l（無深度限制）
    • 顯示知識庫大小：du -sh [路徑]
    • 如果確認，分析知識庫結構：
      • 執行 tree -L 3 -d [路徑] 查看資料夾層級
      • 隨機抽樣 10-15 則筆記以了解內容類型
      • 列出 30-50 個最近檔案名稱以偵測命名慣例
      • 檢查每日筆記資料夾和格式
      • 依檔案數量識別最活躍的資料夾
      • 偵測是否使用 PARA、Zettelkasten、Johnny Decimal 或自訂方法
    • 如果不是正確的知識庫或未找到：
      • 僅限 macOS： 詢問：「你的知識庫是儲存在 iCloud Drive 嗎？（是/否）」
      • 如果是（macOS）：「請輸入你的知識庫完整路徑（例如 /Library/Mobile Documents/iCloudmd~obsidian/Documents/YourVault）」
      • 如果否，或是在 Linux/Windows 上：「請輸入你現有知識庫的路徑，或輸入 'skip' 從頭開始」
      • 驗證使用者提供的路徑（參見下方的「使用者路徑驗證」章節）
    • 如果沒有現有知識庫或使用者跳過，則他們是從頭開始

  4. 詢問設定問題

    • 「你叫什麼名字？」（用於個人化）
    • 「你希望我研究你的公開作品，以更了解你的背景脈絡嗎？」
      • 如果是：搜尋資訊
      • 務必顯示發現內容並詢問「這是正確的嗎？」以進行確認
      • 如果找到多人，列出編號供選擇
      • 如果找錯了人，提供重新搜尋或跳過的選項
      • 儲存關於他們工作、寫作風格、專業領域的相關背景
    • 「你遵循 PARA 方法，還是採用不同的組織系統？」
    • 「你的主要使用案例是什麼？（研究、寫作、專案管理、知識庫、每日筆記）」

    如果使用 PARA，詢問特定的設定問題： Tiago Forte 的 PARA 方法

    • 「你正在處理哪些活躍的專案？」（在 01_Projects 中建立資料夾）
    • 「你維護哪些責任領域？」（例如：工作、健康、財務、家庭）
    • 「你經常研究哪些主題？」（在 03_Resources 中設定）
    • 「有任何最近完成的專案嗎？」（可以歸檔並附上摘要）

    一般偏好：

    • 檢查 .obsidian/community-plugins.json 以查看他們使用的外掛
    • 自動分析現有檔案以偵測命名慣例
    • 檢查附件資料夾，確認他們是否使用媒體檔案
    • 「你使用 git 進行版本控制嗎？」
    • 「你經常參考特定的網站或資源嗎？」
    • 「你有特定的寫作風格偏好嗎？」
    • 「有任何你希望 Claude 遵循的工作流程或模式嗎？」
    • 「你想要每週回顧儀式嗎？（例如：星期四的專案回顧）」
    • 「你偏好『思考模式』（提問/探索）還是『寫作模式』？」

  5. 選擇性工具設定

    Gemini Vision（已內建）

    • 詢問：「Gemini Vision 已內建用於分析圖片、PDF 和影片。你想要啟動它嗎？（是/否/稍後再說）」
    • 說明：「你只需要從 Google 取得一個免費的 API 金鑰。這讓 Claude 可以分析你知識庫中的任何視覺內容。」
    • 如果稍後再說：「沒問題！你可以隨時設定，只要從 https://aistudio.google.com/apikey 取得 API 金鑰，將其加入你的 shell profile（例如 /.zshrc、/.bashrc），然後執行 claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs 即可。」
    • 如果是：
      • 引導從 https://aistudio.google.com/apikey 取得 API 金鑰（免費，只需 30 秒）
      • 協助加入 shell profile（.zshrc、.bashrc 等）
      • 執行 claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs
      • 設定 .mcp.json 並加入 API 金鑰
      • 使用範例指令測試連線

    Firecrawl（已內建）

    • 詢問：「Firecrawl 已內建用於網路研究。你想要設定它嗎？（是/否/稍後再說）」
    • 說明：「這對研究來說是一大利器！當你找到一篇文章或網站時，你可以直接將它儲存為 markdown 到你的知識庫中——永久保留內容、可搜尋，並讓 Claude 可以分析。非常適合建立研究資料庫。」
    • 範例：「只要告訴 Claude：『將這篇文章儲存到我的知識庫：[URL]』就完成了！」
    • 如果稍後再說：「你可以隨時設定，只要從 https://firecrawl.dev 取得 API 金鑰，並設定 .scripts/ 中的腳本即可。」
    • 如果是：
      • 引導從 https://firecrawl.dev 取得 API 金鑰（有免費方案）
      • 協助設定 .scripts/ 中的腳本
      • 顯示使用範例：.scripts/firecrawl-scrape.sh https://example.com

  6. 產生自訂設定

    • 取得目前日期：date +"%B %d, %Y" 用於 CLAUDE.md 的頁首
    • 將偏好儲存至 .claude/vault-config.json： 
      {
  "user": {
    "name": "Jane Smith",
    "background": {
      "companies": ["Variance", "Percolate"],
      "roles": ["共同創辦人", "作家"],
      "publications": ["Why Is This Interesting?", "every.to"],
      "expertise": ["開發者工具", "行銷科技", "系統思考"],
      "interests": ["用於思考的 AI", "筆記系統", "創造力"]
    },
    "profileSources": ["https://whyisthisinteresting.com/about", "https://every.to/@username"],
    "customContext": "專注於 AI 作為思考增強工具，而不僅是寫作",
    "publicProfile": true
  },
  "vaultPath": "/path/to/existing/vault",
  "fileNamingPattern": "detected-pattern",
  "organizationMethod": "PARA",
  "primaryUses": ["research", "writing", "projects"],
  "tools": {
    "geminiVision": true,
    "firecrawl": false
  },
  "projects": ["書籍 - 生產力", "SaaS 應用程式"],
  "areas": ["電子報", "健康"],
  "importedAt": "2025-01-13",
  "lastUpdated": "2025-01-13"
}
    • 以 CLAUDE-BOOTSTRAP.md 為基底
    • 加入使用者專屬章節：
      • 包含實際專案/領域的自訂資料夾結構
      • 個人工作流程
      • 偏好的工具和腳本
      • 特定指導原則
      • MCP 設定（如果已設定）
    • 包含他們提供的網站/資源
    • 加入任何自訂的命名慣例
    • 預先填入他們的專案和領域：
      • 在 01_Projects/ 中建立專案資料夾
      • 在 02_Areas/ 中建立領域資料夾
      • 在 03_Resources/ 中建立資源主題
      • 為每個專案/領域加入 README 檔案

  7. 匯入現有知識庫（如果適用）

    • 如果使用者有現有知識庫：
      • 建立 OLD_VAULT 資料夾：mkdir OLD_VAULT
      • 複製整個知識庫，保留結構：cp -r [知識庫路徑]/* ./OLD_VAULT/
      • 複製 Obsidian 設定：cp -r [知識庫路徑]/.obsidian ./
      • 檢查並複製其他重要檔案：
        • .trash/（Obsidian 的垃圾桶資料夾）
        • .smart-connections/（如果有使用那個外掛）
        • 任何工作區檔案：.obsidian.vimrc 等
      • 跳過複製：.git/（他們會有自己的）、.claude/（使用我們的）
      • 顯示摘要：「已將你的知識庫匯入 OLD_VAULT/（X 個檔案，Y 個資料夾）」
      • 說明：「你的原始結構已保留在 OLD_VAULT 中。你可以視需要逐步將檔案遷移到 PARA 資料夾。」

  8. 建立輔助檔案

    • 如果是新知識庫，產生初始資料夾結構
    • 為主要資料夾建立 README 檔案
    • 為每個專案資料夾建立子資料夾：
      • Research/（來源資料）
      • Chats/（AI 對話）
      • Daily Progress/（執行日誌）
    • 建立 05_Attachments/Organized/ 目錄
    • 如果使用 git，設定 .gitignore（包含 .mcp.json、node_modules）
    • 如果要求，建立初始範本
    • 如果使用者想要回顧儀式，建立 WEEKLY_REVIEW.md
    • 如果 FIRST_RUN 標記檔案存在，將它移除
    • 如果儲存庫已初始化，進行首次 git 提交

  9. 執行測試指令

    • 執行 pnpm vault:stats 以驗證腳本運作
    • 如果資料夾存在，測試附件指令
    • 如果已設定，測試 MCP 工具
    • 確認 git 正確追蹤檔案

  10. 提供後續步驟

  • 已建立和設定的項目摘要
  • 針對他們設定的快速入門指南
  • 他們可以使用的可用指令清單
  • 用於驗證一切運作正常的測試指令
  • 根據他們使用案例的初步任務建議
  • 如何之後修改設定

輸出範例

# 你的 Obsidian 知識庫設定

產生日期：[執行 `date +"%B %d, %Y"` 以取得目前日期] 上次更新：[同一天] 根據你的偏好：[主要使用案例] 設定已完成：✅ 相依套件 ✅ 資料夾結構 ✅ Git 已初始化

## 你的自訂資料夾結構

[他們的特定結構與說明]

## 你的工作流程

### 每日常規

[根據他們的回答]

### 專案管理

[他們的特定方法]

### 研究方法（Noah Brier 風格）

- 捕捉你讀過的一切
- 讓重要的想法自然浮現
- 從寫作開始以測試理解
- 使用搜尋而非標籤來尋找東西
- [從 Noah 的系統了解更多](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)

### 每週回顧儀式

[如果啟用：每週四下午 4 點，回顧所有專案]

## 你的偏好

### 檔案命名

- 模式：[他們的慣例]
- 範例：[具體範例]

### 工具與腳本

[與他們工作流程相關的腳本]

## MCP 伺服器（如果已設定）

### Gemini Vision

- 狀態：✅ 已設定並測試
- API 金鑰：設定於 .mcp.json
- 測試方式：`Use gemini-vision to analyze [圖片路徑]`

## 可用指令

### 知識庫管理

- `pnpm vault:stats` - 顯示知識庫統計
- `pnpm attachments:list` - 列出未處理的附件
- `pnpm attachments:organized` - 計算已組織的檔案

### Claude 技能

當你描述任務時，技能會自動發現。範例：

- "幫我思考 X" → `thinking-partner`
- "總結我的一天" / "每日回顧" → `daily-review`
- "處理我的收件匣" → `inbox-processor`
- "重新執行設定精靈" → `init-bootstrap`

技能位於 `.agents/skills/`（官方位置），並在 `.claude/skills/` 和 `.pi/skills/` 有符號連結。它們可在 Claude Code、OpenCode、Codex、Cursor 和 Pi 中使用。

## 快速入門

1. [個人化的第一步]
2. [根據他們目標的下一個動作]
3. [針對他們工作流程的特定步驟]

## 來自研究大師的專業提示

- **成為 Token 極大化主義者**：提供 Claude 大量背景脈絡
- **寫作會擴展**：記錄一切以供未來參考（[Noah Brier](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)）
- **相信湧現**：重要的想法會不斷浮現
- **從寫作開始**：始終以文字形式開始專案
- **定期回顧**：每週留出時間進行整理和更新
- **PARA 方法**：專案、領域、資源、檔案（[Tiago Forte](https://fortelabs.com/blog/para/)）

## 設定摘要

✅ 相依套件已安裝（pnpm/npm） ✅ 資料夾結構已建立 ✅ Git 儲存庫已初始化並與原始中斷連線 ✅ CLAUDE.md 已個人化 ✅ 首次執行設定已完成 [✅ MCP Gemini Vision 已設定——如果已設定] [✅ 已進行首次提交——如果 git 已初始化]

重要的實作注意事項

處理多個知識庫

當偵測到多個知識庫時：

  1. 務必列出所有找到的知識庫，並附上清楚的編號和詳細資訊

  2. 需要明確選擇——不要假設要使用哪個知識庫

  3. 確認選擇之後再繼續匯入

  4. 處理模糊回應——如果使用者提供不明確的輸入（例如貼上螢幕截圖），要求澄清：

    • "我看到你分享了一張螢幕截圖。可以請你輸入你想要匯入的知識庫編號（1-3）嗎？"
    • "我需要一個明確的選擇。請輸入 '1'、'2' 或 '3' 來選擇一個知識庫。"

  5. 提供詳細資訊以協助決策：

    • 知識庫名稱
    • 完整路徑
    • 檔案數量
    • 大小
    • 上次修改日期

相關技能

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community