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 にある。
