mcpField
P
project-workspace-cleaner

project-workspace-cleaner

github.com/gaelic-ghost開発160 回インストール
リポジトリ

project-workspace-cleaner について

ワークスペース配下のリポジトリを読み取り専用でスキャンし、深刻度順に整理項目を提示するスキルです。リポジトリ別の合計やスキップしたパスも報告し、ファイルを変更せずに推奨事項を示します。

主な機能

  1. 01ワークスペース内リポジトリの読み取り専用スキャン
  2. 02閾値や表示件数の設定
  3. 03深刻度順の整理候補
  4. 04リポジトリ集計とスキップパスの報告
  5. 05ファイルを変更しない推奨事項

活用シーン

  1. 01生成物や古いリポジトリ成果物の確認
  2. 02複数リポジトリの整理優先度付け
  3. 03手動確認が必要な大きなディレクトリの特定
  4. 04部分結果を含むスキャンの監査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-workspace-cleaner

インストール後、Claude Code で/project-workspace-cleanerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
config/
customization.template.yaml
references/
automation-prompts.md
config-schema.md
customization.md
patterns.md
scripts/
scan_workspace_cleanup.py
tests/
test_scan_workspace_cleanup.py

詳細

プロジェクトワークスペースのクリーンアップ

ワークスペースのルートにあるリポジトリを読み取り専用でスキャンし、クリーンアップ作業を重大度順にランク付けします。

入力

  • 任意の CLI オーバーライド：
    • --workspace
    • --min-mb
    • --stale-days
    • --max-findings
    • --config
    • --json
  • 設定の優先順位：
    1. CLI フラグ
    2. config/customization.yaml
    3. config/customization.template.yaml
    4. スクリプトのデフォルト値

ワークフロー

  1. 文書化された優先順位に従って設定を解決します。
  2. scripts/scan_workspace_cleanup.py を実行します。
  3. トラバーサルまたは stat 操作に失敗した場合は、スキップしたパスを記録し、アクセス可能な残りのパスのスキャンを続けます。
  4. 検出結果を重大度、スコア、サイズ、リポジトリ、ディレクトリの順にランク付けします。
  5. ランク付けした検出結果と、リポジトリ単位の合計を返します。
  6. 検出結果もスキップしたパスもない場合は、ユーザー向けにクリーンな結果を報告します。

出力仕様

各検出結果には以下が含まれます：

  • severity

  • repo

  • directory

  • category

  • size_human

  • score

  • why_flagged

  • suggested_cleanup

  • リポジトリのサマリーには、フラグが付いたサイズの合計と重大度ごとの検出数が含まれます。

  • JSON 出力には partial_results と skipped_paths が含まれます。

  • ユーザー向けのクリーンな実行結果は、正確に No findings. と出力します。

  • いずれかのパスがスキップされた場合は、クリーンな実行結果のメッセージではなく、部分的な結果であることを示す警告を返し、スキップしたパスを列挙します。

ガードレール

  • 破壊的なコマンドは実行しないでください。
  • 成果物を自動的に削除しないでください。
  • スキャン対象のリポジトリに書き込まないでください。
  • 推奨事項のみを提示してください。

参照資料

  • references/config-schema.md
  • references/customization.md
  • references/automation-prompts.md
  • references/patterns.md

コメント

Markdown 対応