SKILLEMALL.ai
GitHub ↗ EN Войти

CC pi-planning-with-files

Постоянное файловое планирование для многоэтапной работы ИИ-агента. Сохраняет task_plan.md, findings.md и progress.md на диске; хуки жизненного цикла вставляют выбранный контекст планирования проекта. Автоматическое восстановление читает только файлы планирования проекта. Явный запуск session-catchup.py --metadata читает локальные записи сеанса агента того же проекта и выдает только агрегированные счетчики; --replay может выдавать ограниченные фрагменты, обрамленные nonce. Опциональный режим с ограничениями может запрашивать продолжение только тогда, когда хост его поддерживает, и никогда не выполняет команды, объявленные в Markdown. Умение не имеет пути для загрузки по сети. Используйте для исследований или работы, требующей 5+ вызовов инструментов.

машинный переводПоказать оригиналСкрыть оригинал«Persistent file-based planning for multi-step AI-agent work. Keeps tas…»

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

OthmanAdi/planning-with-files Agent Skills автор: OthmanAdi MIT 45 файлов · 31 скрипт тело ≈ 8 763 токенов Открыть источникgithub.com↗ проанализирован 2 дн назад

Постоянное файловое планирование для многоэтапной работы ИИ-агента.

Как процесс C 54/100 · Есть пробелы — слабые места: результат и критерий готовности, когда включается, входы и предусловия

ПроцедураИИ и агентытип и темы размечены автоматически по тексту скилла
Запускается в: Claude / Claude Code ChatGPT / Codex Gemini CLI Cursor GitHub Copilot / VS Code Qwen Code Kimi Code CLI Z.ai (GLM) DeepSeek (Deep Code) Mistral Vibe LangChain (deepagents) OpenClaw Goose OpenCode
JSON
Технический рейтинг
C
82/100
безопасность, качество, тесты
Безопасность 60%
89
Качество 40%
71
Прогон на моделях
не было
Процессный рейтинг
C
54/100
Есть пробелы
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
Когда включается вес 12
20
три самых слабых из десяти параметров · все десять

Чем это грозит

Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.

Широкие права средняя серьёзность

Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.

Если установить

Скилл просит больше прав, чем нужно для задачи: широкий доступ к инструментам, секретные переменные окружения, бинарные файлы. Каждое лишнее право расширяет ущерб при ошибке или взломе.

Автору

Сузьте allowed-tools и список переменных до минимума, замените бинарники на исходники или скрипты, которые можно прочитать.

Как улучшить

  1. Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
Для прогона на моделях — необязательно
  • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
  • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

Находки guard · 7

✓ Критических и высоких находок нет

Средние и низкие: 7
  • средняя Широкие права meta-broad-allowed-tools SKILL.md:1
    Заранее разрешены широкие инструменты: Bash
    allowed-tools: Read Write Edit Bash Glob Grep
  • низкая Секреты в коде secret-high-entropy-token extensions/planning-with-files/package-lock.json:59
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    "integrity": "sha5…wUj/ZC+1Q4i…Tsk+cLPP…C6W/iw==",
    детектор
  • низкая Секреты в коде secret-high-entropy-token extensions/planning-with-files/package-lock.json:126
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    "integrity": "sha5…wIN//F77/IADDSs58i+MDaO…jeo+YFg==",
    детектор
  • низкая Секреты в коде secret-high-entropy-token extensions/planning-with-files/package-lock.json:230
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    "integrity": "sha5…O6y+kV+llvou+Adts…zQN+KX3y…1LJ//xL2iSf76w==",
    детектор
  • низкая Секреты в коде secret-high-entropy-token extensions/planning-with-files/package-lock.json:366
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    "integrity": "sha5…mvP+nHFA+5sxP…yVP/L5c3…3Qg==",
    детектор
  • низкая Секреты в коде secret-high-entropy-token extensions/planning-with-files/package-lock.json:401
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    "integrity": "sha5…1H6+7CGr…UGQ==",
    детектор
  • низкая Опасные команды cmd-privilege extensions/planning-with-files/runtime.ts:344
    Повышение привилегий / права на запись для всех (комментарий в коде)
    /\bchmod\s+(0?777|a\+rwx)\b/i,        // chmod 777, chmod a+rwx (world-writable)
    комментарий

Просканировано файлов: 45. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

По спецификации Agent Skills

  • предупреждение body-long тело SKILL.md ≈ 8763 токенов (рекомендуется < 5000); вынесите детали в references/
  • заметка edit-residue в тексте есть пометки об устаревшем (строки 11, 44, 193, 195, 298, 333): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия

Процессный рейтинг: все десять параметров 54/100

  • 0Результат и критерий готовности. Не сказано, что считать результатом
  • 0Входы и предусловия. Не сказано, что нужно иметь на входе
  • 20Когда включается. Не сказано, при каком запросе скилл включается
  • 30Повторный запуск. Изменяющих операций: 20, без проверки текущего состояния
  • 40Согласованность. Имя во frontmatter (pi-planning-with-files) не совпадает с папкой (planning-with-files)
  • 40Стоимость исполнения. Тело инструкции 8763 токенов: вытесняет саму задачу из окна
  • 100Инструменты и файлы. Инструменты объявлены во frontmatter
  • 100Шаги. Шагов: 68
  • 100Ошибки и развилки. Развилок: 3, есть раздел про ошибки
  • 100Отчётность по ходу. Скилл сообщает о ходе работы
  • medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
  • low Разделов верхнего уровня: 17. Похоже на несколько доменов в одном скилле
  • low Ответ описан самодельной разметкой (8 тегов): типизированный вызов надёжнее

Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.

Сигналы качества

  • +5В description нет примеров фраз, по которым скилл должен срабатывать
  • +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
  • +3Формат ответа не описан: модель каждый раз решает сама
  • -311 из 23 скриптов не упомянуты в SKILL.md
  • +1Лицензия не указана
  • +2Инструкции на одном языке
  • +3Длина description 606 символов: достаточно сигнала, не съедает бюджет
  • +4Структура: 46 заголовков
  • +3Пошаговые инструкции: 68 пунктов
  • +4Есть примеры (12 блоков кода)

База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 71.