miyabi-satoh/yorozuya/tree/main/.agents/skills/cleanup/mod
關於這個 mod
Yorozuya
給 Claude Code 使用的 skill 集合。
這些 skill 寫成由 Claude 當下判斷並執行的步驟,而不是按固定順序執行命令的腳本。只有 restart-sessions 帶有腳本,而且腳本只處理無法回復的連鎖操作,以及監看、擷取對話記錄等唯讀工作。實際執行的命令會隨 Claude Code 版本、權限設定、CLAUDE.md 等因素變化。遇到問題時,可以當場補充指示,或讓 Claude 進行調查。
要使用某個 skill,把 .agents/skills/<skill>/ 放入使用它的專案 skill 目錄(Claude Code 使用 .claude/skills/)。建立指向 clone 位置的 symlink,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)。
Skills
| skill | 功能 | 需求與實機確認 |
| --- | --- | --- |
| restart-sessions | 在 Herdr 上重新啟動工作階段,同時承接對話記錄。在設定了 SessionStart hook 的專案中啟動時,它會監看內容使用率,並在需要通知的工作階段自動重新啟動,不需確認 | Herdr。監看需要能顯示使用率的 status line 和 config.local.json。實機確認:macOS、Windows 11 |
| weekly-pace | 估算 Claude 和 Codex 的每週額度使用速度。Claude 使用速度較高而 restart-sessions 重新啟動工作階段時,會附帶把工作交給 Codex 的說明 | Claude 側需要 Herdr 和能顯示 Weekly 的 status line;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 disk-watch
原文 / 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 にある。
