convez.ai
SkillAutomaçãoIntermediário
wmz46

Agent Skill Soft Delete

wmz46/agent-skill-soft-delete

Exclusão reversível de arquivos com lixeira gerenciada e restauração inteligente

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que implementa exclusão segura de arquivos movendo-os para uma lixeira antes de deletá-los permanentemente. Evita confirmações do sistema, suporta restauração por ID ou caminho original, com proteção automática contra conflitos de nomes. Ideal para assistentes de código (Claude, Cursor) que precisam gerenciar arquivos com segurança.

Instalação

$npx convez-ai wmz46/agent-skill-soft-delete

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
28%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Limpeza segura de arquivos em fluxos de automação de código
  • Recuperação de arquivos deletados acidentalmente durante desenvolvimento
  • Gestão centralizada de lixeira entre múltiplos projetos e workspaces
  • Integração com assistentes de IA para operações de arquivo com segurança

Veredito

Skill bem construída que resolve um problema real em fluxos de automação com IA: deletar arquivos de forma segura e reversível. Implementação sólida com lixeira persistente, expiração automática e output estruturado em JSON para parsing por agentes.

README

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

agent-skill-soft-delete

AI Agent 文件伪删除 Skill。将文件移动到回收站而非彻底删除,避免系统确认框,支持还原。

安装

# 克隆到你的 AI Agent 的 skills 目录下(--depth 1 只拉最新代码,随后删除嵌套的 .git/ 避免干扰父仓库)
cd <your-workspace>/.agents/skills/
git clone --depth 1 https://github.com/wmz46/agent-skill-soft-delete.git soft-delete
rm -rf soft-delete/.git

或者手动复制:

your-workspace/
└── .agents/skills/
    └── soft-delete/
        ├── SKILL.md
        └── scripts/
            └── trash.js

使用

# 伪删除(移到回收站)
node scripts/trash.js delete <file1> [file2] ...

# 永久删除(不可还原)
node scripts/trash.js delete --hard <file1> [file2] ...

# 还原(按 ID)
node scripts/trash.js restore <id>

# 还原(按原始路径,仅还原最新删除的那份)
node scripts/trash.js restore --by-path <original_path>

# 查看回收站(默认 JSON 格式)
node scripts/trash.js list

# 查看回收站(可读文本格式)
node scripts/trash.js list --pretty

# 查看指定日期的回收站
node scripts/trash.js list --date YYYY-MM-DD

工作原理

  • 回收站:~/.agent-trash/(用户主目录下,跨项目共享)
  • 按日期自动分组:~/.agent-trash/YYYY-MM-DD/
  • 同名文件自动加时间戳后缀防冲突:file_HHmmss.ext
  • 每次操作输出 JSON 报告,AI 可直接解析
  • 还原时若目标路径已被占用,自动先伪删除现有文件再还原
  • 自动过期清理:超过 7 天的回收站条目会在每次操作时自动清理,无需手动维护

License

MIT

Ver o original no GitHub

Bom para

Relacionados