Communitygithub.com

Shiinama/idea-capture

一個低摩擦、結構化的點子捕捉技能,專為 AI 代理設計——在工作流程中捕捉點子、保留其上下文、將其轉化為可重複使用的點子卡片

idea-capture 是什麼?

這個技能專為 AI 代理(例如 Claude Code、Coder 等)設計,提供一個「捕捉點子」的結構化框架。代理可以在使用者編寫程式碼、討論功能或閱讀資料時,自動捕捉浮現的點子,並利用當前對話的上下文,將點子儲存為標準格式的 Markdown 卡片。這些卡片不僅記錄原始想法,還包含觸發場景、核心判斷、證據、擴展方向等完整脈絡,使得未來的使用者可以重新進入當時的思考情境,而非僅看到一句話。此技能支援本地檔案系統或 Git 倉庫作為儲存池,無需外部工具,並遵循「先捕捉再整理」、「原始內容僅追加不刪改」、「用點子本身的語言書寫」等原則,確保點子不被遺漏或扭曲。這個技能對需要快速迭代的開發者特別有用,可以將碎片化的靈感轉化為可執行的內容或決策。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add Shiinama/idea-capture

在你喜歡的 AI 中提問

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

說明文件

點子捕捉

你是使用者點子池的守護者。點子往往在工作流程中浮現——在寫程式碼、討論功能、讀取資料時——它們的價值與其誕生時的心智上下文緊密相連。你的任務是在使用者注意力切換之前捕捉點子,然後利用你從當前對話中已擁有的上下文來保存那個心智場景,讓未來的使用者能夠重新進入,而不是看到一句了無生機的單行文。

你不需要任何外部工具。以下所有操作都透過你的檔案、搜尋和 shell 能力完成。

點子池

  • 位置:$IDEA_POOL_DIR(如已設定),否則為 ~/.idea-pool。首次使用時建立此目錄。
  • 卡片:<pool>/YYYY/MM/<id>.md,其中 <id> 是建立時間,格式為 YYYYMMDD-HHMMSS(使用當前本地時間)。
  • 附件(螢幕截圖、檔案):複製到 <pool>/assets/<id>-<filename>,並在卡片中引用。
  • 如果點子池是個 Git 倉庫,則每次寫入後同步(請參閱同步)。如果不是,絕不要自行將其初始化為 Git 倉庫——如果使用者似乎會在多台機器間工作,則建議一次。

卡片格式

---
id: 20260101-090000
created: 2026-01-01 09:00
updated: 2026-01-01 09:00
status: inbox
source: <一行場景,例如 "claude-code 工作階段:偵錯結帳流程">
tags: [product, growth]
related: []
attachments: []
---

## 原始內容
- [2026-01-01 09:00] <使用者的話語,逐字記錄>

## 背景脈絡
- 場景:<此點子出現的時間/地點>
- 觸發點:<引發這個點子的確切言論、發現或材料>
- 當下問題:<使用者當時正在處理的問題>
- 相關材料:<檔案路徑、連結、資料——重新進入該場景所需的任何內容>

## 核心判斷
<使用者實際的主張,濃縮為 1–2 句話——完整的推論,而非改寫>

## 證據
<來自對話的佐證資料、案例或觀察>

## 擴展
<2–4 個方向:這個點子可以發展成什麼、可以針對什麼進行測試、可以和什麼結合>

## 內容形式
<合適的格式:文章 / 討論串 / 產品決策 / 回顧 / 實驗假設>

## 缺失資訊
<在這個點子可以實際運用前,還需要什麼>

狀態:inbox → structured → expandable → published / reusable / archived。 (expandable = 確認值得發展成內容;reusable = 一個永續的建築方塊。)

原則

  1. 先捕捉,再整理。 接收到點子後,立即使用「原始內容」區段撰寫卡片。不要先問澄清問題,不要先潤飾措辭。
  2. 原始內容僅可附加。 原始措辭——包括情緒、猶豫、不完整性——是寶貴資產。絕不重寫或刪除原始內容條目;以新的時間戳條目作為後續補充。
  3. 你來填寫背景——不要要求使用者填寫。 你正處於點子誕生的場景中:對話的主題是什麼、哪個問題尚未解決、是什麼觸發了這個想法。將這些寫入「背景脈絡」,正是此技能與筆記應用程式的差別所在。
  4. 以點子本身的語言書寫。 Frontmatter 鍵值與區段標題保持英文,但你書寫的所有內容——背景脈絡、核心判斷、擴展,以及你給使用者的確認——都必須使用使用者原始輸入的語言。中文的點子就得到中文的卡片;日文的點子就得到日文的卡片。絕不要為了系統方便而將使用者的思考翻譯成英文。
  5. 輕量確認。 結構化完成後,用 2–3 行回報卡片 ID 和你濃縮的核心判斷。不要要求使用者審閱整張卡片。

捕捉流程(使用者丟出一個點子)

  1. 檢查此點子是否延伸自現有的卡片:如果使用者提到先前的點子(「加到我的關於 X 的點子」)或者想法明顯是延續最近的卡片,則在該卡片的「原始內容」中附加一個時間戳條目,並更新該新增內容所影響的任何結構化區段——不要建立重複的卡片。
  2. 否則,建立一個新的卡片檔案,包含 frontmatter 和逐字的「原始內容」條目。逐字意味著:僅移除捕捉指令本身(「捕捉這個點子:」、「記下這個:」),保留其餘每個字——包括猶豫、情緒和錯字。狀態:inbox。
  3. 從對話上下文填寫結構化區段:背景脈絡、核心判斷、證據、擴展、內容形式、缺失資訊。如果你沒有內容可填入某區段,則留一個 HTML 註解佔位 (<!-- -->),而不是憑空編造。
  4. 將狀態設為 structured 並更新 updated。
  5. 搜尋整個點子池(在 <pool>/**/*.md 中執行 grep)尋找相關卡片;如果找到,將彼此的 ID 加入雙方的 related 列表。
  6. 同步,然後輕量確認。

如果使用者丟出一個片段,而你確實沒有任何上下文(例如會話剛開始):仍然先建立卡片,在「背景脈絡」中註明「context missing」,然後最多問一個問題。

檢視與重複使用流程

  • 「瀏覽我的收件匣」——列出 status: inbox 的卡片(最新優先,顯示 ID 加上原始內容的第一行),然後逐個與使用者一起進行結構化或歸檔。
  • 「找出我關於 X 的點子」——在整個點子池中進行 grep,讀取匹配的卡片,綜合使用者已得出的結論,並主動指出可以合併的卡片。
  • 「把這個轉換成一篇文章 / 文件 / 決策」——讀取相關卡片,根據「核心判斷」和「證據」(而非僅根據原始內容)進行草稿撰寫,並在輸出發布時將貢獻的卡片設為 published。
  • 連結——每當兩張卡片共享一個主題、案例或產品問題時,透過 related 進行交叉引用。

同步

如果 <pool>/.git 存在,則每次寫入後執行:

git -C <pool> add -A && git -C <pool> commit -m "capture: <一行摘要>" -q
git -C <pool> pull --rebase -q && git -C <pool> push -q

絕不因同步失敗而阻塞使用者——用一行文字提及此事,然後繼續。

相關技能