claudeers.
// Claude Plugins

learning-hacker-claude-mod

Learning Hacker 的 Claude Code mods:把 agent 的運作畫成看得懂的東西

// Claude Plugins[ cli ][ claude ]#claude#plugins◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
94/100
last commit about 1 month ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up learning-hacker-claude-mod (claude-plugin project) into my current project.
Found on https://claudeers.com/learning-hacker-claude-mod
Repo: https://github.com/Hangghost/learning-hacker-claude-mod
Homepage/docs: —
Detected install method: claude-plugin → /plugin install learning-hacker-claude-mod@Hangghost/learning-hacker-claude-mod
Category: plugins. Platforms: cli.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add Hangghost/learning-hacker-claude-mod
/plugin install learning-hacker-claude-mod@Hangghost/learning-hacker-claude-mod
// or clone
git clone https://github.com/Hangghost/learning-hacker-claude-mod

// compatibility

Platformscli
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

learning-hacker-claude-mod

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

狀態:照現狀提供(as-is),作為示範與實用工具分享,不提供支援。

收錄的 mod

mod做什麼版本
dispatch-board多個 session 分工時的派工看板:讀你寫的 mission 檔,顯示誰完成、誰在跑、誰在等你,狀態轉換時跳 toast0.1.0
dispatch-relaydispatch-board 的搭檔:worker 把回報寫進結果檔後以一行結束,由 mod 在 turn 結束時轉送給指揮站0.1.0
handoff-runnerbg 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 dispatch-relay@learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-mod
/plugin install working-memory@learning-hacker-claude-mod

dispatch-relay 需要 v2.1.289 以上。

在 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。

dispatch-relay:worker 的回報自動送到指揮站

分工時 worker 做完要自己 SendMessage 把回報全文送給指揮站,同一份回報等於生成兩次,送完還要多跑一次收尾。dispatch-relay 裝在 worker 那一側:worker 把回報寫進結果檔、以一行結束 turn,mod 在 turn 結束時把新增的內容和最終回覆原文送給指揮站。

  • 在 dispatch-board 的 mission 檔加上 station(指揮站的 session 名稱)才啟用;沒寫的 mission 不受影響
  • 身份判定:本 session 的 id → claude agents --json 查出名稱 → mission 檔裡恰好一個節點指派給這個名稱才啟用
  • 只送有變更的內容(追加時只送追加段);送不到時請 worker 自己 SendMessage,同一份內容只請一次

前提:指揮站與 worker 都要用 --name 開,名稱與 claude agents 一致;新目錄第一次 claude --bg 前先在該目錄跑一次 claude 接受信任(否則回 Workspace not trusted…);用 --worktree <名> 開的 worker,result_file 相對的是 <repo>/.claude/worktrees/<名>。自訂 mission 目錄只要在 dispatch-board 設一次,relay 會沿用。

安全邊界:mod 會把檔案內容送到另一個 session。它只送對到的節點的結果檔(必須在 worker 的專案根目錄底下,解析符號連結後也一樣)與最終回覆,只送給名冊上恰好一筆對到 station 的 session;mission 檔的讀取規則與 dispatch-board 相同。tool.check 只放行它自己發出的送件。

細節見 plugins/dispatch-relay/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。

dispatch-relay

hooks: session.start, prompt.submit, prompt.compose, turn.start, tool.call{tool=SendMessage},
       session.send, tool.check{tool=SendMessage}, turn.complete
calls: $.env.get, $.fs.exists, $.fs.list, $.fs.read, $.fs.stat, $.process.run, $.prompt.submit,
       $.session.cwd, $.session.id, $.session.root, $.session.send, $.settings.read,
       $.store.delete, $.store.get, $.store.set, $.ui.log

$.process.run 只跑 claude agents --json;$.session.send 只送給 mission 檔 station 對到的那一個 session;$.prompt.submit 只在送不到時請 worker 自己送;檔案只讀不寫;不連網、不呼叫模型。

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 dispatch-relay@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-relay: v2.1.289+).

  • 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.
  • dispatch-relay: the worker-side companion to dispatch-board. A worker writes its report to a result file and ends the turn with one line; the mod forwards what changed, plus the final reply, to the commanding session named by the mission's station field (opt-in per mission). It sends only the matched node's result file, kept inside the worker's project root, and only to the one roster session matching station.
  • 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

// faq

What is learning-hacker-claude-mod?

Learning Hacker 的 Claude Code mods:把 agent 的運作畫成看得懂的東西. It is open-source on GitHub.

Is learning-hacker-claude-mod free to use?

learning-hacker-claude-mod is open-source under the MIT license, so it is free to use.

What category does learning-hacker-claude-mod belong to?

learning-hacker-claude-mod is listed under plugins in the Claudeers registry of Claude-compatible tools.

19 views
★ 14 stars
unclaimed
updated about 1 month ago

// embed badge

learning-hacker-claude-mod on Claudeers
[![Claudeers](https://claudeers.com/api/badge/learning-hacker-claude-mod.svg)](https://claudeers.com/learning-hacker-claude-mod)

// retro hit counter

learning-hacker-claude-mod hit counter
[![Hits](https://claudeers.com/api/counter/learning-hacker-claude-mod.svg)](https://claudeers.com/learning-hacker-claude-mod)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how learning-hacker-claude-mod connects across the ecosystem