maintenance
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
- ソースの最終更新活動
- 2026年9月6日 02:09
- 検出された SKILL.md の言語
- 日本語
- スター
- 3,159
- フォーク
- 301
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
ファイルエクスプローラー
2 ファイルSKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- maintenance
- description
- 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.
- description-en
- 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.
- description-ja
- ファイル整理・アーカイブ・ログ圧縮を担当。散らかった Plans.md / session-log.md / 古いログ / state ファイルを整頓する。`/maintenance`, メンテ, 整理して, アーカイブして, 古いタスク移動, session-log 分割, ログ掃除 で起動。実装・レビュー・リリース・新機能開発には使わない。
- allowed-tools
- ["Read","Write","Edit","Grep","Glob","Bash"]
- argument-hint
- [plans|session-log|logs|state|all] [--dry-run]
- user-invocable
- true
- effort
- low
# 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 以降の処理パラメータに反映する。
## 実行手順
1. **ユーザー指示のパース**: サブコマンド + 自由記述（除外対象、保存先、日数閾値）を抽出
2. **SSOT 同期チェック**: `.claude/state/.ssot-synced-this-session` が無ければ
`/memory sync` を促す（Plans.md を触る場合のみ必須）
3. **参照ファイルを開く**: `${CLAUDE_SKILL_DIR}/references/cleanup.md` を読み対応セクションを実行
4. **Before/After を報告**: 行数と削除件数を表示して完了
## サブコマンド詳細
対象ごとの実行手順・閾値・アーカイブ先は [cleanup.md](./references/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 は警告のみ**: 自動編集しない。分割提案だけ出す
## 関連スキル
- `memory` — Plans.md 整理前の SSOT 昇格（decisions.md / patterns.md 更新）
- `harness-setup` — セットアップ直後の定期メンテは `harness-setup` 経由でも呼べる
- `session-init` — セッション開始時のメンテ推奨通知を制御
GitHubで見る