Community寫作與編輯github.com

jlholm/noodle

讀寫腦部檔案(brain/ 中的 Obsidian 保險庫)。用於任何需要持久知識的任務——反思、規劃或直接編輯。在除錯會話、錯誤、修正、架構決策或任何值得跨會話保存的洞察之後觸發。用於「新增到腦」、「記住這個」、「寫筆記」或 brain/ 修改。

noodle 是什麼?

這個技能建立了一個持久記憶系統,透過 Obsidian 保險庫 `brain/` 在會話之間保留知識。它是整個工作流程的基礎——每個代理、技能和會話都讀取它。技能對寫入前的檢查、檔案結構、命名約定和格式有嚴格要求:使用要點而非敘述,單一主題一個檔案(如 `brain/codebase/noodle-spawn-gotchas.md`),檔案名稱小寫連字符,並保持在約 50 行以下。它支援維基連結(`[[section/file-name]]`)和系統索引管理,例如 `brain/index.md` 作為根入口點,必須從那裡可達每個腦部檔案。技能也包括一個耐久性測試,幫助決定資訊是否屬於腦部、計劃、技能檔案或待辦事項。維護包括刪除過時或合併的筆記,以及清理 `brain/plans/` 中的隨機命名檔案。這個技能與 Claude Code 和類似代理一起使用,用於任何需要持久知識的任務:反思、規劃或直接編輯。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jlholm/noodle/tree/HEAD/.agents/skills/brain

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

腦部

跨會話持久記憶。位於 brain/ 的 Obsidian 保險庫。

腦部是整個工作流程的基礎——每個代理、技能和會話都讀取它。低品質或推測性內容會使下游所有東西降級。在新增任何內容之前,問自己:「這是否真正改善了系統的運作方式?」如果答案不是明確的「是」,就不要寫。

寫入前

首先讀取 brain/index.md。然後讀取主題相關的入口點:

  • brain/principles.md 用於原則更新
  • brain/plans/index.md 用於計劃相關筆記

對於還沒有專用索引檔案的目錄(brain/codebase/、brain/audits/),直接掃描附近的檔案並在可能時編輯現有筆記。

結構

brain/
├── index.md              ← 根入口點,連結到所有內容
├── principles.md         ← principles/ 的索引
├── todos.md              ← 產品待辦事項
├── vision.md             ← 電梯簡報 + 架構連結
├── architecture.md       ← 完整技術參考
├── principles/           ← 工程和設計原則
├── codebase/             ← 專案特定知識和陷阱
├── plans/                ← 編號功能計劃(02-arrow-bindings/ 等)
└── audits/               ← 設計和品質審核(日期前綴檔案名稱,例如 2026-02-20-quality-audit.md)

規則:

  • 每個檔案一個主題。brain/codebase/noodle-spawn-gotchas.md,而不是一個大型檔案。
  • 維護現有索引入口點:brain/index.md、brain/principles.md、brain/plans/index.md。
  • 如果引入一個新的頂層類別,為它添加一個索引樣式的入口點(僅連結,無內嵌內容)。
  • brain/index.md 是根。每個腦部檔案必須從它可達。
  • 檔案名稱:小寫、連字符。worktree-gotchas.md。
  • 計劃目錄:使用來自 brain/todos.md 的待辦事項 ID 作為前綴。02-arrow-bindings/,內部有 overview.md 和 phase-N-*.md。

維基連結

格式:[[section/file-name]]。解析順序:相同目錄,然後相對路徑,然後保險庫根目錄。標題錨點([[file#heading]])在解析過程中被移除。

寫作風格

  • 要點優先於散文。無前文。
  • 純 Markdown,使用 # 標題。無 Obsidian 前文。
  • 將筆記保持在約 50 行以下。如果更長,則拆分。

寫入後

對任何新增或移除的檔案更新 brain/index.md。在適用時也更新相關的入口點(brain/principles.md、brain/delegation.md 或 brain/plans/index.md)。保持索引僅含連結且易於掃描。

耐久性測試

問自己:「我會把這個包含在一個不同任務的提示中嗎?」

  • 是 → 寫入 brain/。這是持久知識。
  • 否,是計劃特定的 → 改更新計劃的階段文件。
  • 否,是技能問題 → 直接更新技能檔案。
  • 否,需要後續工作 → 使用 todo 技能記錄一個待辦事項。

維護

  • 刪除過時或被取代的筆記。
  • 刪除 brain/plans/ 中隨機命名的檔案——過時的計劃模式產物。
  • 在新增新筆記之前合併重疊的筆記。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能