Community程式設計與開發github.com

aurumiles/Skill

將記憶/原始資料/中的內容轉換為記憶/維基/中可供查閱的頁面。當使用者表示有東西放在原始資料、丟入 PDF 或逐字稿,或說「收下這個」、「讀這個」、「放進記憶」時使用。

Skill 是什麼?

此技能會將原始資料(筆記、PDF、逐字稿、URL 等)轉換為結構化、可連結的維基頁面,儲存在 `memoria/wiki/` 中,同時嚴格保護 `memoria/grezzo/` 中的原始檔案。它支援多種檔案格式(Markdown、PDF、CSV、JSON),並為音訊/影片提供明確指引(要求使用者先提供逐字稿)。技能會將內容拆分成專注、簡短、可連結的頁面;每個頁面必須引用其原始來源,用 `[[page-name]]` 語法連結到其他頁面,並在 `index.md` 中建立索引、記錄變更於 `log.md`。當新資訊與舊資訊衝突時,它不會覆蓋,而是會記錄變更與生效日期。這個技能可與 Claude、Codex、Cursor 等 AI 工具搭配使用,管理活的、可查證的知識庫。其核心原則是永不修改原始檔案,確保長期可查證性——當使用者或 AI 需要檢查某個陳述時,可以回溯到未經修改的來源。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aurumiles/Skill/tree/HEAD/ingest

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

/ingest

拿一件原始資料,把它變成可查閱的知識。這是讓記憶成長、而非讓它堆積的操作。

不可動搖的規則:原始資料絕不能修改。 你不重寫、不重新命名、不重新排序,即使它看起來很糟或重複也不刪除。六個月後,當維基的某個頁面看起來有問題時,唯一能驗證它的方法就是回去看原始來源。如果你動過了來源,就再也沒有東西可以回頭查了。

你的工作順序

1. 找到東西

查看 memoria/grezzo/。如果使用者指定了某個檔案,就用那個。如果沒指定,就取那些尚未出現在 memoria/wiki/index.md 中的檔案。

如果 grezzo/ 裡沒有任何東西,就告訴使用者並停下來:「原始資料是空的。丟點東西進來,再叫我。」

2. 讀取它

類型方法
.md, .txt, .csv, .jsonRead
.pdfRead 可以直接讀取 PDF
網址WebFetch
音訊、影片需要逐字稿:請使用者把逐字稿放到原始資料中,不要試圖從檔名猜測內容

如果某個格式你無法開啟,直接說出來,然後繼續處理下一個。不要假裝已經讀取,也不要根據標題摘要檔案。

3. 撰寫頁面

一個來源會變成 一或多個頁面放在 memoria/wiki/ 中,而不是單一份摘要。每個主題一篇頁面:客戶、概念、決策、流程。

頁面應該要:

  • 簡短:如果超過一個畫面,就拆成兩頁
  • 自包含:不需閱讀來源就能理解
  • 連結:在句子中以 [[檔案名稱]] 提及其他頁面,而不是在頁尾列清單
  • 頂端標示來源:來自哪個原始檔案,以便查證

檔案名稱是撐起一切的規則。 頁面以它的主題命名,全小寫並用連字號:客戶 Rossi Srl 的頁面是 rossi-srl.md,而你在任何地方提到它時,都寫 [[rossi-srl]]。連結永遠是檔案名稱去掉 .md。這樣一來,點擊連結就是開啟那個檔案,不需要猜測,這讓你可以在記憶中從一個頁面跳到另一個頁面。如果連結和檔案名稱對不上,跳轉就會失效。

以下是 rossi-srl.md 頁面的範例:

---
fonte: memoria/grezzo/call-rossi-2026-03-14.md
data: 2026-03-14
---

Rossi Srl 付款週期為 28 天,且向來準時。在三月 [[marco]] 的通話中,他要求將開帳時間改為月底,因為他們的採購部門在 30 號結算週期。此事也影響到 [[fatturazione]]。

如果某個主題的頁面已經存在,就更新它,不要建立第二個。關於同一個客戶的兩個頁面,是維基不再有用的開始。

如果新的來源與舊的資訊衝突,不要刪除舊的:寫下它改變了,以及從何時開始改變。 「三月時付款週期為 28 天,從七月起改為 60 天」比只重寫「60」更有價值,因為變化本身就是資訊:下次這個客戶逾期時,你就會知道那是異常還是它們的新常態。標記矛盾是記憶有用的一半原因。

4. 更新索引和記錄

總是在同一次操作中完成。

memoria/wiki/index.md:每個頁面一行,附上連結。不在索引中的頁面,沒有人能找到。

memoria/wiki/log.md:在頂端新增一筆記錄。

## [2026-03-14 16:20] ingest | Trascrizione call Rossi del 14 marzo
Tre pagine: [[rossi-srl]] (nuova), [[fatturazione]] e [[marco]] (aggiornate).

第一行的格式 ## [日期] 類型 | 標題 不是為了好看:它讓你可以用一個指令 (grep "^## \[" memoria/wiki/log.md) 就能輕鬆讀取記錄,就算以後累積到上百筆也一樣。

5. 報告你做了什麼

三行。你讀了什麼,你動了多少頁面,以及一件你學到且之前不存在的事。最後一項是讓使用者明白這件事真的有用的關鍵。

不該犯的錯誤

錯誤為什麼是錯誤
修改或重新命名原始檔案你失去了唯一可查證的東西
把所有東西塞進一個頁面無法重複使用、無法連結、無法更新
頁面沒有 [[連結]]變成檔案夾,不是記憶
連結與檔案名稱不符點擊連結變成猜測,導航失效
用新資料覆蓋舊資料,卻不說明它改變了你失去了變化這個資訊
摘要一個你無法開啟的檔案看起來是真的,實際上是編造的
寫了頁面卻忘記更新 index.md頁面等於白寫
對已經有頁面的主題新增第二個頁面從此兩個頁面都不可靠

Individual skills in this repo

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

aurumiles/Skill

SKILL CAROSELLI CANVA — Crea un carosello Instagram per @aurumiles dentro Canva (create-design / copy-design di #8), stile deciso con Davide il 24-25 set 2026: font Anton/Roboto/OpenSauce, oro su nero, una foto vera di Davide solo in copertina. Usala SOLO quando Davide chiede esplicitamente «in Canva» o di clonare/adattare un carosello già fatto in Canva. Per i caroselli nello stile delle lezioni (rosso su nero, Oswald, fatti qui da Claude) usa la skill `caroselli-claude`.

aurumiles/Skill

SKILL CAROSELLI CLAUDE — Crea un carosello Instagram per @aurumiles direttamente qui, senza Canva, nello stile delle slide della Lezione 1 (nero, Oswald corsivo + Inter, accento rosso o altro colore, foto vere ritagliate dagli originali, poco testo, 1080x1350). Usala quando Davide chiede un nuovo carosello senza specificare Canva, o dice «fammelo come le slide della lezione». Per i caroselli in Canva usa `caroselli-canva`.

aurumiles/Skill

Chiude una sessione di lavoro scrivendo su disco un file di passaggio (handoff) che la sessione successiva legge per ripartire esattamente da dove eravamo, al posto di /compact. Usala quando l'utente scrive /handoff, o quando dice frasi come "salvami il punto", "prepara la ripresa per domani", "chiudiamo qui", "riprendiamo domani".

aurumiles/Skill

Risponde a una domanda leggendo la memoria, e offre di rimettere dentro la risposta come pagina nuova. Usala quando l'utente chiede "cosa sappiamo di X", "fammi un'analisi di X", "confronta X e Y", o qualsiasi domanda che richieda di mettere insieme più cose che sa già.

相關技能