Skills
cortex-broadcast auto
觸發:一個 Raw 已 distill 後,要把它融合進相關既有頁面(「broadcast」「compound this into the vault」),或 distill 流程末段自動 dispatch。
llm-wiki style broadcast ingest — conversational update of related existing pages when a Raw has been distilled. Use when the user says "broadcast", "跑 broadcast", "compound this into the vault", "merge pending-merge", "process broadcast queue", or when cortex-distill invokes broadcast inline after Step 8 commit (automatic dispatch for every new / pending-merge Raw).
broadcastprocess broadcast queue
cortex-distill auto
觸發:使用者要把 Raw session 記錄提煉成 Notes/Projects(「提煉」「整理 raw」「distill」)。
Distill raw session records into refined Notes and Projects. Use when the user says "提煉", "整理 raw", "distill", or "distill raw records".
提煉這週的 rawdistill raw records
cortex-evolve auto
觸發:使用者要把知識存進 vault(「存到 cortex」「記一下」),或 session-suggest hook 建議存檔時。
Save knowledge to the cortex vault. Use when the user says "存到 cortex", "記一下", "save to cortex", "記到筆記", "cortex evolve", or when the session-suggest hook recommends saving content. Handles Notes and Projects.
存到 cortex記一下這個決策save to cortex
cortex-query auto
觸發:使用者要查 vault(「查 cortex」「之前有記過」),或回答任何關於既有專案/內部工具的問題「前」,主動先搜尋。
Search and retrieve content from the cortex vault — the user's external memory. Use (1) when the user says "查 cortex", "之前有記過", "cortex 裡有沒有", "check my notes", "what did I write about", AND (2) PROACTIVELY — before answering any non-trivial question about ongoing projects, internal company tooling, cortex-vec, plugin development, NAS debugging, DSM workflows, or any topic that resembles prior work the user might have notes on. When the SessionStart hook lists vault topics and the user's request matches one, search cortex BEFORE asking clarifying questions or guessing. Treat the vault as authoritative prior context: searching it cheaply is always better than reinventing an answer the user already wrote down.
查 cortex 有沒有 DSM 相關筆記之前有記過這個嗎what did I write about cortex-vec
cortex-takeoff auto
觸發:context 快滿要交接給下個 session(「交接」「takeoff」「交棒」)。產出不進 git、不索引的暫時 hand-off baton。
Create or resume a session takeoff baton — a curated, ephemeral, git-ignored hand-off note that lets the next Claude session continue a long-running task. Use when the user says "交接", "takeoff", "交棒", "context 快滿了交接給下個 session", "hand off to next session", "/cortex:takeoff", "takeoff resume", or "takeoff done". The baton is scaffolding, not knowledge: it is never committed, distilled, broadcast, or indexed.
交接給下個 sessiontakeoff resumetakeoff done
using-cortex auto
觸發:session 開始或每個非瑣碎請求時無條件觸發 — 在猜測、追問或重新探索「前」,先確認 vault 是否已有相關記憶。
Use when starting any task or answering any non-trivial question in a cortex-enabled session — establishes that the cortex vault is the user's external memory and should be consulted BEFORE guessing, asking clarifying questions, or doing fresh exploration. Trigger unconditionally on conversation start, on every new user request that touches a domain the user has worked on before, and whenever the request mentions an ongoing project, internal company tooling, recurring topic, or anything that smells like prior work. If the SessionStart hook surfaced vault topics and the request matches one — search first.
(session 開始自動觸發)
Commands
/cortex:broadcast
Run broadcast on a distilled Raw — update related existing pages conversationally
/cortex:broadcast --list
/cortex:distill
Distill raw session records into refined Notes and Projects
/cortex:distill this week/cortex:distill 2026-06-30
/cortex:evolve
Save knowledge to the cortex vault (Notes or Projects) and update index
/cortex:evolve
/cortex:genesis
Initialize cortex vault — set up config, vault structure, and rebuild index
/cortex:genesis /synosrc/misc/cortex/cortex:genesis ~/cortex
/cortex:takeoff
Create, resume, or clear a session hand-off baton for this repo
/cortex:takeoff/cortex:takeoff resume/cortex:takeoff done
Hooks
- SessionEnd — session 結束時自動產出完整報告(commits、發現、決策)並存進 vault 的 Raw/,是自動記錄的入口。
- SessionStart — 開 session 時偵測當前 repo,把相關 vault 記憶注入 context,讓 Claude 一開始就有既有背景。
Tips
- 回答關於既有專案或內部工具的問題前,讓 cortex-query 先搜尋 vault — 比重新探索或追問便宜得多。
- distill 完成後會自動 dispatch broadcast,把新知識融進既有頁面;不必手動再跑一次。
- Vault 是 source of truth(markdown + git),vector store 可隨時用 /cortex:genesis 重建索引。
Traps
- takeoff baton 是暫時 scaffolding:它「不會」被 commit、distill、broadcast 或索引 — 別把長期知識只寫在 baton 裡。
- 語意搜尋需要 OPENAI_API_KEY 與已安裝的 cortex-vec CLI;缺任一則 cortex-query 無法檢索。