Habilidades maintenance
🧹

maintenance

Baixo Risco ⚡ Contém scripts📁 Acesso ao sistema de arquivos⚙️ Comandos externos

Limpar e organizar a documentação do projeto

Arquivos de documentação do projeto como Plans.md e session-log.md crescem bastante ao longo do tempo, tornando-os difíceis de gerenciar. Esta skill arquiva automaticamente tarefas concluídas, divide logs grandes por mês e mantém a documentação do seu projeto organizada e legível.

Suporta: Code(CC)
📊 69 Adequado
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "maintenance". Clean up my project files

Resultado esperado:

  • Files checked: Plans.md (250 lines), session-log.md (120 lines), CLAUDE.md (45 lines)
  • Issues found: Plans.md exceeds 200 line threshold
  • 8 completed tasks are older than 7 days and can be archived
  • Recommendation: Archive 8 tasks to keep Plans.md manageable

A utilizar "maintenance". Run cleanup in dry-run mode

Resultado esperado:

  • Dry run results: Would archive 5 tasks from Plans.md
  • Would split session-log.md into 2 monthly files
  • No changes would be made. Run without --dry-run to execute.

Auditoria de Segurança

Baixo Risco
v5 • 1/16/2026

All 60 static findings are FALSE POSITIVES. The flagged code exists in documentation files (auto-cleanup/doc.md), not executable code. Bash command examples use hardcoded strings with no user input. The YAML frontmatter '---' was misidentified as weak cryptography. This is a benign file cleanup utility for managing Plans.md, session-log.md, and CLAUDE.md.

3
Arquivos analisados
592
Linhas analisadas
3
achados
5
Total de auditorias

Fatores de risco

⚡ Contém scripts (5)
auto-cleanup/doc.md:107-117 auto-cleanup/doc.md:123-155 auto-cleanup/doc.md:161-172 auto-cleanup/doc.md:177-195 auto-cleanup/doc.md:200-214
📁 Acesso ao sistema de arquivos (1)
auto-cleanup/doc.md:34-39
⚙️ Comandos externos (2)
auto-cleanup/doc.md:107-117 auto-cleanup/doc.md:123-155
Auditado por: claude Ver Histórico de Auditoria →

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
85
Conteúdo
31
Comunidade
90
Segurança
91
Conformidade com especificações

O Que Você Pode Construir

Manter os planos do projeto organizados

Move automaticamente tarefas concluídas para uma seção de arquivo após 7 dias, mantendo o Plans.md focado no trabalho ativo.

Gerenciar histórico de sessões

Divide logs de sessão crescentes em arquivos mensais arquivados, mantendo as sessões atuais rápidas e pesquisáveis.

Otimizar tamanho do CLAUDE.md

Receba avisos quando CLAUDE.md ficar muito grande e obtenha orientação sobre como dividir em arquivos específicos por tópico.

Tente Estes Prompts

Limpeza rápida 
Clean up my project files. Archive completed tasks from Plans.md and organize session logs.
Visualizar alterações 
Show me what cleanup actions would be performed. Run cleanup in dry-run mode.
Limpeza seletiva 
Clean up Plans.md only. Archive old completed tasks but leave session logs alone.
Verificação automatizada 
Check my project files. Are there any that need cleanup based on the size thresholds?

Melhores Práticas

  • Execute a limpeza regularmente, como no final de cada sprint ou semanalmente
  • Revise as tarefas arquivadas mensalmente para garantir que nada importante foi movido acidentalmente
  • Configure os limites no .claude-code-harness.config.yaml para corresponder às necessidades do seu projeto

Evitar

  • Usar limpeza em arquivos que estão sendo editados ativamente por vários membros da equipe simultaneamente
  • Arquivar tarefas que ainda precisam de referência sem manter uma cópia de backup
  • Ignorar avisos de tamanho do CLAUDE.md, o que pode deixar o carregamento de contexto do Claude Code mais lento

Perguntas Frequentes

Quais arquivos esta skill gerencia?
Ela gerencia os arquivos Plans.md, session-log.md e CLAUDE.md. Outros tipos de arquivo não são afetados.
Ela vai deletar minhas tarefas?
Não. As tarefas concluídas são movidas para uma seção de arquivo dentro do Plans.md ou divididas em arquivos mensais. Os dados originais são preservados.
Posso personalizar os limites de tamanho?
Sim. Edite o .claude-code-harness.config.yaml para definir valores personalizados para max_lines e archive_after_days.
Meus dados estão seguros durante a limpeza?
Sim. A skill cria backups automáticos antes de fazer alterações. Você também pode usar o modo dry-run para visualizar primeiro.
O que acontece com tarefas em andamento?
Tarefas WIP marcadas com cc:WIP ou pm:依頼中 são protegidas e não serão arquivadas, mesmo se concluídas.
Como isso é diferente de outras ferramentas de limpeza?
Esta skill usa avaliação LLM para fazer recomendações inteligentes baseadas na idade da tarefa e status de conclusão, não apenas no tamanho do arquivo.

Detalhes do Desenvolvedor

Licença

MIT

Repositório

https://github.com/Chachamaru127/claude-code-harness/tree/main/skills/maintenance

Referência

main

Estrutura de arquivos

📁 auto-cleanup/

📄 doc.md

📄 SKILL.md