GitHub 仓库 · 记忆与上下文

working-memory — Claude Code 插件 · ClaudeMods

Name: working-memory
Author: Chen Hung-Lun

回报这个作品这是你的作品？认领

在 ClaudeMods 了解这款 Claude Code 插件，查看原始来源与所需权限。把 context window 畫成一顆腦：工具呼叫點亮對應腦區，用量越滿越擁擠，compact 時睡眠整理。

CChen Hung-Lun@klkh.dj.ai

已翻译

关于这个 mod

working-memory 是 learning-hacker-claude-mod 合集裡的其中一個 Claude Code mod（v0.1.0），以 /brain 在側邊 pane 畫出一顆側面的腦：額葉對應規劃（prompt、TaskCreate/TodoWrite、Skill）、運動皮質對應 Edit/Write、頂葉對應 Bash 等工具、枕葉對應 Read/Grep/Glob、顳葉對應 WebFetch/WebSearch/MCP 工具、小腦對應 Agent/SendMessage。context 用量越高，腦裡被 ░ 填滿的格子越多，超過 85% 會紅色閃爍；compact 時會有 ✦ 光波從後腦掃到前額表示睡眠整理。安裝需 Claude Code v2.1.287 以上，透過 marketplace Hangghost/learning-hacker-claude-mod 安裝。但 GitHub 掃描未成功（無法解析 ../types 匯入），且 hook 檔含 tool.call 工具攔截能力（level 2），需人工複核後再決定。

安装

请先查看作者 README 确认 marketplace 和插件名称；命令可能随仓库结构改变。

claude plugin marketplace add Hangghost/learning-hacker-claude-mod
claude plugin install working-memory

原文 / README

learning-hacker-claude-mod

Learning Hacker 的 Claude Code mods 合集。主題有兩個：把 agent 的運作畫成看得懂的東西，以及讓「同時開好幾個 Claude Code session 分工」這件事變順。

狀態：照現狀提供（as-is），作為示範與實用工具分享，不提供支援。

收錄的 mod

| mod | 做什麼 | 版本 | |---|---|---| | dispatch-board | 多個 session 分工時的派工看板：讀你寫的 mission 檔，顯示誰完成、誰在跑、誰在等你，狀態轉換時跳 toast | 0.1.0 | | handoff-runner | bg session 在 worktree 做完的分支，由你在面板按一顆按鈕快轉進 main，執行前檢查、執行後驗證 | 0.1.0 | | working-memory | 把 context window 畫成一顆腦：工具呼叫點亮對應腦區，用量越滿越擁擠，compact 時睡眠整理 | 0.1.0 |

每個 mod 都可以單獨安裝，不用全裝。

安裝

需要 Claude Code v2.1.287 以上（claude --version 確認）。

先加入 marketplace（一次就好）：

/plugin marketplace add Hangghost/learning-hacker-claude-mod

再挑想要的裝：

/plugin install dispatch-board@learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-mod
/plugin install working-memory@learning-hacker-claude-mod

在 shell 裡用 claude plugin marketplace add …、claude plugin install … 也可以。已開著的 session 執行 /reload-plugins 載入。

更新：第三方 marketplace 的自動更新預設關閉。可在 /plugin 的 Marketplaces 分頁對本 marketplace 選 Enable auto-update，或手動執行 /plugin marketplace update learning-hacker-claude-mod。

dispatch-board：多 session 派工看板

同時開幾個 session 各做一段工作時，你很難一眼看出誰做完了、誰卡住在等你。dispatch-board 讀你寫的 mission 檔，在提示框上方放一行摘要，/dispatch 打開完整面板。

mission 檔是一個 JSON：列出節點、負責的 session 名稱、完成條件（一條 shell 指令，結束碼 0 代表完成）
面板分成「需要你／跑著／做完待收斂」，完成條件跑不起來時顯示「無法判定」，不會被當成還在跑
session 狀態取自 claude agents --json
/dispatch demo 用假資料試看畫面

安全邊界：完成條件是 shell 指令，mod 會執行它，所以 mission 檔只從使用者層級的目錄讀（預設 ~/.claude/missions/），不讀任何專案目錄或 repo 內的檔案，也不接受專案設定改掉這個目錄。clone 一個陌生 repo 不會讓 mod 執行對方寫的指令。

mission 檔格式與範例見 plugins/dispatch-board/README.md。

handoff-runner：一鍵把 worktree 分支落地

背景 session 在自己的 worktree 做完一條分支後，要併進 main，但 main 正被你的主 checkout 持有，背景 session 動不了它。handoff-runner 讓 session 簽發一張「交接單」，你在 /handoff 面板看過步驟後按「執行」，由 mod 完成 fast-forward。

Claude 可以呼叫工具 handoff_issue 簽發交接單，也可以用 /handoff issue <branch> [target] 手動簽發
交接單放在 <git common dir>/handoffs/，在 .git 裡面，不會被 commit
執行前檢查：分支沒有前進、目標可以 fast-forward、持有目標分支的 worktree 在落地路徑上沒有未提交的修改
執行後驗證：目標分支確實前進到該 commit
預設不 push，可在設定開啟

安全邊界：交接單只帶參數（分支、目標、釘住的 commit），不帶任何指令。要執行的 git 步驟由 mod 依參數產生，執行前比對「畫面上顯示的步驟」與「實際要跑的步驟」完全一致，並只允許 fast-forward、帶預期舊值的 ref 更新、非強制的 push。偽造的交接單最多只能讓自己從面板消失，不能讓 mod 執行別的指令。

細節見 plugins/handoff-runner/README.md。

working-memory：把 context 畫成一顆腦

/brain 在側邊開一個 pane，畫出一顆側面的腦（左邊是前額）。

| 腦區 | 比喻 | 什麼時候亮 | |---|---|---| | 額葉 | 規劃 | 送出 prompt、TaskCreate／TodoWrite、Skill | | 運動皮質 | 動手改 | Edit、Write | | 頂葉 | 操作環境 | Bash 與其他工具 | | 枕葉 | 閱讀 | Read、Grep、Glob | | 顳葉 | 聽外界 | WebFetch、WebSearch、MCP 工具 | | 小腦 | 分身協作 | Agent、SendMessage |

context 用量越高，腦裡被 ░ 填滿的格子越多；超過 85% 會紅色閃爍
compact 時，一道 ✦ 光波從後腦掃到前額，代表「睡眠整理記憶」

腦區對應是比喻，不是神經科學主張。

安裝前看看它會做什麼

mod 不在沙盒裡執行，會以你的權限跑在 Claude Code 內。建議安裝前先讀原始碼，或 clone 後執行 claude plugin validate ./plugins/<名稱>，看它處理哪些事件、呼叫哪些能力。以下是 v0.1.0 的結果：

dispatch-board

hooks: session.start, command.run{command=dispatch}, ui.close, ui.render{component=AbovePrompt},
       ui.render{component=Pane, requestId=dispatch-board}
calls: $.clock.every, $.clock.now, $.command.register, $.env.get, $.fs.exists, $.fs.list, $.fs.read,
       $.fs.stat, $.process.run, $.session.cwd, $.session.root, $.settings.read, $.state.get,
       $.state.set, $.ui.close, $.ui.copy, $.ui.open, $.ui.resolve, $.ui.toast

$.process.run 只用來跑你 mission 檔裡的完成條件（/bin/sh -c，每條 5 秒逾時）和 claude agents --json；檔案只讀不寫；不連網、不呼叫模型、不送 prompt。

handoff-runner

hooks: session.start, tool.call{tool=mcp__handoff-runner__handoff_issue}, command.run{command=handoff},
       ui.close, ui.render{component=AbovePrompt}, ui.render{component=Pane, requestId=handoff-runner}
calls: $.clock.every, $.command.register, $.fs.list, $.fs.read, $.fs.write, $.process.run,
       $.session.cwd, $.state.get, $.state.set, $.tool.register, $.ui.close, $.ui.open,
       $.ui.resolve, $.ui.toast

檔案只讀寫 <git common dir>/handoffs/ 底下；$.process.run 只跑唯讀的 git 檢查、交接單的鎖，以及你按下「執行」後的落地步驟；只有開啟 push 時才連網；不呼叫模型、不送 prompt。

working-memory

hooks: session.start, command.run{command=brain}, prompt.submit, tool.call,
       session.measure, session.compact, ui.render{component=Pane, requestId=working-memory}
calls: $.clock.every, $.command.register, $.session.usage, $.state.get, $.state.set,
       $.ui.open, $.ui.resolve

只讀工具呼叫的名稱與參數摘要來畫圖，不讀寫檔案、不啟動程式、不連網、不呼叫模型。

開發

claude --plugin-dir ./plugins/<名稱>   # 單次載入
claude plugin test ./plugins/<名稱>     # 跑測試

handoff-runner 另有兩支需要 Node 23.6 以上的測試：node plugins/handoff-runner/tests/real-git.mjs（在暫存 repo 上用真的 git 落地）與 node plugins/handoff-runner/tests/boundary.mjs（檢查執行入口只有一個）。

各 plugin 的 tsconfig.json 依賴 .claude-plugin/types/，那是 Claude Code 產生的型別檔，不放進 repo。

English

A collection of Claude Code mods by Learning Hacker. Shared as-is, without support. Each mod installs on its own.

/plugin marketplace add Hangghost/learning-hacker-claude-mod
/plugin install dispatch-board@learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-mod
/plugin install working-memory@learning-hacker-claude-mod

Requires Claude Code v2.1.287+.

dispatch-board: a board for running several Claude Code sessions in parallel. Reads mission files you write (nodes, the session responsible, a shell command that exits 0 when done) and shows who is done, who is running and who is waiting on you. Mission files are read only from a user-level directory (default ~/.claude/missions/), never from a project, so cloning a repo cannot make it run someone else's commands.
handoff-runner: lets a background session that finished a branch in its own worktree issue a handoff ticket, which you land into main with one button. Tickets carry only parameters (branch, target, pinned commit); the git steps are derived by the mod, checked before running and verified after. Push is off by default.
working-memory: draws your context window as a brain. Tool calls light up regions, the brain fills up as context grows, and compaction plays a "sleep" sweep.

License

MIT

Showcase: 【實用工具】Claude Mod 真的是太好用了！因為 Claude Mod 可以解決「派工 skill」的一個大痛點！

之前的「派工 skill」可以在一個「主對話」規劃任務後，派出多個「子對話」去工作，最後再回報結果整合回「主對話」。

但是會遇到需要頻繁到主畫面查看「子對話」進度甚至有指令被 guard 擋住，或是有問題要回答時還要切進「子對話」處理。 ❗這樣的操作其實認知負荷很重，常常切進去要回想才能繼續回答

所以我用 Claude Mod 做了一個「派工儀表板」dispatch mod ❇️ 可以在主對話看到所有子對話的運行狀況 ❇️ 所以可以不用切來切去就可以知道所有狀況了～而且是「依照派工任務分類」的（Claude Code 目前無法自動分類）！！！

另外一件事就是常常有一些收尾動作容易被 guard 擋下比如說 git push, git merge 等操作，也要切進子任務下指令。所以我也做了一個 handoff mod ❇️ 可以直接在主對話審核通過後，直接背景執行相關指令 ❇️

現在可以專心在「主對話」討論策略和規劃之後的實作計劃了～ Dispatch / Handoff mods; repo in author reply

查看原始来源 ↗