convez.ai
Skill
13083940714lx-lgtm

windows-file-organizer

13083940714lx-lgtm/windows-file-organizer

Ver no GitHub
InicialPluginScore · de 0 a 100

Windows filesystem cleanup skill for Claude Code - diagnose plan execute repair.

Instalação

$npx convez-ai 13083940714lx-lgtm/windows-file-organizer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Windows File Organizer 🗂️

A systematic Windows filesystem cleanup skill for Claude Code — diagnose, plan, execute, and repair in four phases.

License: MIT Platform: Windows Claude Code Skill


English | 中文


English

What is this?

Windows File Organizer is a Claude Code skill that helps you systematically clean up and organize your Windows filesystem. It follows a disciplined four-phase workflow: Diagnose → Plan → Execute → Repair, ensuring every file move is safe, reversible, and user-approved.

Features

PhaseDescription
🔍 DiagnoseScan disk usage, find large files, detect broken shortcuts, check registry, identify locked files — without touching anything
📋 PlanGenerate a full action plan with risk labels (🟢 low / 🟡 medium / 🔴 high), source→target paths, and rollback steps
⚡ ExecuteProceed from low-risk to high-risk: clean temp files, migrate user folders via registry, reorganize software & data, remove redundancies
🔧 RepairFix broken shortcuts (.lnk), rebuild icon cache, verify all links, update desktop category folders

Key Principles

  • Diagnose first, never delete blind
  • Plan before execute, always get user approval
  • Low risk first, high risk last
  • Never move installed software paths — move shortcuts instead
  • Consolidate data into categorized directories (e.g., E:\Software\{category}\, E:\Data\{category}\)
  • Safe Mode for TrustedInstaller-locked files

Proactive Monitoring

The skill includes a startup scanner (scripts/startup-scan.ps1) that runs at every Claude Code session start. It checks:

  • Desktop for loose files (non-shortcuts)
  • Downloads folder for stale files (>1 day)
  • C:\ root for large leftover files
  • Documents folder (should be empty after migration)

If issues are found, Claude will proactively ask: "要我帮你整理吗?" (Want me to clean up?)

File Structure

windows-file-organizer/
├── SKILL.md              # Main skill definition (Claude Code format)
├── REFERENCE.md          # Command patterns, scripts, and examples
├── scripts/
│   └── startup-scan.ps1  # PowerShell startup scanner
└── README.md             # This file

Installation

  1. Copy this folder to your Claude Code skills directory:

    %USERPROFILE%\.claude\skills\windows-file-organizer\
    
  2. Restart Claude Code or reload skills — the skill auto-activates on trigger phrases.

Trigger Phrases

Say any of these in Claude Code to activate:

  • "帮我整理一下电脑文件"
  • "整理C盘"
  • "清理桌面"
  • "检查一下C盘"
  • "把文件移到E盘"
  • Any request involving Windows file organization

Requirements

  • OS: Windows 10/11
  • Shell: Git Bash (for df, du, find commands)
  • PowerShell: 5.1+ (for registry, shortcuts, process management)
  • Claude Code: Latest version

License

MIT © 2025


中文

这是什么?

Windows File Organizer(Windows 文件整理器) 是一个 Claude Code 技能,帮助你系统性地清理和整理 Windows 文件系统。它遵循严格的四阶段工作流:诊断 → 规划 → 执行 → 修复,确保每次文件操作都是安全、可逆且经过用户确认的。

功能特性

阶段描述
🔍 诊断扫描磁盘使用情况、查找大文件、检测失效快捷方式、查询注册表、识别被锁定的文件 —— 不动任何文件
📋 规划生成完整行动计划,标注风险等级(🟢 低 / 🟡 中 / 🔴 高),包含源路径→目标路径、回滚步骤
⚡ 执行从低风险到高风险依次执行:清理临时文件、通过注册表迁移用户文件夹、重组软件与数据、删除冗余
🔧 修复修复失效快捷方式(.lnk)、重建图标缓存、验证所有链接、更新桌面分类文件夹名称

核心原则

  • 先诊断,不盲目删除
  • 先规划再执行,必须获得用户确认
  • 低风险优先,高风险靠后
  • 绝不移动已安装软件的路径 —— 改成移动快捷方式
  • 将数据归入分类目录(如 E:\Software\{类别}\、E:\Data\{类别}\)
  • 对于 TrustedInstaller 锁定的文件,使用安全模式处理

主动监控

技能内置了启动扫描器(scripts/startup-scan.ps1),在每次 Claude Code 会话启动时自动运行,检查:

  • 桌面是否有散落文件(非快捷方式)
  • Downloads 文件夹是否有超过 1 天的旧文件
  • C:\ 根目录是否有残留大文件
  • Documents 文件夹是否已清空(迁移后应为空)

发现问题时,Claude 会主动询问:"要我帮你整理吗?"

文件结构

windows-file-organizer/
├── SKILL.md              # 技能主定义文件(Claude Code 格式)
├── REFERENCE.md          # 命令模式、脚本与示例参考
├── scripts/
│   └── startup-scan.ps1  # PowerShell 启动扫描脚本
└── README.md             # 本文件

安装方法

  1. 将此文件夹复制到 Claude Code 技能目录:

    %USERPROFILE%\.claude\skills\windows-file-organizer\
    
  2. 重启 Claude Code 或重新加载技能 —— 技能会在触发语句出现时自动激活。

触发语句

在 Claude Code 中说以下任意一句即可激活:

  • "帮我整理一下电脑文件"
  • "整理C盘"
  • "清理桌面"
  • "检查一下C盘"
  • "把文件移到E盘"
  • 任何涉及 Windows 文件整理的需求

环境要求

  • 操作系统: Windows 10/11
  • Shell: Git Bash(用于 df、du、find 命令)
  • PowerShell: 5.1+(用于注册表、快捷方式、进程管理)
  • Claude Code: 最新版本

开源协议

MIT © 2025

Ver o original no GitHub

Bom para

Relacionados