無料GitHub で公開日本語紹介

maintenance

肥大化したPlans.mdやsession-log.md、古いログ、stateファイルを整理・分割・アーカイブします。対象を指定して実行でき、dry-runでは変更内容を事前に確認できます。

原文原文の説明を見る

File cleanup and archiving. Tidies up bloated Plans.md, session-log.md, old logs, and state files. Trigger: /maintenance, cleanup, archive, organize, split session-log. Do NOT load for: implementation, review, release, new feature development.

Chachamaru127/claude-code-harnessスター 3,187(GitHub 3,187 + cccskills 0)

実行スコア未検証

インストール方法を見る

こんなときに便利

完了タスクをアーカイブしたいとき
長いsession-logを分割したいとき
古いログを整理したいとき
stateファイルを圧縮したいとき

日本語での紹介

できること

散らかった作業ファイルを整理するスキルです。Plans.mdの完了タスクをアーカイブへ移し、長くなったsession-log.mdを月別に分割し、古いログを削除したり、agent-trace.jsonlやharness-usage.jsonを整理したりします。対象をplans、session-log、logs、state、allから選べます。--dry-runを付けると、実際の変更をせずに予定する作業を確認できます。完了後は行数や削除件数を報告します。

こんなときに便利

計画ファイルに完了タスクがたまったとき、セッションログが長くなったとき、古いログやstateファイルを片付けたいときに向いています。定期的なファイル整理や、クリーンアップ警告を受けた後の整理案づくりにも使えます。

使い方の例

「Plans.mdの完了タスクを整理して」
「session-logを月別に分割して」
「30日以上前のログを削除する内容をdry-runで確認して」

注意点

Plans.mdを整理する前に、重要情報がSSOTへ同期済みか確認します。進行中のタスクはアーカイブ対象外です。アーカイブ先は.claude/memory/archive/に固定され、200行を超えるファイルの編集前にはローカルバックアップを作成します。CLAUDE.mdは自動編集せず、分割を提案します。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（2）

SKILL.md4.4 KB
references/cleanup.md9.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Maintenance

散らかったファイルを整頓する単一目的スキル。auto-cleanup-hook が警告を出した時、または定期的な家事として呼び出す。

前提: 破壊的操作（アーカイブ移動・行削除）の前に Plans.md / session-log.md の重要情報が SSOT (decisions.md / patterns.md) に昇格済みか確認する。未同期なら /memory sync を先に走らせる。

Quick Reference

サブコマンド	対象	典型トリガー
`maintenance plans`	Plans.md 完了タスクのアーカイブ移動	「Plans.md 整理」「古いタスクを移動」
`maintenance session-log`	session-log.md の月別分割	「session-log 分割」「ログが長い」
`maintenance logs`	`.claude/logs/` の古いファイル削除	「ログ掃除」「30日以上前のログ消して」
`maintenance state`	`agent-trace.jsonl` / `harness-usage.json` のトリム	「trace 肥大」「state 圧縮」
`maintenance all`	上記4つを順に実行	「全部整理」「総掃除」

--dry-run を付けると何をするかだけ列挙して実行しない。自由記述の指示（例: 「古いアーカイブも消して」「この session-log だけ残して」）は Step 1 で受け付けて Step 2 以降の処理パラメータに反映する。

実行手順

ユーザー指示のパース: サブコマンド + 自由記述（除外対象、保存先、日数閾値）を抽出
SSOT 同期チェック: .claude/state/.ssot-synced-this-session が無ければ /memory sync を促す（Plans.md を触る場合のみ必須）
参照ファイルを開く: ${CLAUDE_SKILL_DIR}/references/cleanup.md を読み対応セクションを実行
Before/After を報告: 行数と削除件数を表示して完了

サブコマンド詳細

対象ごとの実行手順・閾値・アーカイブ先は cleanup.md を参照。

auto-cleanup-hook との連携

PostToolUse hook (scripts/auto-cleanup-hook.sh / Go 版 auto_cleanup_hook.go) は Plans.md・session-log.md・CLAUDE.md の行数超過を検知すると /maintenance で古いタスクをアーカイブすることを推奨します と feedback を返す。警告を見たら対象と件数を読み取り、整理案を出す。警告そのものをアーカイブ移動や削除の承認として扱わない。明示された maintenance の対象と除外条件がある場合は、その範囲で既存の SSOT 同期と破壊的操作のゲートに従う。

注意事項

進行中タスクは動かさない: cc:WIP, pm:依頼中, cursor:依頼中 はアーカイブ対象外
アーカイブ先ディレクトリは固定: .claude/memory/archive/ — 別の場所に移すときはユーザーに確認する
バックアップ: 200 行超のファイルを編集する前に cp <file> <file>.bak.$(date +%s) でローカルバックアップを取る
CLAUDE.md は警告のみ: 自動編集しない。分割提案だけ出す

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

同じリポジトリのスキル