repo-cleanup について
コード、依存関係、ドキュメント、テスト、スプリント成果物を安全に整理するスキルです。利用状況の確認、ロールバック手段の確保、変更検証を重視します。
主な機能
- 01範囲と安全モードの定義
- 02ベースラインと復元ポイントの記録
- 03削除前の利用状況確認
- 04テストとビルドによる検証
- 05スプリント成果物のアーカイブ
活用シーン
- 01生成ファイルやキャッシュの整理
- 02未使用コードや依存関係の調査
- 03古いドキュメントの更新
- 04スプリント終了時の成果物整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/repo-cleanupを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/archive-sprint.mdcode-cleanup.mddeps-cleanup.mddocs-cleanup.mdtest-cleanup.md詳細
リポジトリのクリーンアップ
概要
コード、依存関係、ドキュメント、テスト、スプリント成果物を安全かつ繰り返し実施できる方法でクリーンアップします。使用状況を確認し、削除前にアーカイブし、テストで検証することでリスクを最小限に抑えます。
使用する場面
- リポジトリが肥大化している（生成物、キャッシュ、未使用ファイルなど）
- デッドコードや未使用の依存関係が疑われる
- ドキュメントが実際の動作と乖離している
- テストが不安定、冗長、または不適切な場所に配置されている
- スプリントの完了に、体系的なアーカイブが必要
次の場合は避けてください。
- インシデント対応が進行中
- 対象領域の担当者やロールバック手段がない
クイックリファレンス
| タスク | 参照ファイルを読み込む |
|---|---|
| コードのクリーンアップ | skills/repo-cleanup/references/code-cleanup.md |
| 依存関係のクリーンアップ | skills/repo-cleanup/references/deps-cleanup.md |
| ドキュメントのクリーンアップ | skills/repo-cleanup/references/docs-cleanup.md |
| テストのクリーンアップ | skills/repo-cleanup/references/test-cleanup.md |
| スプリントのアーカイブ | skills/repo-cleanup/references/archive-sprint.md |
ワークフロー
- 範囲と安全モード（安全優先または積極的）を定義します。
- ベースライン状態を記録します（git status、主要なテスト、バックアップ）。
- 対象領域に該当する参照ファイルを読み込みます。
- 削除前に使用状況を確認しながら、クリーンアップの手順を実行します。
- 変更を検証します（テスト、ビルド、lint、またはドキュメントのチェック）。
- 結果を報告します（実施内容、リスク、今後の対応）。
出力
- 実施内容と変更したファイルの概要
- 検証結果と残っているリスク
- 今後の推奨事項またはバックログ項目
よくある間違い
- 使用状況や再生成可能性を確認せずに削除する
- ベースラインテストやロールバック用チェックポイントを省略する
- ビルド／テストスクリプトを更新せずに依存関係を削除する
- 入口となるページを残さずにドキュメントを統合する
コメント
Markdown 対応