miyabi-satoh/yorozuya/tree/main/.agents/skills/heavy-task/mod
heavy-wait
guard-heavy-commands 的 hook 會持續測量因 CPU 緊繃而暫停的繁重工作,等資源空出後通知工作階段。
關於這個 mod
Yorozuya
存放供 Claude Code 使用的 skill。
skill 寫成由 Claude 當場判斷並推進的步驟,而不是依固定順序執行命令的程式(只有 restart-sessions 帶有程式,而且只處理不可回復的連鎖操作,以及監看、擷取對話記錄等唯讀工作)。實際執行的命令會隨 Claude Code 版本、權限設定、CLAUDE.md 等變化。遇到不順利的情況,就在當場補充指示,或讓它查明原因。
使用時,把 .agents/skills/<skill>/ 放進使用方專案的 skill 目錄(Claude Code 是 .claude/skills/)。把它連結到 clone 出來的目錄,就能讓 pull 下來的更新直接生效。若是複製過去的,請把 restart-sessions 的 config.local.json 加進使用方的 .gitignore(本儲存庫的 .gitignore 不會生效)。載入 mod(mod/)後,restart-sessions 的工作階段內容監看器會讓每個工作階段監看自己。不使用 mod、改由外部監看時,在使用方的 .claude/settings.json 放置 SessionStart hook(restart-sessions 的 README)。heavy-task 的 hook 也放在 settings.json 中(heavy-task 的 README)。
skill 清單
| skill | 能做什麼 | 所需內容與實機驗證 |
| --- | --- | --- |
| restart-sessions | 在 Herdr 上重新啟動工作階段,並接續對話記錄。在設有 SessionStart hook 的專案中啟動時,它會監看內容使用率,並在工作階段發出通知後不需確認就重新啟動 | Herdr。監看需要能顯示使用率的提示列和 config.local.json。已在 macOS、Windows 11 上實機驗證 |
| weekly-pace | 粗略估算 Claude 和 Codex 的每週額度使用速度。restart-sessions 會用它補充說明:Claude 使用速度較快時,應把重新啟動後的工作交給 Codex | Claude 端需要 Herdr 和顯示 Weekly 的提示列;Codex 端需要 codex CLI |
| heavy-task | 開始繁重工作前測量 CPU 和記憶體,決定開始或等待。CPU 緊繃時,hook 會攔下繁重命令;資源空出後,mod 會通知工作階段 | 使用方的 .claude/heavy-commands.json,用來寫明哪些操作算繁重工作。hook 和 mod 用於 Claude Code(mod 使用 2.1.289 的 function hooks)。僅在 macOS 上實機驗證 |
| cleanup | 調查磁碟垃圾候選並產生報告,只刪除選取的項目。mod 會監看可用空間,空間跌破門檻後讓每個工作階段清理自己的儲存庫 | 只有 Windows 完成過刪除流程。mod 用於 Claude Code,僅在 macOS 上實機驗證 |
| machine-setup | 在新機器上安裝應用程式和工具,並匯入設定檔 | Claude Code。僅在 Ubuntu(Docker)上完整跑通 |
每個 skill 的前提、機制和使用方式都在連結的 README 中。修改 skill 的規則見 AGENTS.md。
安裝
請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。
claude plugin marketplace add miyabi-satoh/yorozuya claude plugin install heavy-wait
原文 / README
Yorozuya
Claude Code に持たせる skill の置き場。
skill は、決まったコマンドを順に叩くスクリプトではなく、Claude がその場で判断して進める手順として書いている(スクリプトを持つのは restart-sessions で、後戻りできない連鎖と、読むだけの処理(見張り・会話ログの抜き出し)にとどめている)。実際に打つコマンドは、Claude Code のバージョン・権限の設定・CLAUDE.md などで変わる。うまくいかないときは、その場で指示を足すか調べさせる。
使うには、.agents/skills/<skill>/ を使う側のプロジェクトの skill ディレクトリ(Claude Code なら .claude/skills/)に置く。clone した先への symlink にすると、pull した更新がそのまま届く。写したなら、restart-sessions の config.local.json を使う側の .gitignore に足す(このリポジトリの .gitignore は効かない)。restart-sessions のコンテキストの見張りは、mod(mod/)を読み込ませれば各セッションが自分を見張る。mod を使わずに外から見張るなら、使う側の .claude/settings.json に SessionStart の hook を置く(restart-sessions の README)。heavy-task の hook も settings.json に置く(heavy-task の README)。
skill 一覧
| skill | できること | 要るもの・実機確認 |
| --- | --- | --- |
| restart-sessions | Herdr 上のセッションを、会話ログを引き継いで再起動する。SessionStart の hook を置いたプロジェクトで起動すると、コンテキストの使用率を見張り、知らせの出たセッションを確認なしで再起動する | Herdr。見張りには、使用率を出すステータスラインと config.local.json。実機確認は macOS・Windows 11 |
| weekly-pace | Claude と Codex の週次枠の使用ペースを概算する。restart-sessions が、Claude がハイペースのとき再起動した先に Codex へ作業を回すよう書き添えるのに使う | Claude 側は Herdr と、Weekly を出すステータスライン。Codex 側は codex CLI |
| heavy-task | 重い処理を始める前に CPU とメモリを測り、始めるか待つかを決める。hook が CPU の厳しいときに重いコマンドを止め、mod が空いたらセッションに知らせる | 何が重いかを書く、使う側の .claude/heavy-commands.json。hook と mod は Claude Code 用(mod は 2.1.289 の function hooks)。実機確認は macOS のみ |
| cleanup | ディスクのゴミの候補を調べてレポートし、選んだものだけ消す。mod が空きを見張り、ラインを切ったら各セッションに自分のリポジトリを片付けさせる | 削除まで通したのは Windows のみ。mod は Claude Code 用で、実機確認は macOS のみ |
| machine-setup | 新しいマシンにアプリ・ツールを入れ、設定ファイルを取り込む | Claude Code。最後まで通したのは Ubuntu(Docker)のみ |
各 skill の前提・仕組み・使い方は、リンク先の README にある。skill に手を入れるときの決まりは AGENTS.md にある。
