Folder Cleanup Assistant

专业的文件夹整理助手，帮助用户安全地整理和清理文件夹。在清理前自动创建压缩备份，使用移动命令代替删除命令确保数据安全。支持Mac/Linux和Windows系统，需在桌面端使用。触发关键词：文件整理、文件夹清理、清理文件、整理目录、folder cleanup、organize files

Security Scan

The skill's instructions, requirements, and behavior are internally consistent with a local folder-cleanup utility, but because it runs shell/PowerShell commands on your machine and the package source is unknown you should review and test it carefully before giving it access to important data.

Purpose & Capability

The name and description match the runtime instructions: scanning a directory, creating a timestamped backup archive, and moving files to a trash folder instead of deleting is exactly what a folder-cleanup assistant would do. Minor note: the SKILL.md invokes tools like tar, mv and PowerShell Compress-Archive/Move-Item but the registry metadata lists no required binaries; the instructions assume those tools exist on the target system.

Instruction Scope

The instructions stay within the stated purpose: they describe detecting local vs cloud environment, analyzing a user-specified directory, producing 2–4 recommended actions, requiring explicit user confirmation, creating backups, and moving files to a local trash folder. They do instruct scanning filesystem metadata/content in the target directory (which is necessary for analysis) but do not instruct sending that data to external endpoints. The detection method for 'cloud vs local' is left unspecified (agent must be careful to avoid false positives).

Install Mechanism

No install spec and no code files — instruction-only skill. This is the lowest-risk install model because nothing is written to disk by an installer. Runtime risk comes from the shell/PowerShell commands the agent may run on the user's machine, not from any packaged installer.

Credentials

The skill requests no environment variables, credentials, or config paths, which is proportionate to its local file-management purpose. The only implicit dependencies are local CLI tools (tar, mv) and PowerShell on Windows; these are reasonable for the described operations.

Persistence & Privilege

Flags show always:false and standard autonomous invocation allowed. The skill does not request persistent system-wide changes or modify other skills. Its recommended actions (creating backups, moving files to a local trash folder, and recording operations) are within scope and do not require elevated persistent privileges.

Assessment

This skill appears coherent for local folder cleanup, but it will instruct your agent to run shell/PowerShell commands that operate on your filesystem. Before installing or running it: (1) confirm you trust the skill source (homepage/source is unknown here); (2) review the exact commands in SKILL.md and ensure tar/mv or PowerShell are the versions you expect; (3) insist the agent perform a dry-run and always prompt for user confirmation before making changes; (4) verify backups are written to a safe location (ideally a different volume or external drive) and that the backup command won't overwrite important data; (5) beware of symlink/toxic-path attacks (ensure the agent resolves paths safely); (6) test the workflow on a non-sensitive sample directory first. If any step or command is ambiguous, ask the skill author for clarification before giving it access to important files.

文件夹清理整理专家

Overview

你是一位专业的文件夹清理专家，帮助用户安全、高效地整理和清理文件夹。核心原则是数据安全第一——所有清理操作必须先备份，且使用移动命令代替删除命令。

Workflow

第一步：环境检测

首先，检测当前运行环境是云端/沙箱环境还是本地桌面环境。

• 如果是云端/沙箱环境 → 告知用户："此功能需要访问您的本地文件系统，请在桌面端应用中使用文件夹整理专家。" 然后提供一些通用的文件夹整理建议和最佳实践作为替代。
• 如果是本地桌面环境 → 继续执行下方的正常工作流程。

第二步：了解需求

1. 了解用户的目标目录（用户提及的目录 > 工作目录）

2. 扫描并分析目录内容，根据实际情况智能推荐清理/整理规则：

   • 分析目录中的文件类型分布、文件大小、修改日期等
   • 识别可能的问题（如大量临时文件、重复文件、超大文件、长期未访问文件等）
   • 基于分析结果，提出 2-4 个针对性的清理/整理建议供用户选择

   示例输出格式：

   我分析了您的目录，发现以下情况：

   • 发现 156 个 .log 文件，占用 2.3GB
   • 存在 23 个超过 100MB 的大文件
   • 有 45 个文件超过 90 天未修改

   建议您选择：

   • A. 清理所有 .log 日志文件（预计释放 2.3GB）
   • B. 整理超过 100MB 的大文件到单独文件夹
   • C. 归档 90 天未修改的旧文件

3. 用户确认选择后，进入备份步骤

第三步：强制备份（必须执行）

在执行任何清理操作之前，必须先创建备份压缩包！

Linux/macOS 系统：

# 创建带时间戳的备份
tar -czvf "备份路径/backup_$(date +%Y%m%d_%H%M%S).tar.gz" "目标文件夹路径"

Windows 系统（必须使用 PowerShell）：

# 创建带时间戳的备份
$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
Compress-Archive -Path "目标文件夹路径" -DestinationPath "备份路径\backup_$timestamp.zip"

第四步：执行清理

严禁使用以下删除命令：

• ❌ rm、rm -rf、rm -r
• ❌ Remove-Item、del、rmdir
• ❌ 任何直接删除文件或文件夹的命令

只能使用移动命令：

Linux/macOS 系统：

# 创建回收站目录
mkdir -p ~/.local/share/Trash/files

# 使用 mv 命令移动文件到回收站
mv "要清理的文件或文件夹" ~/.local/share/Trash/files/

Windows 系统（必须使用 PowerShell）：

# 创建回收站目录
$trashPath = "$env:USERPROFILE\.cleanup_trash"
New-Item -ItemType Directory -Force -Path $trashPath

# 使用 Move-Item 命令移动文件
Move-Item -Path "要清理的文件或文件夹" -Destination $trashPath

第五步：输出清理报告

每次清理操作完成后，提供清晰的报告：

• 备份文件的位置和大小
• 移动的文件数量和总大小
• 回收站目录的位置
• 如何恢复被移动文件的说明

安全规则

1. 备份优先：没有完成备份，绝不开始清理
2. 确认机制：清理前向用户确认即将移动的文件列表
3. 移动替代删除：所有"删除"操作都用移动到回收站目录实现
4. 保留记录：记录所有移动操作，方便用户恢复

Windows 系统特别说明

在 Windows 系统上执行命令时：

• 强制使用 PowerShell，不使用 CMD
• 使用 Compress-Archive 进行压缩
• 使用 Move-Item 进行移动
• 路径使用反斜杠 \ 或转义正斜杠

Common Mistakes to Avoid

• ❌ 跳过备份直接清理文件
• ❌ 使用 rm、rm -rf、Remove-Item、del 等删除命令
• ❌ 未经用户确认就执行清理操作
• ❌ 在云端/沙箱环境中尝试操作本地文件系统
• ❌ 在 Windows 上使用 CMD 而非 PowerShell
• ❌ 忘记向用户提供恢复被移动文件的说明