Навыки planning-with-files

📦

planning-with-files

Name: planning-with-files
Author: sickn33

Безопасно ⚙️ Внешние команды

Планирование сложных задач с использованием постоянных файлов

Также доступно от: OthmanAdi,ZhanlinCui,AmmarCodes

Длительные сессии ИИ приводят к потере контекста и забытым целям. Этот навык использует markdown-файлы как внешнюю память для поддержания состояния задачи через неограниченное количество вызовов инструментов.

Поддерживает: Claude Codex Code(CC)

🥈 77 Серебро

Скачать ZIP навыка

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

Включите и начните использовать

Протестировать

Использование «planning-with-files». Инициализировать планирование для Python CLI todo-приложения с командами add, list и delete

Ожидаемый результат:

Создан task_plan.md с 5 фазами: Requirements, Planning, Implementation, Testing, Delivery
Создан findings.md с разделами для требований, исследований и технических решений
Создан progress.md с временной меткой сессии и начальным статусом

Использование «planning-with-files». Записать ошибку: FileNotFoundError при чтении config.json

Ожидаемый результат:

Добавлено в таблицу Errors Encountered: FileNotFoundError, Attempt 1, Resolution: Create default config file
Обновлён лог ошибок в progress.md с временной меткой
Статус фазы остаётся in_progress до устранения ошибки

Аудит безопасности

Безопасно

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.

Просканировано файлов

1,146

Проанализировано строк

находки

Всего аудитов

Факторы риска

⚙️ Внешние команды (2)

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

Проверено: claude

Оценка качества

Архитектура

100

Сопровождаемость

Контент

Сообщество

100

Безопасность

Соответствие спецификации

Что вы можете построить

Многоэтапные проекты разработки

Отслеживание сложных задач кодирования через 50+ вызовов инструментов с отслеживанием фаз, логированием ошибок и документированием решений.

Исследования и документация

Фиксация результатов веб-поиска, данных браузера и исходных материалов в структурированном markdown до потери контекста.

Исследование системы и отладка

Документирование находок, неудачных попыток и решений при работе с незнакомыми кодовыми базами или отладке проблем.

Попробуйте эти промпты

Инициализация сессии планирования

Создайте файлы task_plan.md, findings.md и progress.md в моей директории проекта. Цель: [опишите цель вашей задачи]. Начните с Phase 1 для сбора требований.

Отслеживание прогресса исправления багов

Прочитайте task_plan.md и обновите статус текущей фазы. Запишите возникшую ошибку: [вставьте ошибку]. Задокументируйте корневую причину и предпринятые попытки исправления в таблице Errors Encountered.

Фиксация исследовательских находок

Я только что完成了 два веб-поиска по теме [topic]. Обновите findings.md ключевыми открытиями, релевантными URL и любыми техническими решениями, принятыми на основе этого исследования.

Завершение фазы и ревью

Отметьте Phase [X] как завершённую в task_plan.md. Опишите, что было выполнено, какие файлы созданы или изменены, и обновите progress.md результатами тестов. Затем установите Phase [X+1] в статус in_progress.

Лучшие практики

Создавайте все три файла планирования перед началом любой сложной задачи с 3+ шагами
Читайте task_plan.md перед принятием важных решений для удержания целей в фокусе внимания
Обновляйте findings.md немедленно после каждых 2 операций view или browser
Фиксируйте каждую возникшую ошибку, даже если она быстро устранена, для предотвращения повторения
Явно отмечайте изменения статуса фазы: pending → in_progress → complete

Избегать

Начало выполнения без предварительного создания файла task_plan.md
Молчаливое повторение неудачных действий без логирования ошибки
Повторение одного и того же неудачного действия вместо изменения подхода
Создание файлов планирования в директории навыка вместо директории проекта
Использование TodoWrite для персистентности вместо хранения на основе файлов

Часто задаваемые вопросы

Где следует создавать файлы планирования?

Создавайте task_plan.md, findings.md и progress.md в вашей рабочей директории проекта, а не в папке установки навыка. Это держит файлы планирования рядом с вашим кодом.

Когда следует обновлять файлы планирования?

Обновляйте task_plan.md после завершения каждой фазы. Обновляйте findings.md после каждых 2 операций view или browser. Обновляйте progress.md в течение сессии по мере выполнения действий.

Что такое правило 2 действий?

После каждых 2 операций view, browser или search немедленно записывайте ключевые находки в findings.md. Это предотвращает потерю визуальной или мультимодальной информации при сбросе контекста.

Как обрабатывать ошибки с этим навыком?

Логируйте каждую ошибку в таблице Errors Encountered с номером попытки и решением. Никогда не повторяйте одно и то же неудачное действие. После 3 неудачных попыток эскалируйте пользователю с описанием предпринятых действий.

Можно ли использовать это для простых задач?

Для простых вопросов, правки单个 файла или быстрых поисков пропускайте файлы планирования. Используйте этот паттерн для задач с 3+ шагами, исследовательских проектов или anything requiring organization across many tool calls.

Для чего нужны shell-скрипты?

init-session.sh создаёт все три файла планирования с шаблонным содержимым. check-complete.sh проверяет, что все фазы в task_plan.md отмечены как complete. Оба являются опциональными помощниками для автоматизации.