Habilidades planning-with-files

📦

planning-with-files

Name: planning-with-files
Author: sickn33

Seguro ⚙️ Comandos externos

Planificar Tareas Complejas con Archivos Persistentes

También disponible en: OthmanAdi,ZhanlinCui,AmmarCodes

Las sesiones largas de IA causan pérdida de contexto y objetivos olvidados. Esta habilidad utiliza archivos markdown como memoria externa para mantener el estado de la tarea a través de llamadas de herramientas ilimitadas.

Soporta: Claude Codex Code(CC)

🥈 77 Plata

Descargar el ZIP de la skill

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

Activa y empieza a usar

Pruébalo

Usando "planning-with-files". Initialize planning for a Python CLI todo app with add, list, and delete commands

Resultado esperado:

Created task_plan.md with 5 phases: Requirements, Planning, Implementation, Testing, Delivery
Created findings.md with sections for requirements, research, and technical decisions
Created progress.md with session timestamp and initial status

Usando "planning-with-files". Log error: FileNotFoundError when reading config.json

Resultado esperado:

Added to Errors Encountered table: FileNotFoundError, Attempt 1, Resolution: Create default config file
Updated progress.md error log with timestamp
Phase status remains in_progress until error resolved

Auditoría de seguridad

Seguro

v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

Archivos escaneados

1,146

Líneas analizadas

hallazgos

Auditorías totales

Factores de riesgo

⚙️ Comandos externos (2)

scripts/check-complete.sh:1-45 scripts/init-session.sh:1-121

Auditado por: claude

Puntuación de calidad

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

100

Seguridad

Cumplimiento de la especificación

Lo que puedes crear

Proyectos de Desarrollo Multifase

Rastrear tareas de codificación complejas a través de 50+ llamadas de herramientas con seguimiento de fases, registro de errores y documentación de decisiones.

Investigación y Documentación

Capturar hallazgos de búsquedas web, resultados del navegador y materiales de origen en markdown estructurado antes de que se pierda el contexto.

Exploración de Sistemas y Depuración

Documentar descubrimientos, intentos fallidos y resoluciones al explorar bases de código desconocidas o depurar problemas.

Prueba estos prompts

Inicializar Sesión de Planificación

Create task_plan.md, findings.md, and progress.md files in my project directory. The goal is: [describe your task goal]. Start with Phase 1 for requirements gathering.

Rastrear Progreso de Corrección de Error

Read task_plan.md and update the current phase status. Log the error encountered: [paste error]. Document the root cause and attempted fixes in the Errors Encountered table.

Capturar Hallazgos de Investigación

I just completed two web searches on [topic]. Update findings.md with the key discoveries, relevant URLs, and any technical decisions made based on this research.

Completar y Revisar Fase

Mark Phase [X] as complete in task_plan.md. Summarize what was accomplished, files created or modified, and update progress.md with test results. Then set Phase [X+1] to in_progress.

Mejores prácticas

Crear los tres archivos de planificación antes de iniciar cualquier tarea compleja con 3+ pasos
Leer task_plan.md antes de tomar decisiones importantes para mantener los objetivos en atención
Actualizar findings.md inmediatamente después de cada 2 operaciones de vista o navegador
Registrar cada error encontrado, incluso si se resuelve rápidamente, para evitar repeticiones
Marcar cambios de estado de fase explícitamente: pending a in_progress a complete

Evitar

Iniciar ejecución sin crear un archivo task_plan.md primero
Reintentar silenciosamente acciones fallidas sin registrar el error
Repetir la misma acción fallida en lugar de mutar el enfoque
Crear archivos de planificación en el directorio de la habilidad en lugar del directorio del proyecto
Usar TodoWrite para persistencia en lugar de almacenamiento basado en archivos

Preguntas frecuentes

¿Dónde debo crear los archivos de planificación?

Crea task_plan.md, findings.md y progress.md en tu directorio de proyecto donde estás trabajando, no en la carpeta de instalación de la habilidad. Esto mantiene los archivos de planificación junto a tu código.

¿Cuándo debo actualizar los archivos de planificación?

Actualiza task_plan.md después de cada fase completada. Actualiza findings.md después de cada 2 operaciones de vista o navegador. Actualiza progress.md a lo largo de la sesión a medida que se completan las acciones.

¿Qué es la Regla de 2 Acciones?

Después de cada 2 operaciones de vista, navegador o búsqueda, escribe inmediatamente los hallazgos clave en findings.md. Esto previene que información visual o multimodal se pierda cuando el contexto se reinicia.

¿Cómo manejo los errores con esta habilidad?

Registra cada error en la tabla Errors Encountered con el número de intento y resolución. Nunca repitas la misma acción fallida. Después de 3 intentos fallidos, escala al usuario con lo que intentaste.

¿Puedo usar esto para tareas simples?

Para preguntas simples, ediciones de un solo archivo o búsquedas rápidas, omite los archivos de planificación. Usa este patrón para tareas con 3+ pasos, proyectos de investigación o cualquier cosa que requiera organización a través de muchas llamadas de herramientas.

¿Para qué sirven los scripts de shell?

init-session.sh crea los tres archivos de planificación con contenido de plantilla. check-complete.sh verifica que todas las fases en task_plan.md estén marcadas como completadas. Ambos son ayudantes opcionales para automatización.